Ce produit ou cette fonctionnalité est obsolète. Pour en savoir plus sur l'état "Ancien", consultez la section Anciens produits et fonctionnalités. Pour migrer vers l'API Places (nouvelle), consultez le guide de migration.

Find Place (ancienne version)

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

Remarque : Bibliothèques côté serveur et côté client

L'API Places est également disponible avec les clients Java, Python, Go et Node.js pour les services Google Maps. L'API Places et les bibliothèques clientes sont destinées à être utilisées dans des applications serveur.

Si vous développez une application côté client, consultez le SDK Places pour Android (nouveau), le SDK Places pour iOS (nouveau) et la bibliothèque Places de l'API Maps JavaScript.

Une requête Find Place (ancienne version) prend une entrée textuelle et renvoie un lieu. Il peut s'agir de n'importe quel type de données textuelles Places, comme un nom, une adresse ou un numéro de téléphone. La requête doit être une chaîne. Une requête Find Place (ancienne version) utilisant des données non string, telles que des coordonnées de latitude/longitude ou un plus code, génère une erreur.

Une requête Find Place (Legacy) renvoie un sous-ensemble des champs renvoyés par une requête Place Details (Legacy). Pour en savoir plus sur les champs qui ne sont pas disponibles dans une requête Find Place (Legacy), consultez Compatibilité des champs de l'API Places. Si le champ souhaité n'est pas renvoyé, vous pouvez utiliser Find Place (ancienne version) pour obtenir un place_id, puis utiliser cet ID pour effectuer une requête Place Details (ancienne version).

Requêtes Find Place (ancienne version)

Une requête Find Place (ancienne version) est une URL HTTP au format suivant :

https://maps.googleapis.com/maps/api/place/findplacefromtext/output?parameters

où output peut avoir l'une des valeurs suivantes :

json (recommandé) indique la sortie au format JSON (JavaScript Object Notation).
xml indique que la sortie est au format XML.

Certains paramètres sont requis pour lancer une requête Find Place (ancienne version). Comme c'est la norme pour les URL, les différents paramètres sont séparés par une esperluette (&).

Paramètres obligatoires

entrée

Chaîne de texte sur laquelle doit porter la recherche, par exemple "restaurant" ou "123 Main Street". Il doit s'agir d'un nom de lieu, d'une adresse ou d'une catégorie d'établissements. Tout autre type d'entrée peut générer des erreurs, et ne renverra peut-être pas de résultats valides. L'API Places renvoie les résultats correspondant à cette chaîne et les classe en fonction de leur pertinence estimée.
inputtype

Type d'entrée. Il peut s'agir de textquery ou de phonenumber. Les numéros de téléphone doivent être au format international, c'est-à-dire précédés du signe plus ("+"), suivi du code pays, puis du numéro de téléphone. Pour en savoir plus, consultez la Recommandation UIT-T E.164.

Paramètres facultatifs

champs

Attention : Les requêtes Place Search et Place Details ne renvoient pas les mêmes champs. Les requêtes Place Search renvoient un sous-ensemble des champs renvoyés par les requêtes Place Details. Si le champ souhaité n'est pas renvoyé par Place Search, vous pouvez l'utiliser pour obtenir un place_id, puis utiliser l'ID de lieu pour effectuer une requête Place Details. Pour en savoir plus sur les champs qui ne sont pas disponibles dans une requête Place Search, consultez Compatibilité des champs de l'API Places.

Utilisez le paramètre "fields" pour spécifier une liste de types de données de lieu à renvoyer, séparés par une virgule. Par exemple : fields=formatted_address,name,geometry. Utilisez une barre oblique lorsque vous spécifiez des valeurs composées. Par exemple : opening_hours/open_now.

Les champs sont divisés en trois catégories de facturation : Basic, Contact et Atmosphere. Les champs Basic sont facturés au tarif de base, tandis que les champs Contact et Ambiance sont facturés à un tarif plus élevé. Les SKU Basic, Contact et Atmosphere sont facturés en plus du SKU de base (Places Details, Find Place, Nearby Search ou Text Search) pour la requête qui les a déclenchés. Pour en savoir plus, consultez la fiche tarifaire.

Basic

La catégorie "Basic" comprend les champs suivants : address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color, name, permanently_closed (obsolète), photo, place_id, plus_code, type, url, utc_offset, vicinity, wheelchair_accessible_entrance.

Contact

La catégorie "Contact" comprend les champs suivants : current_opening_hours, formatted_phone_number, international_phone_number, opening_hours, secondary_opening_hours, website

Ambiance

La catégorie "Ambiance" comprend les champs suivants : curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout, user_ratings_total.

Remarque : Les attributions, html_attributions, sont toujours renvoyées avec chaque appel, que le champ ait été demandé ou non.
language

Langue dans laquelle renvoyer les résultats.
- Consultez la liste des langues disponibles. Google met souvent à jour les langues acceptées. Cette liste n'est donc pas exhaustive.
- Si language n'est pas fourni, l'API tente d'utiliser la langue préférée spécifiée dans l'en-tête Accept-Language.
- L'API met tout en œuvre pour fournir une adresse postale lisible à la fois pour l'utilisateur et les habitants. Pour ce faire, il renvoie les adresses postales dans la langue locale, translitté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 de préférence. 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éocoder interprète les abréviations différemment selon la langue, par exemple les abréviations des types de rues ou les synonymes qui peuvent être valides dans une langue, mais pas dans une autre. Par exemple, utca et tér sont des synonymes de "rue" en hongrois.
locationbias

Préférez les résultats dans une zone spécifiée, en indiquant un rayon plus une latitude/longitude, ou deux paires de latitude/longitude représentant les points d'un rectangle. Si ce paramètre n'est pas spécifié, l'API utilise le biais d'adresse IP par défaut.
- IP bias (Biais d'adresse IP) : indique à l'API d'utiliser le biais d'adresse IP. Transmettez la chaîne ipbias (cette option ne comporte aucun paramètre supplémentaire).
- Circulaire : chaîne spécifiant le rayon en mètres, ainsi que la latitude/longitude en degrés décimaux. Utilisez le format suivant : circle:radius@lat,lng.
- Rectangulaire : chaîne spécifiant deux paires de latitude/longitude en degrés décimaux, représentant les points sud/ouest et nord/est d'un rectangle. Utilisez le format suivant : rectangle:south,west|north,east. Notez que les valeurs est/ouest sont comprises entre -180 et 180, et que les valeurs nord/sud sont comprises entre -90 et 90.

Remarque : Si vous omettez le paramètre fields d'une requête Find Place (Legacy), seul le place_id du résultat sera renvoyé.

Exemples de Find Place (ancienne version)

L'exemple suivant illustre une requête Find Place (ancienne version) pour "Museum of Contemporary Art Australia", incluant les champs photos, formatted_address, name, rating, opening_hours et geometry :

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

L'exemple suivant montre une requête Find Place (Legacy) pour "Mongolian Grill", utilisant le paramètre locationbias pour privilégier les résultats situés à moins de 2 000 mètres des coordonnées spécifiées :

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

L'exemple suivant montre une requête Find Place (ancienne version) pour un numéro de téléphone. Notez que le préfixe d'appel international "+" a été encodé en %2B afin que cette requête soit une URL conforme. Si le préfixe + n'est pas encodé, il sera décodé en espace sur le serveur, ce qui entraînera une recherche de numéro de téléphone non valide.

curl

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

Réponses Find Place (ancienne version)

Une réponse Find Place (ancienne version) ne contient que les types de données spécifiés à l'aide du paramètre fields, plus html_attributions. L'exemple suivant illustre la réponse à une requête Find Place (ancienne version) pour "Museum of Contemporary Art Australia", incluant les champs formatted_address, geometry, name, opening_hours, photos et rating.

JSON

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

PlacesFindPlaceFromTextResponse

Champ	Obligatoire	Type	Description
`candidates`	required	Array<Place>	Contient un tableau de suggestions de lieux. Les requêtes Place Search renvoient un sous-ensemble des champs renvoyés par les requêtes Place Details. Si le champ souhaité n'est pas renvoyé par Place Search, vous pouvez l'utiliser pour obtenir un place_id, puis utiliser l'ID de lieu pour effectuer une requête Place Details. Pour en savoir plus, consultez Place.
`status`	required	PlacesSearchStatus	Contient l'état de la requête et éventuellement des informations de débogage qui vous aident à savoir pourquoi la requête a échoué. Pour en savoir plus, consultez PlacesSearchStatus.
`error_message`	facultatif	chaîne	Lorsque le service renvoie un code d'état autre que `OK<`, un champ `error_message` supplémentaire peut figurer dans l'objet de réponse. Ce champ contient des informations plus détaillées sur les raisons du code d'état indiqué. Ce champ n'est pas toujours renvoyé et son contenu est susceptible d'être modifié.
`info_messages`	facultatif	Array<string>	Lorsque le service renvoie des informations supplémentaires sur la spécification de la requête, un champ `info_messages` supplémentaire peut figurer dans l'objet de réponse. Ce champ n'est renvoyé que pour les requêtes ayant abouti. Il n'est pas toujours renvoyé et son contenu est susceptible d'être modifié.

PlacesSearchStatus

Codes d'état renvoyés par le service.

OK, qui indique que la requête API a abouti.
ZERO_RESULTS indiquant que la recherche a abouti, mais n'a renvoyé aucun résultat. Cela peut se produire si la recherche a reçu un latlng dans un emplacement distant.
INVALID_REQUEST, qui indique que la requête API était mal formée, généralement en raison d'un paramètre de requête obligatoire manquant (location ou radius).
OVER_QUERY_LIMIT indiquant l'un des éléments suivants :
- Vous avez dépassé les limites de RPS.
- La facturation n'a pas été activée pour votre compte.
- Le crédit mensuel de 200 $ou la limite d'utilisation que vous avez définie vous-même ont été dépassés.
- Le mode de facturation fourni n'est plus valide (une carte de crédit est arrivée à expiration, par exemple).
Pour savoir comment résoudre cette erreur, consultez les questions fréquentes sur Maps.
REQUEST_DENIED, qui indique que votre demande a été refusée, généralement parce que :
- La requête ne contient pas de clé API.
- Le paramètre key n'est pas valide.
UNKNOWN_ERROR, qui indique une erreur inconnue.

Lieu

Attributs décrivant un lieu. Tous les attributs ne seront pas disponibles pour tous les types de lieux.

Champ	Obligatoire	Type	Description
`address_components`	facultatif	Array<`AddressComponent`>	Tableau contenant les composants distincts applicables à cette adresse. Pour en savoir plus, consultez `AddressComponent`.
`adr_address`	facultatif	chaîne	Représentation de l'adresse du lieu dans le microformat adr.
`business_status`	facultatif	chaîne	Indique l'état opérationnel du lieu (s'il s'agit d'une entreprise). Si aucune donnée n'existe, `business_status` n'est pas renvoyé. The allowed values include: `OPERATIONAL`, `CLOSED_TEMPORARILY`, and `CLOSED_PERMANENTLY`
`curbside_pickup`	facultatif	booléen	Indique si l'établissement propose le retrait en voiture.
`current_opening_hours`	facultatif	PlaceOpeningHours	Contient les horaires d'ouverture pour les sept prochains jours (y compris aujourd'hui). La période commence à minuit à la date de la demande et se termine à 23h59 six jours plus tard. Ce champ inclut le sous-champ `special_days` de toutes les heures, défini pour les dates qui ont des horaires exceptionnels. Pour en savoir plus, consultez PlaceOpeningHours.
`delivery`	facultatif	booléen	Indique si l'établissement propose la livraison.
`dine_in`	facultatif	booléen	Indique si l'établissement propose des places assises à l'intérieur ou à l'extérieur.
`editorial_summary`	facultatif	PlaceEditorialSummary	Contient un résumé du lieu. Un résumé se compose d'une présentation textuelle et inclut également le code de langue, le cas échéant. Le texte récapitulatif doit être présenté tel quel et ne peut pas être modifié. Pour en savoir plus, consultez PlaceEditorialSummary.
`formatted_address`	facultatif	chaîne	Chaîne contenant l'adresse lisible de ce lieu. Bien souvent, cette adresse équivaut à l'adresse postale. Notez que certains pays, comme le Royaume-Uni, n'autorisent pas la distribution des vraies adresses postales en raison de restrictions de licence. L'adresse formatée est composée d'un ou de plusieurs composants d'adresse logiques. Par exemple, l'adresse "111 8th Avenue, New York, NY" comprend les éléments suivants : "111" (le numéro de rue), "8th Avenue" (la route), "New York" (la ville) et "NY" (l'État américain). N'analysez pas l'adresse formatée de manière programmatique. Utilisez plutôt les composants d'adresse individuels, que la réponse de l'API inclut en plus du champ d'adresse formaté.
`formatted_phone_number`	facultatif	chaîne	Contient le numéro de téléphone du lieu dans son format local.
`geometry`	facultatif	`Geometry`	Contient l'emplacement et la fenêtre d'affichage de l'emplacement. Pour en savoir plus, consultez `Geometry`.
`icon`	facultatif	chaîne	Contient l'URL d'une icône suggérée qui peut être affichée à l'utilisateur lorsqu'il indique ce résultat sur une carte.
`icon_background_color`	facultatif	chaîne	Contient le code couleur HEX par défaut pour la catégorie du lieu.
`icon_mask_base_uri`	facultatif	chaîne	Contient l'URL d'une icône recommandée, moins l'extension du type de fichier `.svg` ou `.png`.
`international_phone_number`	facultatif	chaîne	Contient le numéro de téléphone du lieu au format international. Le format international inclut l'indicatif du pays, précédé du signe plus (+). Par exemple, le international_phone_number du bureau de Google à Sydney, en Australie, est `+61 2 9374 4000`.
`name`	facultatif	chaîne	Contient le nom lisible du résultat renvoyé. Pour les résultats `establishment`, il s'agit généralement du nom d'entreprise canonique.
`opening_hours`	facultatif	PlaceOpeningHours	Indique les horaires d'ouverture habituels. Pour en savoir plus, consultez PlaceOpeningHours.
`permanently_closed`	facultatif	booléen	`permanently_closed` est obsolète. Utilisez `business_status` pour obtenir l'état opérationnel des entreprises.
`photos`	facultatif	Array<PlacePhoto>	Tableau d'objets photo, chacun contenant une référence à une image. Une requête peut renvoyer jusqu'à 10 photos. Pour en savoir plus sur les photos de lieux et sur la façon dont vous pouvez utiliser les images dans votre application, consultez la documentation Place Photos. Pour en savoir plus, consultez PlacePhoto.
`place_id`	facultatif	chaîne	Identifiant textuel qui identifie un lieu de manière unique. Pour récupérer des informations sur le lieu, transmettez cet identifiant dans le champ `place_id` d'une requête de l'API Places. Pour en savoir plus sur les ID de lieu, consultez la présentation des ID de lieu.
`plus_code`	facultatif	`PlusCode`	Référence de lieu encodée, calculée à partir de coordonnées de latitude et de longitude, qui représente une zone : 1/8000e de degré par 1/8000e de degré (environ 14 m x 14 m à l'équateur) ou moins. Vous pouvez utiliser des Plus Codes pour remplacer les adresses postales dans les endroits où elles n'existent pas (où les bâtiments ne sont pas numérotés ni nommés). Consultez Open Location Code et Plus Codes. Pour en savoir plus, consultez `PlusCode`.
`price_level`	facultatif	nombre	Le niveau de prix du lieu, sur une échelle de 0 à 4. Le montant exact indiqué par une valeur spécifique varie d'une région à l'autre. Les niveaux de prix sont interprétés comme suit : 0 € 1 Bon marché 2 : modérée 3 - Cher 4 : Très cher
`rating`	facultatif	nombre	Contient la note du lieu, sur une échelle de 1,0 à 5,0, basée sur l'ensemble des avis des utilisateurs.
`reference`	facultatif	chaîne	`reference` est obsolète.
`reservable`	facultatif	booléen	Indique si le lieu accepte les réservations.
`reviews`	facultatif	Array<PlaceReview>	Tableau JSON comportant jusqu'à cinq avis. Par défaut, les avis sont triés par pertinence. Utilisez le paramètre de requête `reviews_sort` pour contrôler le tri. Pour `most_relevant` (par défaut), les avis sont triés par pertinence. Le service biaisera les résultats pour renvoyer les avis rédigés à l'origine dans la langue préférée. Pour `newest`, les avis sont triés par ordre chronologique. La langue préférée n'a aucune incidence sur l'ordre de tri. Google recommande d'indiquer aux utilisateurs si les résultats sont triés par `most_relevant` ou `newest`. Pour en savoir plus, consultez PlaceReview.
`scope`	facultatif	chaîne	`scope` est obsolète.
`secondary_opening_hours`	facultatif	Array<PlaceOpeningHours>	Contient un tableau d'entrées pour les sept prochains jours, y compris des informations sur les horaires secondaires d'un établissement. Les horaires secondaires sont différents des horaires principaux d'un établissement. Par exemple, un restaurant peut spécifier les horaires du drive ou de la livraison comme horaires secondaires. Ce champ remplit le sous-champ `type`, qui s'appuie sur une liste prédéfinie de types d'heures d'ouverture (tels que `DRIVE_THROUGH`, `PICKUP` ou `TAKEOUT`) en fonction des types de lieux. Ce champ inclut le sous-champ `special_days` de toutes les heures, défini pour les dates ayant des horaires exceptionnels. Pour en savoir plus, consultez PlaceOpeningHours.
`serves_beer`	facultatif	booléen	Indique si l'établissement sert de la bière.
`serves_breakfast`	facultatif	booléen	Indique si l'établissement sert le petit-déjeuner.
`serves_brunch`	facultatif	booléen	Indique si l'établissement sert des brunchs.
`serves_dinner`	facultatif	booléen	Indique si l'établissement sert à dîner.
`serves_lunch`	facultatif	booléen	Indique si le lieu sert le déjeuner.
`serves_vegetarian_food`	facultatif	booléen	Indique si l'établissement propose des plats végétariens.
`serves_wine`	facultatif	booléen	Indique si l'établissement sert du vin.
`takeout`	facultatif	booléen	Indique si l'établissement propose des plats à emporter.
`types`	facultatif	Array<string>	Contient un tableau de types d'entités décrivant le résultat donné. Consultez la liste des types compatibles.
`url`	facultatif	chaîne	Contient l'URL de la page Google officielle de ce lieu. Il s'agit de la page Google contenant les informations les plus pertinentes disponibles sur le lieu. Les applications doivent associer ou intégrer cette page à tout écran qui affiche des résultats détaillés sur le lieu à l'utilisateur.
`user_ratings_total`	facultatif	nombre	Nombre total d'avis (avec ou sans texte) pour ce lieu.
`utc_offset`	facultatif	nombre	Indique le décalage horaire actuel du lieu par rapport à UTC, exprimé en minutes. Par exemple, pour les lieux situés à Sydney, Australie, en heure d'été, ce paramètre est 660 (+11 heures par rapport à l'heure UTC). Pour les lieux situés en Californie, en heure d'hiver, ce paramètre est -480 (-8 heures par rapport à l'heure UTC).
`vicinity`	facultatif	chaîne	Pour les résultats d'établissement (`types:["establishment", ...])` uniquement), le champ `vicinity` contient une adresse simplifiée du lieu, comprenant la rue, le numéro et la ville, mais sans le département/la province, le code postal ou le pays. Pour tous les autres résultats, le champ `vicinity` contient le nom de la caractéristique politique (`types:["political", ...]`) la plus précise présente dans l'adresse du résultat. Ce contenu est destiné à être lu tel quel. N'analysez pas l'adresse formatée de manière programmatique.
`website`	facultatif	chaîne	Site Web faisant autorité pour ce lieu, comme la page d'accueil d'un établissement.
`wheelchair_accessible_entrance`	facultatif	booléen	Indique si le lieu dispose d'une entrée accessible en fauteuil roulant.

PlaceEditorialSummary

Contient un résumé du lieu. Un résumé se compose d'une présentation textuelle et inclut également le code de langue, le cas échéant. Le texte récapitulatif doit être présenté tel quel et ne peut pas être modifié.

Champ	Obligatoire	Type	Description
`language`	facultatif	chaîne	Langue des champs précédents. Il n'est pas toujours présent.
`overview`	facultatif	chaîne	Résumé textuel de longueur moyenne du lieu.

PlaceOpeningHours

Objet décrivant les horaires d'ouverture d'un lieu.

Champ	Obligatoire	Type	Description
`open_now`	facultatif	booléen	Valeur booléenne indiquant si l'établissement est ouvert à l'heure actuelle.
`periods`	facultatif	Array<PlaceOpeningHoursPeriod>	Tableau de périodes d'ouverture sur sept jours à partir du dimanche, dans l'ordre chronologique. Pour en savoir plus, consultez PlaceOpeningHoursPeriod.
`special_days`	facultatif	Array<PlaceSpecialDay>	Tableau contenant jusqu'à sept entrées correspondant aux sept prochains jours. Pour en savoir plus, consultez PlaceSpecialDay.
`type`	facultatif	chaîne	Chaîne de type utilisée pour identifier le type d'heures secondaires (par exemple, `DRIVE_THROUGH`, `HAPPY_HOUR`, `DELIVERY`, `TAKEOUT`, `KITCHEN`, `BREAKFAST`, `LUNCH`, `DINNER`, `BRUNCH`, `PICKUP`, `SENIOR_HOURS`). Définie pour `secondary_opening_hours` uniquement.
`weekday_text`	facultatif	Array<string>	Tableau de chaînes décrivant les horaires du lieu sous forme de texte lisible.

PlaceOpeningHoursPeriod

Champ	Obligatoire	Type	Description
`open`	required	PlaceOpeningHoursPeriodDetail	Contient une paire d'objets de jour et d'heure décrivant les horaires d'ouverture du lieu. Pour en savoir plus, consultez PlaceOpeningHoursPeriodDetail.
`close`	facultatif	PlaceOpeningHoursPeriodDetail	Peut contenir une paire d'objets de jour et d'heure décrivant les horaires de fermeture de l'établissement. Si un lieu est toujours ouvert, la section "Fermeture" ne figurera pas dans la réponse. Les clients peuvent s'appuyer sur la représentation d'un lieu toujours ouvert sous la forme d'une période ouverte contenant le jour avec la valeur `0` et l'heure avec la valeur `0000`, et aucun `close`. Pour en savoir plus, consultez PlaceOpeningHoursPeriodDetail.

PlaceSpecialDay

Champ	Obligatoire	Type	Description
`date`	facultatif	chaîne	Date exprimée au format RFC3339 dans le fuseau horaire local du lieu, par exemple 2010-12-31.
`exceptional_hours`	facultatif	booléen	"True" si des horaires exceptionnels sont prévus pour ce jour. Si la valeur est `true`, cela signifie qu'il existe au moins une exception pour ce jour. Les exceptions entraînent l'apparition de différentes valeurs dans les sous-champs de `current_opening_hours` et `secondary_opening_hours`, comme `periods`, `weekday_text` et `open_now`. Les exceptions s'appliquent aux heures, qui sont utilisées pour générer les autres champs.

PlaceOpeningHoursPeriodDetail

Champ	Obligatoire	Type	Description
`day`	required	nombre	Nombre compris entre 0 et 6, correspondant aux jours de la semaine (0 correspondant à dimanche). Par exemple, 2 signifie Mardi.
`time`	required	chaîne	Peut contenir une heure de la journée au format 24 heures hhmm. Les valeurs sont comprises entre 0000 et 2359. L'heure sera indiquée dans le fuseau horaire du lieu.
`date`	facultatif	chaîne	Date exprimée au format RFC3339 dans le fuseau horaire local du lieu, par exemple 2010-12-31.
`truncated`	facultatif	booléen	True si une période donnée a été tronquée en raison d'une limite de sept jours, où la période commence avant minuit à la date de la demande et/ou se termine à minuit ou après le dernier jour. Cette propriété indique que la période d'ouverture ou de fermeture peut dépasser cette limite de sept jours.

PlacePhoto

Photo d'un lieu. Vous pouvez accéder à la photo à l'aide de l'API Place Photo en utilisant une URL selon le modèle suivant :

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photo_reference=photo_reference&key=YOUR_API_KEY

Pour en savoir plus, consultez Photos de lieux.

Champ	Obligatoire	Type	Description
`height`	required	nombre	Hauteur de la photo.
`html_attributions`	required	Array<string>	Attributions HTML pour la photo.
`photo_reference`	required	chaîne	Chaîne utilisée pour identifier la photo lorsque vous effectuez une requête Photo.
`width`	required	nombre	Largeur de la photo.

PlaceReview

Avis sur le lieu envoyé par un utilisateur.

Champ	Obligatoire	Type	Description
`author_name`	required	chaîne	Nom de l'utilisateur qui a envoyé l'avis. Les avis anonymes sont attribués à "Un utilisateur Google".
`rating`	required	nombre	Note globale que l'utilisateur a attribuée à ce lieu. Il s'agit d'un nombre entier compris entre 1 et 5.
`relative_time_description`	required	chaîne	Heure à laquelle l'avis a été envoyé, sous forme de texte, par rapport à l'heure actuelle.
`time`	required	nombre	Heure à laquelle l'avis a été envoyé, mesurée en secondes depuis minuit le 1er janvier 1970 UTC.
`author_url`	facultatif	chaîne	URL du profil Local Guides Google Maps de l'utilisateur, si disponible.
`language`	facultatif	chaîne	Code de langue IETF indiquant la langue de l'avis renvoyé.Ce champ contient uniquement l'indicateur principal de la langue et non le tag secondaire qui précise le pays ou la région. Par exemple, toutes les évaluations en anglais sont signalées par "en", et non "en-AU", "en-UK", etc.Ce champ est vide s'il n'y a qu'une note sans texte d'évaluation.
`original_language`	facultatif	chaîne	Code de langue IETF indiquant la langue d'origine de l'avis. Si l'avis a été traduit, `original_language` est différent de `language`.Ce champ contient uniquement l'indicateur principal de la langue et non le tag secondaire qui précise le pays ou la région. Par exemple, toutes les évaluations en anglais sont signalées par "en", et non "en-AU", "en-UK", etc.Ce champ est vide s'il n'y a qu'une note sans texte d'évaluation.
`profile_photo_url`	facultatif	chaîne	URL de la photo de profil de l'utilisateur, si elle est disponible.
`text`	facultatif	chaîne	Avis de l'utilisateur. Lorsqu'un utilisateur rédige un avis sur un lieu avec Google Places, les évaluations texte sont considérées comme facultatives. Par conséquent, ce champ peut être vide. Notez que ce champ peut inclure un balisage HTML de base. Par exemple, la référence d'entité `&` peut représenter un caractère esperluette.
`translated`	facultatif	booléen	Valeur booléenne indiquant si l'avis a été traduit à partir de la langue d'origine dans laquelle il a été rédigé.Si un avis a été traduit (valeur "true"), Google vous recommande de l'indiquer à vos utilisateurs. Par exemple, vous pouvez ajouter la chaîne "Traduit par Google" à l'avis.

Find Place (ancienne version) Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Requêtes Find Place (ancienne version)

Paramètres obligatoires

entrée

inputtype

Paramètres facultatifs

champs

language

locationbias

Exemples de Find Place (ancienne version)

curl

HTTP

curl

HTTP

curl

HTTP

Réponses Find Place (ancienne version)

JSON

XML

PlacesFindPlaceFromTextResponse

candidates

status

error_message

info_messages

PlacesSearchStatus

Lieu

address_components

adr_address

business_status

curbside_pickup

current_opening_hours

delivery

dine_in

editorial_summary

formatted_address

formatted_phone_number

geometry

icon

icon_background_color

icon_mask_base_uri

international_phone_number

name

opening_hours

permanently_closed

photos

place_id

plus_code

price_level

rating

reference

reservable

reviews

scope

secondary_opening_hours

serves_beer

serves_breakfast

serves_brunch

serves_dinner

serves_lunch

serves_vegetarian_food

serves_wine

takeout

types

url

user_ratings_total

utc_offset

vicinity

website

wheelchair_accessible_entrance

PlaceEditorialSummary

language

overview

PlaceOpeningHours

open_now

periods

special_days

type

weekday_text

PlaceOpeningHoursPeriod

open

Find Place (ancienne version)

`candidates`

`status`

`error_message`

`info_messages`

`address_components`

`adr_address`

`business_status`

`curbside_pickup`

`current_opening_hours`

`delivery`

`dine_in`

`editorial_summary`

`formatted_address`

`formatted_phone_number`

`geometry`

`icon`

`icon_background_color`

`icon_mask_base_uri`

`international_phone_number`

`name`

`opening_hours`

`permanently_closed`

`photos`

`place_id`

`plus_code`

`price_level`

`rating`

`reference`

`reservable`

`reviews`

`scope`

`secondary_opening_hours`

`serves_beer`

`serves_breakfast`

`serves_brunch`

`serves_dinner`

`serves_lunch`

`serves_vegetarian_food`

`serves_wine`

`takeout`

`types`

`url`

`user_ratings_total`

`utc_offset`

`vicinity`

`website`

`wheelchair_accessible_entrance`

`language`

`overview`

`open_now`

`periods`

`special_days`

`type`

`weekday_text`

`open`

`close`

`date`

`exceptional_hours`

`day`

`time`

`date`

`truncated`

`height`

`html_attributions`

`photo_reference`

`width`

`author_name`

`rating`

`relative_time_description`

`time`

`author_url`

`language`

`original_language`

`profile_photo_url`

`text`

`translated`