Como pesquisar nas proximidades com base na cadeia de negócios - Amazon Location Service
Casos de uso em potencialExemplosDicas para desenvolvedores

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Como pesquisar nas proximidades com base na cadeia de negócios

A SearchNearby API permite que você consulte cadeias de negócios próximas. Você pode incluir ou excluir cadeias de negócios específicas em sua pesquisa. Esse recurso permite que os usuários finais explorem bairros, descubram pontos de interesse e muito mais.

Para usar a SearchNearby API, você precisa fornecer um QueryPosition, que pode ser:

  • Uma posição do dispositivo

  • Uma posição baseada em IP

  • O centro da janela de visualização de um mapa

Como alternativa, os usuários podem fornecer um nome de cidade ou local, e o aplicativo pode distorcer os resultados com base nas coordenadas geográficas desse local.

Para obter mais informações sobre cadeias de negócios suportadas, consulteFiltro de cadeias de negócios.

Casos de uso em potencial

  • Explore empresas nas proximidades

  • Expanda seus negócios encontrando clientes B2B próximos

Exemplos

O exemplo a seguir demonstra como pesquisar lojas próximas da Starbucks.

Sample request

Essa solicitação pesquisa locais da Starbucks próximos às coordenadas especificadas.

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

Dicas para desenvolvedores

  • Você pode usar ExcludeBusinessChains para excluir determinadas cadeias de negócios de seus resultados.

  • Você pode excluir ou incluir várias cadeias de negócios.