Migrer vers la saisie semi-automatique (nouveau)

Développeurs de l'Espace économique européen (EEE)

Introduction

L'API Places est compatible avec les API Place Autocomplete (Legacy) et Query Autocomplete (Legacy). Si vous connaissez ces API, sachez qu'Autocomplete (New) apporte les modifications suivantes :

  • Autocomplete (New) utilise des requêtes HTTP POST. Transmettez les paramètres dans le corps de la requête ou dans les en-têtes dans le cadre d'une requête HTTP POST. En revanche, avec les API héritées, vous transmettez les paramètres d'URL à l'aide d'une requête GET HTTP.
  • Autocomplete (New) est compatible avec les clés API et les jetons OAuth comme mécanisme d'authentification.
  • Seul le format JSON est accepté comme format de réponse dans Autocomplete (New).

Le tableau suivant répertorie les paramètres de Place Autocomplete (Legacy) et de Query Autocomplete (Legacy) qui ont été renommés ou modifiés pour Autocomplete (New), ou qui ne sont plus compatibles.

Paramètre actuel Nouveau paramètre Remarques
components includedRegionCodes
language languageCode
location locationBias
ipbias Si vous omettez locationBias et locationRestriction, l' API utilise par défaut la pondération par adresse IP.
offset inputOffset
radius locationBias ou locationRestriction
region regionCode
stricbounds locationRestriction
sessiontoken sessionToken
types includedPrimaryTypes

Exemple de requête

L'exemple de requête GET suivant utilise Place Autocomplete (Legacy). Dans cet exemple, vous demandez une réponse JSON contenant des informations sur les lieux appelés "Amoeba" de type establishment et transmettez tous les paramètres en tant que paramètres d'URL :

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/autocomplete/json?input=amoeba&types=establishment&location=37.76999%2C-122.44696&radius=500&key=YOUR_API_KEY'

Avec Autocomplete (New), vous effectuez une requête POST et transmettez tous les paramètres dans le corps de la requête JSON ou dans les en-têtes dans le cadre de la requête POST.

Les masques de champ ne sont pas obligatoires pour les requêtes Autocomplete (New), mais ils peuvent être utilisés pour filtrer des résultats spécifiques dans la réponse. Par exemple, la requête suivante utilise un masque de champ afin que la réponse n'inclue que le suggestions.placePrediction.text de la suggestion :

curl -X POST -d '{
  "input": "Amoeba",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 37.76999,
        "longitude": -122.44696
      },
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: suggestions.placePrediction.text' \
https://places.googleapis.com/v1/places:autocomplete

Pour en savoir plus sur l'utilisation des masques de champ, consultez la section Place Details (New).