Migrer vers Text Search (nouveau)

Développeurs de l'Espace économique européen (EEE)

Introduction

L'ancienne API Places est compatible avec Text Search (ancienne version). Si vous connaissez Text Search (ancienne version), Text Search (nouvelle version) apporte les modifications suivantes :

  • La nouvelle recherche de texte utilise des requêtes HTTP POST. Transmettez les paramètres dans le corps ou les en-têtes de la requête dans le cadre d'une requête HTTP POST. En revanche, avec Text Search (ancienne version), vous transmettez les paramètres d'URL à l'aide d'une requête HTTP GET.
  • Le masquage de champ est obligatoire. Vous devez spécifier les champs que vous souhaitez renvoyer dans la réponse. Il n'existe pas de liste par défaut des champs renvoyés. Si vous omettez cette liste, les méthodes renvoient une erreur. Pour en savoir plus, consultez FieldMask.
  • La nouvelle recherche de texte 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 nouvelle recherche de texte.

  • La recherche de texte (ancienne version) vous permet de spécifier des coordonnées de latitude et de longitude dans la chaîne de requête. Exemple : query=37.4239,-122.0925. Cette option n'est pas disponible dans la nouvelle recherche de texte.

    Utilisez le geocoding inversé pour effectuer une recherche à partir de coordonnées et renvoyer une adresse, ou Nearby Search (nouveau) pour trouver des lieux à proximité d'un emplacement donné.

  • Le format de réponse JSON pour la recherche de texte (nouveau) a changé par rapport à celui des anciennes API. Pour en savoir plus, consultez Migrer la réponse de l'API Places.

Le tableau suivant répertorie les paramètres de la recherche de texte (ancienne version) qui ont été renommés ou modifiés pour la recherche de texte (nouvelle version), ou les 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 pageToken
query textQuery Obligatoire dans toutes les requêtes.
radius locationBias Spécifiez le rayon lorsque vous définissez un locationBias.
region regionCode
type includedType N'accepte qu'une seule valeur.
strictTypeFiltering Nouveau paramètre.

Exemple de requête

L'exemple de requête GET suivant utilise la recherche de texte (ancienne version). Dans cet exemple, vous demandez une réponse JSON contenant des informations sur les "plats végétariens épicés à Sydney, en 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 la recherche de texte (nouvelle version), 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 dans le cadre de la requête POST. Cet exemple utilise également un masque de champ pour que la réponse n'inclue que le nom à afficher et l'adresse mise en forme 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'