Migrer vers la saisie semi-automatique (nouveau)

Introduction

L'API Places est compatible avec les API Place Autocomplete (ancienne) et Query Autocomplete (ancienne). Si vous connaissez ces API, sachez qu'Autocomplete (nouveau) 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 anciennes API, vous transmettez les paramètres d'URL à l'aide d'une requête HTTP GET.
• La saisie semi-automatique (nouveau) 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 la nouvelle saisie semi-automatique.

Le tableau suivant liste les paramètres de Place Autocomplete (ancienne version) et de Query Autocomplete (ancienne version) qui ont été renommés ou modifiés pour Autocomplete (nouveau), ou les paramètres 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 le biais d'adresse IP par défaut.
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 (ancienne version). 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 envoyez 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 (nouveau), 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 pour 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 Place Details (New).