Come cercare nelle vicinanze in base alla catena di attività - Servizio di posizione Amazon
Casi d'uso potenzialiEsempiSuggerimenti per gli sviluppatori

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Come cercare nelle vicinanze in base alla catena di attività

L' SearchNearby API consente di interrogare le catene commerciali vicine. Puoi includere o escludere catene commerciali specifiche nella tua ricerca. Questa funzionalità consente agli utenti finali di esplorare quartieri, scoprire punti di interesse e altro ancora.

Per utilizzare l' SearchNearby API, devi fornire un QueryPosition, che può essere:

  • La posizione di un dispositivo

  • Una posizione basata su IP

  • Il centro di visualizzazione di una mappa

In alternativa, gli utenti possono fornire il nome di una città o un luogo e l'applicazione può modificare i risultati in base alle coordinate geografiche di quella posizione.

Per ulteriori informazioni sulle catene aziendali supportate, consulta. filtro Business Chains

Casi d'uso potenziali

  • Esplora le attività commerciali nelle vicinanze

  • Espandi la tua attività trovando clienti B2B nelle vicinanze

Esempi

L'esempio seguente mostra come cercare punti vendita Starbucks nelle vicinanze.

Sample request

Questa richiesta cerca le sedi Starbucks vicino alle coordinate specificate.

{
    "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"]}'

Suggerimenti per gli sviluppatori

  • Puoi utilizzarlo ExcludeBusinessChains per escludere determinate catene aziendali dai risultati.

  • Puoi escludere o includere più catene aziendali.