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 du contexte géospatial
<a name="how-to-geocode-geospatial"></a>

L'API Geocode vous permet d'utiliser le contexte géospatial (tel que la position du biais) pour obtenir les résultats souhaités.

**Note**  
La « position biaisée » fait référence à un mécanisme qui hiérarchise les résultats de recherche en fonction de l'emplacement ou d'une zone définis par l'utilisateur. Cela déplace essentiellement l'orientation des résultats de recherche vers des emplacements géographiquement plus proches d'un point de biais désigné, sans nécessairement exclure les autres résultats. 

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

Utilisez le contexte géospatial pour obtenir les bons résultats en fonction des besoins de votre entreprise.

## Exemples
<a name="geospatial-examples"></a>

### Biaiser les résultats en faveur d'une position
<a name="bias-position-example"></a>

En privilégiant une position, vous pouvez modifier le classement de vos résultats. Essayez l'exemple suivant, avec, puis sans, la `BiasPosition` valeur et comparez les résultats.

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

```
{
    "QueryText": "George Street",
    "BiasPosition": [
                151.2059,
                -33.8691
            ]
}
```

------
#### [ Sample response ]

```
{
    "ResultItems": [
        {
            "PlaceId": "<Redacted>",
            "PlaceType": "Street",
            "Title": "George St, Sydney NSW, Australia",
            "Address": {
                "Label": "George St, Sydney NSW, Australia",
                "Country": {
                    "Code2": "AU",
                    "Code3": "AUS",
                    "Name": "Australia"
                },
                "Region": {
                    "Code": "NSW",
                    "Name": "New South Wales"
                },
                "Locality": "Sydney",
                "Street": "George St",
                "StreetComponents": [
                    {
                        "BaseName": "George",
                        "Type": "St",
                        "TypePlacement": "AfterBaseName",
                        "TypeSeparator": " ",
                        "Language": "en"
                    }
                ]
            },
            "Position": [
                151.20691,
                -33.86974
            ],
            "Distance": 117,
            "MapView": [
                151.20225,
                -33.88406,
                151.20912,
                -33.85635
            ],
            "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": "George Street",
    "BiasPosition": [
                151.2059,
                -33.8691
            ]
}'
```

------
#### [ AWS CLI ]

```
aws geo-places geocode --key ${YourKey} --query-text "George Street" --bias-position 151.2059 -33.8691
```

------

## Conseils aux développeurs
<a name="geospatial-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).