Comment géocoder une zone administrative et postale

L'API Geocode vous permet d'effectuer le géocodage d'une zone géographique à l'aide d'une saisie de texte de requête, telle que le nom d'un pays, d'une région (État ou province) ou d'une ville. La réponse de l'API inclut des détails de localisation tels que les coordonnées géographiques, les cadres de délimitation pour les visualisations de cartes et les scores de correspondance indiquant la pertinence du résultat par rapport à la requête.

Cas d'utilisation potentiels

• Obtenir les coordonnées d'une zone administrative : utilisez les coordonnées comme position biaisée ou comme centre dans d'autres lieux APIs.

• Visualisez les informations sur une carte : les coordonnées géocodées peuvent être utilisées pour afficher les données visuellement sur une carte.

Exemples

Géocoder un pays

Sample request

{
  "QueryText": "Canada"
}

Sample response

{
    "ResultItems": [
        {
            "PlaceId":"<Redacted>",
            "PlaceType": "Country",
            "Title": "Canada",
            "Address": {
                "Label": "Canada",
                "Country": {
                    "Code2": "CA",
                    "Code3": "CAN",
                    "Name": "Canada"
                }
            },
            "Position": [-75.69122, 45.42177],
            "MapView": [-141.00271, 41.67659, -52.61901, 83.11062],
            "MatchScores": {
                "Overall": 1,
                "Components": {
                    "Address": { "Country": 1 }
                }
            }
        }
    ]
}

cURL

curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/geocode?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
  "QueryText": "Canada"
}'

AWS CLI

aws geo-places geocode --key ${YourAPIKey} --query-text "Canada"

Géocoder une région

Sample request

{
  "QueryText": "BC"
}

Sample response

{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "Region",
            "Title": "BC, Canada",
            "Address": {
                "Label": "BC, Canada",
                "Country": {
                    "Code2": "CA",
                    "Code3": "CAN",
                    "Name": "Canada"
                },
                "Region": {
                    "Code": "BC",
                    "Name": "British Columbia"
                }
            },
            "Position": [-123.36445, 48.42854],
            "MapView": [-139.04941, 48.22478, -114.05201, 60.00043],
            "MatchScores": {
                "Overall": 1,
                "Components": {
                    "Address": { "Region": 1 }
                }
            }
        }
    ]
}

cURL

curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/geocode?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
  "QueryText": "BC"
}'

AWS CLI

aws geo-places geocode --key ${YourAPIKey} --query-text "BC"

Géocoder une ville

Sample request

{
  "QueryText": "Vancouver"
}

Sample response

{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "Locality",
            "Title": "Vancouver, BC, Canada",
            "Address": {
                "Label": "Vancouver, BC, Canada",
                "Country": {
                    "Code2": "CA",
                    "Code3": "CAN",
                    "Name": "Canada"
                },
                "Region": {
                    "Code": "BC",
                    "Name": "British Columbia"
                },
                "SubRegion": {
                    "Name": "Metro Vancouver"
                },
                "Locality": "Vancouver",
                "PostalCode": "V5Y"
            },
            "Position": [-123.11336, 49.26038],
            "MapView": [-123.26754, 49.19891, -123.02301, 49.33557],
            "MatchScores": {
                "Overall": 1,
                "Components": {
                    "Address": { "Locality": 1 }
                }
            }
        }
    ]
}

cURL

curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/geocode?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
  "QueryText": "Vancouver"
}'

AWS CLI

aws geo-places geocode --key ${YourAPIKey} --query-text "Vancouver"

Géocoder un code postal

Vous pouvez géocoder un code postal. À utiliser IncludePlaceTypes avec ["PostalCode"] pour obtenir des résultats plus précis.

Sample request

{
  "QueryText": "800006",
  "Filter": { "IncludePlaceTypes": ["PostalCode"] }
}

Sample response

{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "PostalCodeArea",
            "Title": "800006, Patna, Bihar, India",
            "Address": {
                "Label": "800006, Patna, Bihar, India",
                "Country": {
                    "Code2": "IN",
                    "Code3": "IND",
                    "Name": "India"
                },
                "Region": {
                    "Code": "BR",
                    "Name": "Bihar"
                },
                "SubRegion": { "Name": "Patna" },
                "Locality": "Patna",
                "PostalCode": "800006"
            },
            "Position": [85.18048, 25.61532],
            "MapView": [85.16599, 25.60054, 85.19103, 25.6221],
            "MatchScores": {
                "Overall": 1,
                "Components": {
                    "Address": { "PostalCode": 1 }
                }
            }
        }
    ]
}

cURL

curl --request POST \
  --url 'https://places.geo.eu-central-1.amazonaws.com/v2/geocode?key=Your_Key' \
  --header 'Content-Type: application/json' \
  --data '{
  "QueryText": "800006",
  "Filter": { "IncludePlaceTypes": ["PostalCode"] }
}'

AWS CLI

aws geo-places geocode --key ${YourAPIKey} --query-text "800006" --filter '{"IncludePlaceTypes": ["PostalCode"]}'

Conseils aux développeurs

Utilisez des filtres similaires à IncludeCountries et IncludePlaceTypes pour des résultats plus ciblés. Par exemple, pour garantir les résultats de Vancouver aux États-Unis, définissez"IncludeCountries": ["USA"]. Pour en savoir plus, consultez .

{
  "QueryText": "Vancouver",
  "Filter": { "IncludeCountries": ["USA"] }
}