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 géocoder à l'aide de filtres
<a name="how-to-geocode-filters"></a>

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

## Utilisation potentielle
<a name="geocode-filters-uses"></a>

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

## Exemples
<a name="geocode-filters-examples"></a>

### Limiter les résultats au sein d'un pays
<a name="geocode-filter-country-example"></a>

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

------
#### [ Sample request ]

Sans cela`IncludeCountries": ["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
<a name="geocode-filter-place-example"></a>

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

------
#### [ Sample request ]

Sans cela`IncludePlaceTypes": ["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
<a name="geocode-filters-developer-tips"></a>

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](how-to-geocode-address.md).