View a markdown version of this page

Cómo buscar sitios cercanos en función de la cadena empresarial - Amazon Location Service
Casos de uso potencialesEjemplosConsejos de 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 sitios cercanos en función de la cadena empresarial

La SearchNearby API le permite consultar cadenas comerciales cercanas. Puede incluir o excluir cadenas empresariales específicas en la búsqueda. Esta característica permite a los usuarios finales explorar barrios, detectar puntos de interés, etc.

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

  • Una posición del dispositivo

  • Una posición basada en IP

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

Otra opción, los usuarios pueden proporcionar un nombre de ciudad o 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 empresariales compatibles, consulte Filtro de cadenas empresariales.

Casos de uso potenciales

  • Exploración de las empresas de los alrededores

  • Expansión de la empresa al encontrar 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 de desarrolladores

  • Puede utilizar ExcludeBusinessChains para excluir determinadas cadenas empresariales de los resultados.

  • Puede excluir o incluir varias cadenas empresariales.