So suchen Sie in der Nähe basierend auf der Geschäftskette - Amazon Location Service
Mögliche AnwendungsfälleBeispieleTipps für Entwickler

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

So suchen Sie in der Nähe basierend auf der Geschäftskette

Mit der SearchNearby API können Sie Geschäftsketten in der Nähe abfragen. Sie können bestimmte Geschäftsketten in Ihre Suche einbeziehen oder ausschließen. Diese Funktion ermöglicht es Endbenutzern, Stadtteile zu erkunden, Sehenswürdigkeiten zu entdecken und vieles mehr.

Um die SearchNearby API verwenden zu können QueryPosition, müssen Sie Folgendes angeben:

  • Eine Geräteposition

  • Eine IP-basierte Position

  • Der Mittelpunkt des Darstellungsfensters einer Karte

Alternativ können Benutzer einen Stadtnamen oder einen Ort angeben, und die Anwendung kann die Ergebnisse anhand der Geokoordinaten dieses Standorts verzerren.

Weitere Informationen zu unterstützten Geschäftsketten finden Sie unter. Filter für Unternehmensketten

Mögliche Anwendungsfälle

  • Erkunden Sie Unternehmen in der Nähe

  • Erweitern Sie Ihr Geschäft, indem Sie B2B-Kunden in der Nähe finden

Beispiele

Das folgende Beispiel zeigt, wie Sie nach Starbucks-Standorten in der Nähe suchen.

Sample request

Diese Anfrage sucht nach Starbucks-Standorten in der Nähe der angegebenen Koordinaten.

{
    "QueryPosition": [
        12.49563,
        41.90325
    ],
    "Filter" : {
        "IncludeBusinessChains": ["Starbucks"]
    }    
}
Sample response
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointOfInterest",
            "Title": "Starbucks",
            "Address": {
                "Label": "Starbucks, Via Giovanni Giolitti, 2, 00185 Roma RM, Italia",
                "Country": {
                    "Code2": "IT",
                    "Code3": "ITA",
                    "Name": "Italia"
                },
                "Region": {
                    "Name": "Lazio"
                },
                "SubRegion": {
                    "Code": "RM",
                    "Name": "Roma"
                },
                "Locality": "Roma",
                "District": "Esquilino",
                 "PostalCode": "00185",
                "Street": "Via Giovanni Giolitti",
                "StreetComponents": [
                    {
                        "BaseName": "Giovanni Giolitti",
                        "Type": "Via",
                        "TypePlacement": "BeforeBaseName",
                        "TypeSeparator": " ",
                        "Language": "it"
                    }
                ],
                "AddressNumber": "2"
            },
            "Position": [
                12.50102,
                41.90093
            ],
            "Distance": 515,
            "Categories": [
                {
                    "Id": "coffee_shop",
                    "Name": "Coffee Shop",
                    "LocalizedName": "Bar",
                    "Primary": true
                }
            ],
            "BusinessChains": [
                {
                    "Name": "Starbucks",
                    "Id": "Starbucks"
                }
            ]
        }
    ]
}
cURL
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-nearby?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryPosition": [
                12.49563,
                41.90325
        ],
        "Filter" : {
        "IncludeBusinessChains": ["Starbucks"]
    }    
}'
AWS CLI
aws geo-places search-nearby --key ${YourKey} \
--query-position 12.49563 41.90325 \
--filter '{"IncludeBusinessChains": ["Starbucks"]}'

Tipps für Entwickler

  • Sie können ExcludeBusinessChains damit bestimmte Geschäftsketten aus Ihren Ergebnissen ausschließen.

  • Sie können mehrere Geschäftsketten ausschließen oder einbeziehen.