Comment effectuer une recherche à proximité en fonction de la chaîne d'entreprises - Amazon Location Service
Cas d'utilisation potentielsExemplesConseils aux développeurs

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Comment effectuer une recherche à proximité en fonction de la chaîne d'entreprises

L' SearchNearby API vous permet d'interroger les chaînes commerciales voisines. Vous pouvez inclure ou exclure des chaînes commerciales spécifiques dans votre recherche. Cette fonctionnalité permet aux utilisateurs finaux d'explorer les quartiers, de découvrir des points d'intérêt, etc.

Pour utiliser l' SearchNearby API, vous devez fournir un QueryPosition, qui peut être :

  • Une position de l'appareil

  • Une position basée sur l'IP

  • Centre de la fenêtre d'affichage d'une carte

Les utilisateurs peuvent également fournir le nom d'une ville ou d'un lieu, et l'application peut biaiser les résultats en fonction des coordonnées géographiques de cet emplacement.

Pour plus d'informations sur les chaînes commerciales prises en charge, consultezFiltre Business Chains.

Cas d'utilisation potentiels

  • Découvrez les entreprises des environs

  • Développez votre activité en trouvant des clients B2B à proximité

Exemples

L'exemple suivant montre comment rechercher des établissements Starbucks à proximité.

Sample request

Cette demande recherche des établissements Starbucks situés à proximité des coordonnées spécifiées.

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

Conseils aux développeurs

  • Vous pouvez l'utiliser ExcludeBusinessChains pour exclure certaines chaînes commerciales de vos résultats.

  • Vous pouvez exclure ou inclure plusieurs chaînes commerciales.