L'API Places est compatible avec Saisie semi-automatique et Query Autocomplete. Si vous connaissez ces API, la saisie semi-automatique (nouvelle version) apporte les modifications suivantes:
- La saisie semi-automatique (nouvelle version) utilise des requêtes HTTP POST. Transmettre des paramètres dans dans le corps de la requête ou dans les en-têtes d'une requête HTTP POST. En revanche, avec les API existantes, vous transmettez les paramètres d'URL à l'aide d'un requête HTTP GET.
- La saisie semi-automatique (nouveau) est compatible avec les deux clés API et les jetons OAuth comme mécanisme d'authentification.
- Seul le format de réponse JSON est accepté dans la saisie semi-automatique (nouveau).
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 à la fois locationBias et locationRestriction, le
L'API utilise la pondération de l'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 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 Autocomplete (Nouveau), vous effectuez une requête POST et transmettre tous les paramètres dans le corps de la requête JSON ou dans les en-têtes dans le cadre de la méthode POST. requête. Cet exemple utilise également un masque de champ afin que la réponse n'inclue que le Nom à afficher et adresse formatée du lieu:
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" \
https://places.googleapis.com/v1/places:autocomplete