L'API Places est compatible avec Text Search : Si vous connaissez la suite Text Search, nouvelle version de Text Search apporte les modifications suivantes:
- La nouvelle fonctionnalité Text Search utilise des requêtes HTTP POST. Réussite dans le corps ou dans les en-têtes d'une requête HTTP POST. En revanche, avec Text Search existant, vous transmettez Paramètres d'URL à l'aide d'une requête HTTP GET.
- Le masquage du champ est obligatoire. Vous devez spécifier les champs à renvoyer dans la réponse. Il n'existe pas de liste par défaut des champs renvoyés. Si vous omettez de cette liste, les méthodes renvoient une erreur. Pour en savoir plus, consultez FieldMask.
- La nouvelle version de Text Search 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 le nouveau Text Search
La fonctionnalité Text Search existante vous permet d'indiquer la latitude et la longitude dans la chaîne de requête. Exemple :
query=37.4239,-122.0925. Cette option n'est pas compatible avec la nouvelle version de Text Search.Utilisez Geocoding inversé pour rechercher des coordonnées et renvoyer une adresse ; ou Nearby Search (nouveau) pour trouver des lieux à proximité d'un lieu donné.
- Format de réponse JSON pour Text Search (nouvelle version) Le format des API existantes a été modifié. Pour en savoir plus, consultez Migrez la réponse de l'API Places.
Le tableau suivant répertorie les paramètres des ou Text Search qui ont été renommés ou modifiés pour avec Text Search, ou des paramètres qui ne sont plus compatibles.
| Paramètre actuel | Nouveau paramètre | Remarques |
|---|---|---|
evOptions |
Nouveau paramètre. | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
pagetoken |
Non compatible. | |
query |
textQuery |
Obligatoire dans toutes les requêtes. |
radius |
locationBias |
Spécifiez le rayon lorsque vous définissez une locationBias. |
region |
regionCode |
|
type |
includedType |
n'accepte qu'une seule valeur. |
strictTypeFiltering |
Nouveau paramètre. |
Exemple de requête
L'exemple suivant de demande GET utilise Text Search Dans cet exemple, vous demandez un fichier réponse contenant des informations sur la mention "Spicy Vegetarian Food in Sydney, Australie et transmettez tous les paramètres en tant que paramètres d'URL:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=Spicy%20Vegetarian%20Food%20in%20Sydney%20Australia&key=API_KEY
Avec Text Search (nouvelle version), 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 '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress' \
'https://places.googleapis.com/v1/places:searchText'