Comment géocoder à l'aide de filtres

L'API Geocode vous permet d'utiliser des filtres pour obtenir les résultats souhaités.

Utilisation potentielle

Utilisez des filtres pour limiter les résultats en fonction des besoins de votre entreprise.

Exemples

Limiter les résultats au sein d'un pays

Spécifiez une valeur IncludeCountries pour renvoyer des valeurs pour ce pays dans les résultats.

Sample request

Sans celaIncludeCountries": ["USA"], l'API Geocode renverra Vancouver, en Colombie-Britannique, au Canada.

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

Sample response

{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "Locality",
            "Title": "Vancouver, WA, United States",
            "Address": {
                "Label": "Vancouver, WA, United States",
                "Country": {
                    "Code2": "US",
                    "Code3": "USA",
                    "Name": "United States"
                },
                "Region": {
                    "Code": "WA",
                    "Name": "Washington"
                },
                "SubRegion": {
                    "Name": "Clark"
                },
                "Locality": "Vancouver",
                "PostalCode": "98660"
            },
            "Position": [
                -122.67156,
                45.63248
            ],
            "MapView": [
                -122.77466,
                45.57714,
                -122.46451,
                45.69803
            ],
            "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",
    "Filter" : {
        "IncludeCountries": ["USA"]
    }
}'

AWS CLI

aws geo-places geocode --key ${YourKey} --query-text "Vancouver" --filter '{"IncludeCountries": ["USA"]}'

Affiner les résultats avec des filtres de type de lieu

Spécifiez une valeur pour IncludePlaceTypes pour renvoyer les valeurs correspondant à cet endroit dans les résultats.

Sample request

Sans celaIncludePlaceTypes": ["Street"], l'API Geocode renverra la Géorgie, un pays. Vous pouvez affiner davantage les résultats en ajoutant "IncludeCountries" les valeurs du CAN et des États-Unis et en comparant les résultats.

{
  "QueryText": "Georgia", 
    "Filter" : {
        "IncludePlaceTypes": ["Street"]
    }
    
}

Sample response

{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "Street",
            "Title": "Georgia, Benito Juárez, CDMX, México",
            "Address": {
                "Label": "Georgia, Benito Juárez, CDMX, México",
                "Country": {
                    "Code2": "MX",
                    "Code3": "MEX",
                    "Name": "México"
                },
                "Region": {
                    "Code": "CDMX",
                    "Name": "Ciudad de México"
                },
                "SubRegion": {
                    "Name": "Ciudad de México"
                },
                "Locality": "Benito Juárez",
                "Street": "Georgia",
                "StreetComponents": [
                    {
                        "BaseName": "Georgia",
                        "Language": "es"
                    }
                ]
            },
            "Position": [
                -99.17754,
                19.38887
            ],
            "MapView": [
                -99.18133,
                19.38755,
                -99.17374,
                19.39016
            ],
            "MatchScores": {
                "Overall": 1,
                "Components": {
                    "Address": {
                        "Intersection": [
                            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": "Georgia", 
    "Filter" : {
        "IncludePlaceTypes": ["Street"]
    }
    
}'

AWS CLI

aws geo-places geocode --key ${YourKey} --query-text "Georgia" --filter '{"IncludePlaceTypes": ["Street"]}'

Conseils aux développeurs

Pour le géocodage des adresses, essayez d'utiliser des adresses complètes ou un composant de requête avec une combinaison de positions biaisées, y compris le pays et le lieu. Pour en savoir plus, consultez Comment géocoder une adresse.