L'API Places est compatible avec les API Place Autocomplete (ancienne) et Query Autocomplete (ancienne). Si vous connaissez ces API, Autocomplete (Nouveau) apporte les modifications suivantes:
- La saisie semi-automatique (nouvelle) 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 POST HTTP. À l'inverse, avec les anciennes API, 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 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 liste les paramètres de Place Autocomplete (ancienne version) et de Saisie semi-automatique de requêtes (ancienne version) qui ont été renommés ou modifiés pour la saisie semi-automatique (nouvelle version), ou les paramètres qui ne sont plus pris en charge.
| 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 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 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, de sorte que la réponse n'inclut 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 Détails du lieu (nouveau).