L'API Places est compatible avec les API Autocomplete et Query Autocomplete existantes. 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. 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 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 Autocomplete de requête existantes qui ont été renommés ou modifiés pour Autocomplete (Nouveau), 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 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 la saisie semi-automatique de lieux existante. 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 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 (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 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 Détails des lieux (nouveau).