Cette page a été traduite par l'API Cloud Translation.

Text Search (nouvelle version)

Sélectionnez une plate-forme : Android iOS JavaScript Services Web

Text Search (nouveau) renvoie des informations sur un ensemble de lieux en fonction d'une chaîne, par exemple "pizza à New York", "magasin de chaussures près d'Ottawa" ou "123 Main Street". Ce service renvoie une liste des lieux correspondant à la chaîne de texte et aux limitations de zone géographique définis.

Ce service est particulièrement utile pour effectuer des requêtes d'adresses ambiguës dans un système automatisé. Les composants autres que l'adresse de la chaîne peuvent correspondre à des entreprises et à des adresses. Les adresses mal formatées ou les requêtes qui incluent des composants autres que des adresses, comme des noms d'entreprises, sont des exemples de requêtes d'adresses ambiguës. Les requêtes comme les deux premiers exemples du tableau suivant peuvent ne renvoyer aucun résultat, sauf si un emplacement (par exemple, une région, une restriction d'emplacement ou un biais d'emplacement) est défini.

"10 High Street, Royaume-Uni" ou "123 Main Street, États-Unis"	"High Street" au Royaume-Uni et "Main Street" aux États-Unis La requête ne renvoie pas de résultats souhaités, sauf si une restriction de zone géographique est définie.
"ChainRestaurant New York"	Plusieurs établissements "ChainRestaurant" à New York, sans adresse ni même nom de rue.
"10 High Street, Escher UK" ou "123 Main Street, Pleasanton US"	Il n'existe qu'une seule "High Street" dans la ville britannique d'Escher et une seule "Main Street" dans la ville américaine de Pleasanton (Californie).
"UniqueRestaurantName New York"	Un seul établissement portant ce nom à New York. Aucune adresse n'est nécessaire pour le différencier.
"restaurants de pizza à New York"	Cette requête contient sa restriction géographique, et "restaurants de pizzas" est un type d'établissement bien défini. Il renvoie plusieurs résultats.
"+1 514-670-8700"	Cette requête contient un numéro de téléphone. Elle renvoie plusieurs résultats pour les lieux associés à ce numéro de téléphone. Remarque : Pour de meilleurs résultats lors d'une recherche sur un numéro de téléphone, incluez le code pays suivi d'un espace, et définissez le paramètre `regionCode` pour qu'il corresponde au code pays.

L'explorateur d'API vous permet d'envoyer des requêtes en direct afin de vous familiariser avec l'API et ses options:

Essayer

Requêtes Text Search

Une requête de recherche de texte est une requête HTTP POST de la forme suivante:

https://places.googleapis.com/v1/places:searchText

Transmettez tous les paramètres dans le corps de la requête JSON ou dans les en-têtes de la requête POST. Exemple :

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,places.priceLevel' \
'https://places.googleapis.com/v1/places:searchText'

Réponses Text Search (nouvelle version)

La recherche de texte (nouvelle) renvoie un objet JSON en réponse. Dans la réponse :

Le tableau places contient tous les lieux correspondants.
Chaque lieu du tableau est représenté par un objet Place. L'objet Place contient des informations détaillées sur un seul lieu.
Le FieldMask transmis dans la requête spécifie la liste des champs renvoyés dans l'objet Place.

L'objet JSON complet se présente sous la forme suivante:

{
  "places": [
    {
      object (Place)
    }
  ]
}

Paramètres obligatoires

FieldMask

Spécifiez la liste des champs à renvoyer dans la réponse en créant un masque de champ de réponse. Transmettez le masque de champ de réponse à la méthode à l'aide du paramètre d'URL $fields ou fields, ou à l'aide de l'en-tête HTTP X-Goog-FieldMask. Aucune liste par défaut des champs renvoyés n'est fournie dans la réponse. Si vous omettez le masque de champ, la méthode renvoie une erreur.

Le masquage de champ est une bonne pratique à appliquer pour vous assurer de ne pas demander de données inutiles. Vous pourrez ainsi réduire le temps de traitement et les frais facturés.

Spécifiez une liste de types de données de lieu à renvoyer, séparés par une virgule. Par exemple, pour récupérer le nom à afficher et l'adresse du lieu.
```
X-Goog-FieldMask: places.displayName,places.formattedAddress
```
Remarque : Les espaces ne sont pas autorisés dans la liste des champs.

Utilisez * pour récupérer tous les champs.
```
X-Goog-FieldMask: *
```
Le caractère générique "*" sélectionne tous les champs. Toutefois, bien que ce caractère générique soit acceptable en développement, Google déconseille d'utiliser le masque de champ de réponse générique (*) en production en raison de la grande quantité de données pouvant être renvoyées.

Pour en savoir plus sur l'utilisation de places.iconMaskBaseUri et places.iconBackgroundColor, consultez la section Icônes de lieu.

Spécifiez un ou plusieurs des champs suivants:
- Les champs suivants déclenchent le SKU Text Search (ID Only):
  places.attributions, places.id, places.name^*, nextPageToken
  
  ^* Le champ places.name inclut le nom de ressource du lieu dans le formulaire: places/PLACE_ID. Utilisez places.displayName pour accéder au nom textuel du lieu.
- Les champs suivants déclenchent le SKU Text Search (Basic):
  places.accessibilityOptions, places.addressComponents, places.adrFormatAddress, places.businessStatus, places.containingPlaces, places.displayName, places.formattedAddress, places.googleMapsLinks^*, places.googleMapsUri, places.iconBackgroundColor, places.iconMaskBaseUri, places.location, places.photos, places.plusCode, places.primaryType, places.primaryTypeDisplayName, places.pureServiceAreaBusiness, places.shortFormattedAddress, places.subDestinations, places.types, places.utcOffsetMinutes, places.viewport
  
  ^* Le champ places.googleMapsLinks est en phase de pré-disponibilité générale et n'est pas facturé (0 $) pendant la phase de prévisualisation.
- Les champs suivants déclenchent le SKU Text Search (Advanced):
  places.currentOpeningHours, places.currentSecondaryOpeningHours, places.internationalPhoneNumber, places.nationalPhoneNumber, places.priceLevel, places.priceRange, places.rating, places.regularOpeningHours, places.regularSecondaryOpeningHours, places.userRatingCount, places.websiteUri
- Les champs suivants déclenchent le SKU Text Search (Preferred):
  places.allowsDogs, places.curbsidePickup, places.delivery, places.dineIn, places.editorialSummary, places.evChargeOptions, places.fuelOptions, places.goodForChildren, places.goodForGroups, places.goodForWatchingSports, places.liveMusic, places.menuForChildren, places.parkingOptions, places.paymentOptions, places.outdoorSeating, places.reservable, places.restroom, places.reviews, places.routingSummaries,^* places.servesBeer, places.servesBreakfast, places.servesBrunch, places.servesCocktails, places.servesCoffee, places.servesDessert, places.servesDinner, places.servesLunch, places.servesVegetarianFood, places.servesWine, places.takeout
  
  ^* Recherche textuelle et Recherche à proximité uniquement
textQuery

Chaîne de texte sur laquelle doit porter la recherche, par exemple "restaurant", "123 Main Street" ou "meilleur endroit à visiter à San Francisco". L'API renvoie les résultats correspondant à cette chaîne et les classe en fonction de leur pertinence estimée.

Paramètres facultatifs

includedType

Limite les résultats aux lieux correspondant au type spécifié défini par la table A. Vous ne pouvez spécifier qu'un seul type. Exemple :
- "includedType":"bar"
- "includedType":"pharmacy"
Remarque : Les valeurs du tableau B ne sont renvoyées que dans la réponse. Vous ne pouvez pas utiliser les valeurs de la table B comme filtre.
includePureServiceAreaBusinesses

Si la valeur est true, la réponse inclut les établissements qui se rendent chez les clients ou les livrent directement, mais qui ne disposent pas de locaux physiques. Si la valeur est false, l'API ne renvoie que les établissements disposant d'un établissement physique.
languageCode

Langue dans laquelle les résultats doivent être renvoyés.
- Consultez la liste des langues acceptées. Google met souvent à jour les langues acceptées. Cette liste n'est donc pas exhaustive.
- Si languageCode n'est pas fourni, la valeur par défaut de l'API est en. Si vous spécifiez un code de langue non valide, l'API renvoie une erreur INVALID_ARGUMENT.
- L'API met tout en œuvre pour fournir une adresse postale lisible à la fois pour l'utilisateur et les locaux. Pour ce faire, il renvoie les adresses dans la langue locale, translitérées dans un script lisible par l'utilisateur si nécessaire, en respectant la langue préférée. Toutes les autres adresses sont renvoyées dans la langue préférée. Les composants d'adresse sont tous renvoyés dans la même langue, qui est choisie à partir du premier composant.
- Si un nom n'est pas disponible dans la langue de votre choix, l'API utilise la correspondance la plus proche.
- La langue préférée a une faible influence sur l'ensemble des résultats que l'API choisit de renvoyer et sur l'ordre dans lequel ils sont renvoyés. Le géocodeur interprète les abréviations différemment selon la langue, par exemple les abréviations des types de rues ou les synonymes pouvant être valides dans une langue, mais pas dans une autre.
locationBias

Spécifie une zone à rechercher. Cet emplacement sert de biais, ce qui signifie que des résultats autour de l'emplacement spécifié peuvent être renvoyés, y compris en dehors de la zone spécifiée.

Vous pouvez spécifier locationRestriction ou locationBias, mais pas les deux. Considérez locationRestriction comme spécifiant la région dans laquelle les résultats doivent se trouver, et locationBias comme spécifiant la région dans laquelle les résultats se trouveront probablement ou à proximité, mais qui peut se trouver en dehors de la zone.

Remarque : Si vous omettez à la fois locationBias et locationRestriction, l'API utilise le biaisage IP par défaut. Avec le biaisage IP, l'API utilise l'adresse IP de l'appareil pour biaiser les résultats.

Remarque : Le paramètre locationBias peut être remplacé si textQuery contient un emplacement explicite tel que Market in Barcelona. Dans ce cas, locationBias est ignoré.

Spécifiez la région sous la forme d'une fenêtre d'affichage rectangulaire ou d'un cercle.
- Un cercle est défini par un point central et un rayon en mètres. Le rayon doit être compris entre 0,0 et 50 000,0 (inclus). Le rayon par défaut est de 0,0. Exemple :
```
"locationBias": {
  "circle": {
    "center": {
      "latitude": 37.7937,
      "longitude": -122.3965
    },
    "radius": 500.0
  }
}
```
- Un rectangle est une fenêtre d'affichage de latitude-longitude, représentée par deux points bas et hauts diamétralement opposés. Le point bas marque le coin sud-ouest du rectangle, et le point haut représente le coin nord-est du rectangle.
  
  Une fenêtre d'affichage est considérée comme une région fermée, ce qui signifie qu'elle inclut sa limite. Les limites de latitude doivent être comprises entre -90 et 90 degrés, et les limites de longitude entre -180 et 180 degrés, inclus:
  - Si low = high, la fenêtre d'affichage se compose de ce seul point.
  - Si low.longitude > high.longitude, la plage de longitude est inversée (la fenêtre d'affichage croise la ligne de longitude de 180 degrés).
  - Si low.longitude = -180 degrés et high.longitude = 180 degrés, la fenêtre d'affichage inclut toutes les longitudes.
  - Si low.longitude est défini sur 180 degrés et high.longitude sur -180 degrés, la plage de longitude est vide.
  - Si low.latitude > high.latitude, la plage de latitude est vide.
  Les valeurs basse et haute doivent être renseignées, et la zone représentée ne doit pas être vide. Un viewport vide génère une erreur.
  
  Par exemple, cette vue d'ensemble englobe entièrement la ville de New York:
```
"locationBias": {
  "rectangle": {
    "low": {
      "latitude": 40.477398,
      "longitude": -74.259087
    },
    "high": {
      "latitude": 40.91618,
      "longitude": -73.70018
    }
  }
}
```
locationRestriction

Spécifie une zone à rechercher. Les résultats en dehors de la zone spécifiée ne sont pas renvoyés.

Spécifiez la région en tant que fenêtre d'affichage rectangulaire. Pour obtenir un exemple de définition du Viewport, consultez la description de locationBias.

Vous pouvez spécifier locationRestriction ou locationBias, mais pas les deux. Considérez locationRestriction comme spécifiant la région dans laquelle les résultats doivent se trouver, et locationBias comme spécifiant la région dans laquelle les résultats se trouveront probablement ou à proximité, mais qui peut se trouver en dehors de cette zone.

Remarque : Si vous omettez à la fois locationBias et locationRestriction, l'API utilise le biaisage IP par défaut. Avec le biaisage IP, l'API utilise l'adresse IP de l'appareil pour biaiser les résultats.
maxResultCount (obsolète)

Obsolète:ce champ est obsolète et a été remplacé par pageSize. Si les valeurs maxResultCount et pageSize sont spécifiées, pageSize est utilisée et maxResultCount est ignorée.

Spécifie le nombre de résultats (entre 1 et 20) à afficher par page. Par exemple, si vous définissez la valeur maxResultCount sur 5, vous obtiendrez jusqu'à cinq résultats sur la première page. Si d'autres résultats peuvent être renvoyés à partir de la requête, la réponse inclut un nextPageToken que vous pouvez transmettre à une requête ultérieure pour accéder à la page suivante.

Remarque:Si maxResultCount est défini sur 0 ou n'est pas spécifié, l'API renvoie 20 résultats par page par défaut. Si maxResultCount est supérieur à 20, l'API ne renvoie pas plus de 20 résultats par page.
evOptions

Spécifie les paramètres permettant d'identifier les connecteurs de recharge et les tarifs de recharge pour les véhicules électriques (VE) disponibles.
- connectorTypes
  
  Filtre par type de connecteur de recharge de VE disponible à un emplacement. Un lieu qui n'est compatible avec aucun des types de connecteurs sera filtré. Les types de connecteurs de recharge de VE compatibles incluent les chargeurs combinés (AC et DC), les chargeurs Tesla, les chargeurs conformes à la norme GB/T (pour la recharge rapide des VE en Chine) et les chargeurs sur prise murale. Pour en savoir plus, consultez la documentation de référence.
- minimumChargingRateKw
  
  Filtre les lieux en fonction du débit de recharge minimal pour les véhicules électriques en kilowatts (kW). Les lieux qui facturent un tarif inférieur au tarif minimal sont filtrés. Par exemple, pour trouver des bornes de recharge de VE avec des débits de recharge d'au moins 10 kW, vous pouvez définir ce paramètre sur "10".
minRating

Limite les résultats à ceux dont la note moyenne est supérieure ou égale à cette limite. Les valeurs doivent être comprises entre 0,0 et 5,0 (inclus) par incréments de 0,5. Par exemple: 0, 0,5, 1,0, etc., jusqu'à 5,0 inclus. Les valeurs sont arrondies à la décimale (0,5) la plus proche. Par exemple, une valeur de 0,6 élimine tous les résultats dont la note est inférieure à 1,0.
openNow

Si la valeur est true, seules les entreprises ouvertes au moment de l'envoi de la requête sont renvoyées. Si la valeur est false, tous les établissements sont renvoyés, quel que soit leur état d'ouverture. Si vous définissez ce paramètre sur false, les lieux qui ne précisent pas d'horaires d'ouverture dans la base de données Google Places sont renvoyés.
pageSize

Spécifie le nombre de résultats (entre 1 et 20) à afficher par page. Par exemple, si vous définissez la valeur pageSize sur 5, vous obtiendrez jusqu'à cinq résultats sur la première page. Si d'autres résultats peuvent être renvoyés à partir de la requête, la réponse inclut un nextPageToken que vous pouvez transmettre à une requête ultérieure pour accéder à la page suivante.

Remarque:Si pageSize est défini sur 0 ou n'est pas spécifié, l'API renvoie 20 résultats par page par défaut. Si pageSize est supérieur à 20, l'API ne renvoie pas plus de 20 résultats par page.
pageToken

Spécifie le nextPageToken à partir du corps de la réponse de la page précédente.
priceLevels

Limiter la recherche aux lieux qui sont marqués à certains niveaux de prix Par défaut, tous les niveaux de prix sont sélectionnés.

Spécifiez un tableau d'une ou de plusieurs valeurs définies par PriceLevel.

Remarque : PRICE_LEVEL_FREE n'est pas autorisé dans une requête. Il n'est utilisé que pour renseigner la réponse.

Exemple :
```
"priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
```
rankPreference

Spécifie le classement des résultats dans la réponse en fonction du type de requête:
- Pour une requête par catégorie telle que "Restaurants à New York", RELEVANCE (classement des résultats en fonction de la pertinence de la recherche) est défini par défaut. Vous pouvez définir rankPreference sur RELEVANCE ou DISTANCE (classer les résultats par distance).
- Pour une requête non catégorique telle que "Mountain View, CA", nous vous recommandons de ne pas définir rankPreference.
regionCode

Code de région utilisé pour mettre en forme la réponse, spécifié sous la forme d'une valeur de code CLDR à deux caractères. Ce paramètre peut également avoir un effet biaisé sur les résultats de recherche. Il n'existe pas de valeur par défaut.

Si le nom du pays du champ formattedAddress de la réponse correspond à regionCode, le code pays est omis de formattedAddress. Ce paramètre n'a aucun effet sur adrFormatAddress, qui inclut toujours le nom du pays lorsqu'il est disponible, ni sur shortFormattedAddress, qui ne l'inclut jamais.

La plupart des codes CLDR sont identiques aux codes ISO 3166-1, à quelques exceptions près. Par exemple, le ccTLD du Royaume-Uni est "uk" (.co.uk), tandis que son code ISO 3166-1 est "gb" (techniquement pour l'entité "Royaume-Uni de Grande-Bretagne et d'Irlande du Nord"). Le paramètre peut avoir une incidence sur les résultats en fonction de la législation applicable.
strictTypeFiltering

Utilisé avec le paramètre includedType. Lorsque la valeur est true, seuls les lieux correspondant aux types spécifiés par includeType sont renvoyés. Lorsque la valeur est "false" (par défaut), la réponse peut contenir des lieux qui ne correspondent pas aux types spécifiés.

Exemples de recherche textuelle

Trouver un lieu par chaîne de requête

L'exemple suivant montre une requête de recherche de texte pour "Nourriture végétarienne épicée à Sydney, Australie":

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'

Notez que l'en-tête X-Goog-FieldMask spécifie que la réponse contient les champs de données suivants: places.displayName,places.formattedAddress. La réponse est alors sous la forme:

{
  "places": [
    {
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia",
      "displayName": {
        "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "29 King St, Sydney NSW 2000, Australia",
      "displayName": {
        "text": "Peace Harmony",
        "languageCode": "en"
      }
    },
    ...
  ]
}

Ajoutez d'autres types de données au masque de champ pour renvoyer des informations supplémentaires. Par exemple, ajoutez places.types,places.websiteUri pour inclure le type de restaurant et l'adresse Web dans la réponse:

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,places.types,places.websiteUri' \
'https://places.googleapis.com/v1/places:searchText'

La réponse est maintenant sous la forme:

{
  "places": [
    {
      "types": [
        "vegetarian_restaurant",
        "vegan_restaurant",
        "chinese_restaurant",
        "restaurant",
        "food",
        "point_of_interest",
        "establishment"
      ],
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "websiteUri": "http://www.motherchusvegetarian.com.au/",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    {
      "types": [
        "vegan_restaurant",
        "thai_restaurant",
        "vegetarian_restaurant",
        "indian_restaurant",
        "italian_restaurant",
        "american_restaurant",
        "restaurant",
        "food",
        "point_of_interest",
        "establishment"
      ],
      "formattedAddress": "175 First Ave, Five Dock NSW 2046, Australia",
      "websiteUri": "http://www.veggosizzle.com.au/",
      "displayName": {
        "text": "Veggo Sizzle - Vegan & Vegetarian Restaurant, Five Dock, Sydney",
        "languageCode": "en"
      }
    },
    ...
  ]
}

Filtrer les lieux par niveau de prix

Utilisez l'option priceLevel pour filtrer les résultats sur les restaurants définis comme peu chers ou modérément chers:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia",
  "priceLevels":["PRICE_LEVEL_INEXPENSIVE", "PRICE_LEVEL_MODERATE"]
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel' \
'https://places.googleapis.com/v1/places:searchText'

Cet exemple utilise également l'en-tête X-Goog-FieldMask pour ajouter le champ de données places.priceLevel à la réponse. Il se présente donc sous la forme suivante:

{
  "places": [
    {
      "formattedAddress": "367 Pitt St, Sydney NSW 2000, Australia",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Mother Chu's Vegetarian Kitchen",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "115 King St, Newtown NSW 2042, Australia",
      "priceLevel": "PRICE_LEVEL_MODERATE",
      "displayName": {
        "text": "Green Mushroom",
        "languageCode": "en"
      }
    },
    ...
  ]
}

Ajoutez des options supplémentaires pour affiner votre recherche, comme includedType, minRating, rankPreference, openNow et d'autres paramètres décrits dans la section Paramètres facultatifs.

Limiter la recherche à une zone spécifique

Utilisez locationRestriction ou locationBias, mais pas les deux, pour limiter une recherche à une zone. Considérez locationRestriction comme spécifiant la région dans laquelle les résultats doivent se trouver, et locationBias comme spécifiant la région à proximité de laquelle les résultats doivent se trouver, mais qui peut être en dehors de la zone.

Remarque : Lorsque vous utilisez locationRestriction, vous ne pouvez spécifier la région que sous la forme d'un Vue-port rectangulaire. Lorsque vous utilisez locationBias, vous pouvez spécifier la région en tant que vue d'affichage rectangulaire ou en tant que cercle.

Limiter la zone à l'aide de locationRestriction

Utilisez le paramètre locationRestriction pour limiter les résultats de la requête à une région spécifiée. Dans le corps de votre requête, spécifiez les valeurs de latitude et de longitude low et high qui définissent la limite de la région.

L'exemple suivant montre une requête de recherche de texte pour "nourriture végétarienne" à New York. Cette requête ne renvoie que les 10 premiers résultats pour les lieux ouverts.

curl -X POST -d '{
  "textQuery" : "vegetarian food",
  "pageSize" : "10",
  "locationRestriction": {
    "rectangle": {
      "low": {
        "latitude": 40.477398,
        "longitude": -74.259087
      },
      "high": {
        "latitude": 40.91618,
        "longitude": -73.70018
      }
    }
  }
}' \
  -H 'Content-Type: application/json' \
  -H 'X-Goog-Api-Key: API_KEY' \
  -H 'X-Goog-FieldMask: places.id,places.formattedAddress' \
  'https://places.googleapis.com/v1/places:searchText'

Pondérer une zone à l'aide de locationBias

L'exemple suivant montre une requête de recherche textuelle pour "nourriture végétarienne" avec un biais vers un établissement situé à moins de 500 mètres d'un point du centre-ville de San Francisco. Cette requête ne renvoie que les 10 premiers résultats pour les lieux ouverts.

curl -X POST -d '{
  "textQuery" : "vegetarian food",
  "openNow": true,
  "pageSize": 10,
  "locationBias": {
    "circle": {
      "center": {"latitude": 37.7937, "longitude": -122.3965},
      "radius": 500.0
    }
  },
}' \
-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'

Rechercher des bornes de recharge de VE avec un tarif de recharge minimal

Utilisez minimumChargingRateKw et connectorTypes pour rechercher des lieux où des chargeurs compatibles avec votre VE sont disponibles.

L'exemple suivant montre une requête de connecteurs de recharge de VE Tesla et J1772 de type 1 avec un débit de recharge minimal de 10 kW à Mountain View (Californie). Seuls quatre résultats sont renvoyés.

curl -X POST -d '{
    "textQuery": "EV Charging Station Mountain View",
    "pageSize": 4,
    "evOptions": {
      "minimumChargingRateKw": 10,
      "connectorTypes": ["EV_CONNECTOR_TYPE_J1772","EV_CONNECTOR_TYPE_TESLA"]
    }
  }' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H "X-Goog-FieldMask: places.displayName,places.evChargeOptions" \
'https://places.googleapis.com/v1/places:searchText'

La requête renvoie la réponse suivante:

{
  "places": [
    {
      "displayName": {
        "text": "EVgo Charging Station",
        "languageCode": "en"
      },
      "evChargeOptions": {
        "connectorCount": 16,
        "connectorAggregation": [
          {
            "type": "EV_CONNECTOR_TYPE_CHADEMO",
            "maxChargeRateKw": 100,
            "count": 8,
            "availableCount": 5,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 100,
            "count": 2,
            "availableCount": 2,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 350,
            "count": 6,
            "availableCount": 3,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          }
        ]
      }
    },
    {
      "displayName": {
        "text": "EVgo Charging Station",
        "languageCode": "en"
      },
      "evChargeOptions": {
        "connectorCount": 6,
        "connectorAggregation": [
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 100,
            "count": 4,
            "availableCount": 3,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 350,
            "count": 2,
            "availableCount": 0,
            "outOfServiceCount": 2,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          }
        ]
      }
    },
    {
      "displayName": {
        "text": "EVgo Charging Station",
        "languageCode": "en"
      },
      "evChargeOptions": {
        "connectorCount": 5,
        "connectorAggregation": [
          {
            "type": "EV_CONNECTOR_TYPE_J1772",
            "maxChargeRateKw": 3.5999999046325684,
            "count": 1,
            "availableCount": 0,
            "outOfServiceCount": 1,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CHADEMO",
            "maxChargeRateKw": 50,
            "count": 2,
            "availableCount": 0,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          },
          {
            "type": "EV_CONNECTOR_TYPE_CCS_COMBO_1",
            "maxChargeRateKw": 50,
            "count": 2,
            "availableCount": 0,
            "outOfServiceCount": 0,
            "availabilityLastUpdateTime": "2024-01-10T19:10:00Z"
          }
        ]
      }
    },
    {
      "displayName": {
        "text": "Electric Vehicle Charging Station",
        "languageCode": "en"
      },
      "evChargeOptions": {
        "connectorCount": 10,
        "connectorAggregation": [
          {
            "type": "EV_CONNECTOR_TYPE_OTHER",
            "maxChargeRateKw": 210,
            "count": 10
          }
        ]
      }
    }
  ]
}

Rechercher des établissements de services de proximité à domicile

Utilisez le paramètre includePureServiceAreaBusinesses pour rechercher des établissements sans adresse de service physique (par exemple, un service de nettoyage mobile ou un camion de restauration).

L'exemple suivant montre une requête pour des plombiers à San Francisco:

curl -X POST -d '{
  "textQuery" : "plumber San Francisco",
  "includePureServiceAreaBusinesses": true
}' \
-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'

Dans la réponse, les établissements sans adresse physique ne doivent pas inclure le champ formattedAddress:

{
  "places": [
    {
      "formattedAddress": "3450 Sacramento St #204, San Francisco, CA 94118, USA",
      "displayName": {
        "text": "Advanced Plumbing & Drain",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "1455 Bancroft Ave, San Francisco, CA 94124, USA",
      "displayName": {
        "text": "Magic Plumbing Heating & Cooling",
        "languageCode": "en"
      }
    },
    /.../
    {
      "displayName": {
        "text": "Starboy Plumbing Inc.",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "78 Dorman Ave, San Francisco, CA 94124, USA",
      "displayName": {
        "text": "Cabrillo Plumbing, Heating & Air",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "540 Barneveld Ave # D, San Francisco, CA 94124, USA",
      "displayName": {
        "text": "Mr. Rooter Plumbing of San Francisco",
        "languageCode": "en"
      }
    },
    /.../
    {
      "displayName": {
        "text": "Pipeline Plumbing",
        "languageCode": "en"
      }
    },
    {
      "formattedAddress": "350 Bay St #100-178, San Francisco, CA 94133, USA",
      "displayName": {
        "text": "One Source Plumbing and Rooter",
        "languageCode": "en"
      }
    },
    /.../
  ]
}

Spécifier le nombre de résultats à renvoyer par page

Utilisez le paramètre pageSize pour spécifier le nombre de résultats à renvoyer par page. Le paramètre nextPageToken dans le corps de la réponse fournit un jeton qui peut être utilisé dans les appels suivants pour accéder à la page de résultats suivante.

L'exemple suivant montre une requête pour "pizza à New York" limitée à cinq résultats par page:

 curl -X POST -d '{
  "textQuery": "pizza in New York",
  "pageSize": 5
  }' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H "X-Goog-FieldMask: places.id,nextPageToken" \
'https://places.googleapis.com/v1/places:searchText'

{
  "places": [
    {
      "id": "ChIJifIePKtZwokRVZ-UdRGkZzs"
    },
    {
      "id": "ChIJPxPd_P1YwokRfzLhSiACEoU"
    },
    {
      "id": "ChIJrXXKn5NZwokR78g0ipCnY60"
    },
    {
      "id": "ChIJ6ySICVZYwokR9rIK8HjXhzE"
    },
    {
      "id": "ChIJ6xvs94VZwokRnT1D2lX2OTw"
    }
  ],
  "nextPageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q"
}

Pour accéder à la page de résultats suivante, utilisez pageToken pour transmettre le nextPageToken dans le corps de la requête:

 curl -X POST -d '{
  "textQuery": "pizza in New York",
  "pageSize": 5,
  "pageToken": "AeCrKXsZWzNVbPzO-MRWPu52jWO_Xx8aKwOQ69_Je3DxRpfdjClq8Ekwh3UcF2h2Jn75kL6PtWLGV4ecQri-GEUKN_OFpJkdVc-JL4Q"
  }' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H "X-Goog-FieldMask: places.id,nextPageToken" \
'https://places.googleapis.com/v1/places:searchText'

{
  "places": [
    {
      "id": "ChIJL-LN1N1ZwokR8K2jACu6Ydw"
    },
    {
      "id": "ChIJjaD94kFZwokR-20CXqlpy_4"
    },
    {
      "id": "ChIJ6ffdpJNZwokRmcafdROM5q0"
    },
    {
      "id": "ChIJ8Q2WSpJZwokRQz-bYYgEskM"
    },
    {
      "id": "ChIJ8164qwFZwokRhplkmhvq1uE"
    }
  ],
  "nextPageToken": "AeCrKXvPd6uUy-oj96W2OaqEe2pUD8QTxOM8-sKfUcFsC9t2Wey5qivrKGoGSxcZnyc7RPmaFfAktslrKbUh31ZDTkL0upRmaxA7c_c"
}

Essayer

API Explorer vous permet d'envoyer des exemples de requêtes afin de vous familiariser avec l'API et ses options.

Sélectionnez l'icône API sur le côté droit de la page.
Vous pouvez également développer Afficher les paramètres standards et définir le paramètre fields sur le masque de champ.
Modifiez éventuellement le corps de la requête.
Sélectionnez le bouton Execute (Exécuter). Dans la boîte de dialogue pop-up, sélectionnez le compte que vous souhaitez utiliser pour effectuer la demande.
Dans le panneau API Explorer, sélectionnez l'icône de développement, , pour développer la fenêtre API Explorer.

Text Search (nouvelle version)

Requêtes Text Search

Réponses Text Search (nouvelle version)

Paramètres obligatoires

FieldMask

textQuery

Paramètres facultatifs

includedType

includePureServiceAreaBusinesses

languageCode

locationBias

locationRestriction

maxResultCount (obsolète)

evOptions

connectorTypes

minimumChargingRateKw

minRating

openNow

pageSize

pageToken

priceLevels

rankPreference

regionCode

strictTypeFiltering

Exemples de recherche textuelle

Trouver un lieu par chaîne de requête

Filtrer les lieux par niveau de prix

Limiter la recherche à une zone spécifique

Limiter la zone à l'aide de locationRestriction

Pondérer une zone à l'aide de locationBias

Rechercher des bornes de recharge de VE avec un tarif de recharge minimal

Rechercher des établissements de services de proximité à domicile

Spécifier le nombre de résultats à renvoyer par page

Essayer