Cómo buscar en las cercanías según la cadena de negocios - Amazon Location Service
Casos de uso potencialesEjemplosConsejos para desarrolladores

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Cómo buscar en las cercanías según la cadena de negocios

La SearchNearby API le permite consultar las cadenas comerciales cercanas. Puedes incluir o excluir cadenas comerciales específicas en tu búsqueda. Esta función permite a los usuarios finales explorar barrios, descubrir puntos de interés y mucho más.

Para usar la SearchNearby API, debes proporcionar una QueryPosition, que puede ser:

  • La posición de un dispositivo

  • Una posición basada en IP

  • El centro de la ventana gráfica de un mapa

Como alternativa, los usuarios pueden proporcionar el nombre de una ciudad o un lugar, y la aplicación puede sesgar los resultados en función de las coordenadas geográficas de esa ubicación.

Para obtener más información sobre las cadenas comerciales compatibles, consulte. Filtro de cadenas empresariales

Casos de uso potenciales

  • Explore los negocios de los alrededores

  • Amplíe su negocio encontrando clientes B2B cercanos

Ejemplos

En el siguiente ejemplo, se muestra cómo buscar ubicaciones de Starbucks cercanas.

Sample request

Esta solicitud busca ubicaciones de Starbucks cercanas a las 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"]}'

Consejos para desarrolladores

  • Puedes utilizarla ExcludeBusinessChains para excluir determinadas cadenas comerciales de tus resultados.

  • Puede excluir o incluir varias cadenas comerciales.