View a markdown version of this page

Como pesquisar nas proximidades com base na rede de negócios - Amazon Location Service
Casos de uso possíveisExemplosDicas para o desenvolvedor

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 rede de negócios

A SearchNearby API permite que você consulte cadeias de negócios próximas. Você pode incluir ou excluir redes de negócios específicas em sua pesquisa. Esse atributo 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:

  • Posição do dispositivo

  • Posição baseada em IP

  • O centro da janela de um mapa

Como alternativa, os usuários podem informar um nome de cidade ou local, e a aplicação pode desviar os resultados com base nas coordenadas geográficas desse local.

Para obter mais informações sobre as redes de negócios aceitas, consulte Filtro de Cadeias de negócios.

Casos de uso possíveis

  • Explorar empresas nas proximidades

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

Exemplos

O exemplo a seguir demonstra como pesquisar locais próximos do Starbucks.

Sample request

Essa solicitação pesquisa locais do 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 o desenvolvedor

  • Você pode usar ExcludeBusinessChains para excluir determinadas redes de negócios dos resultados.

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