Comment rechercher un lieu à l'aide de ses coordonnées - Amazon Location Service
Cas d'utilisation potentielsExemples

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 rechercher un lieu à l'aide de ses coordonnées

L' SearchText API permet aux utilisateurs de rechercher un lieu à l'aide d'un numéro de téléphone, en prenant en charge les formats internationaux et locaux. Les utilisateurs peuvent biaiser les résultats en définissant une position en fonction de l'emplacement de l'appareil, de l'adresse IP ou du centre de la fenêtre d'affichage de la carte, ou en spécifiant une ville ou un lieu pour affiner les résultats en fonction des coordonnées géographiques.

Cas d'utilisation potentiels

  • Localiser un lieu avec un numéro de téléphone : trouvez un POI en utilisant son numéro de contact pour récupérer son adresse.

Exemples

Dans cet exemple, l'Aquarium de Vancouver est recherché à l'aide de son numéro de téléphone « +1 778-655-9554 » à partir d'une position biaisée à Vancouver, en Colombie-Britannique.

Sample request
{
    "QueryText": "+1 778-655-9554",
    "BiasPosition": [
        -123.11336,
        49.26038
    ]
}
Sample response
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PointOfInterest",
            "Title": "Vancouver Aquarium",
            "Address": {
                "Label": "Vancouver Aquarium, 834 Avison Way, Vancouver, BC V6G, Canada",
                "Country": {
                    "Code2": "CA",
                    "Code3": "CAN",
                    "Name": "Canada"
                },
                "Region": {
                    "Code": "BC",
                    "Name": "British Columbia"
                },
                "SubRegion": {
                    "Name": "Metro Vancouver"
                },
                "Locality": "Vancouver",
                "District": "Stanley Park",
                "PostalCode": "V6G",
                "Street": "Avison Way",
                "StreetComponents": [
                    {
                        "BaseName": "Avison",
                        "Type": "Way",
                        "TypePlacement": "AfterBaseName",
                        "TypeSeparator": " ",
                        "Language": "en"
                    }
                ],
                "AddressNumber": "834"
            },
            "Position": [
                -123.13049,
                49.30013
            ],
            "Distance": 4591,
            "Categories": [
                {
                    "Id": "aquarium",
                    "Name": "Aquarium",
                    "LocalizedName": "Aquarium",
                    "Primary": true
                },
                {
                    "Id": "tourist_attraction",
                    "Name": "Tourist Attraction",
                    "LocalizedName": "Tourist Attraction",
                    "Primary": false
                }
            ]
        }
    ]
}
cURL
curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/search-text?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
    "QueryText": "+1 778-655-9554",
    "BiasPosition": [
        -123.11336,
        49.26038
    ]
}'
AWS CLI
aws geo-places search-text --key ${YourKey} --query-text "+1 778-655-9554" --bias-position -123.11336 49.26038