Migrer vers la saisie semi-automatique (nouveau)

L'API Places est compatible avec Saisie semi-automatique et Query Autocomplete. Si vous connaissez ces API, Autocomplete (Nouveau) apporte les modifications suivantes :

  • La saisie semi-automatique (nouvelle) utilise des requêtes HTTP POST. Transmettre les paramètres dans dans le corps de la requête ou dans les en-têtes d'une requête HTTP POST. Contrairement aux API existantes, vous transmettez les paramètres d'URL à l'aide d'une requête HTTP GET.
  • La saisie semi-automatique (nouvelle) 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 saisie semi-automatique (nouvelle).

Le tableau suivant répertorie les paramètres des API Autocomplete et Query Autocomplete renommées ou modifiées pour Autocomplete (nouvelle), ou 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 biaisage IP par défaut.
offset inputOffset
radius locationBias ou locationRestriction
region regionCode
stricbounds locationRestriction
sessiontoken sessionToken
types includedPrimaryTypes

Exemple de requête

L'exemple suivant de demande GET utilise Place Autocomplete. Dans cet exemple, vous demandez un fichier réponse contenant des informations sur des lieux appelés "Amoeba" qui sont 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 la saisie semi-automatique (nouvelle), 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 de la requête POST.

Les masques de champ ne sont pas obligatoires pour les requêtes Autocomplete (New), mais ils peuvent être utilisé pour filtrer des résultats spécifiques dans la réponse. Par exemple : utilise un masque de champ. La réponse n'inclut donc que le champ 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 Places Details (Nouveau).