Find Place (ancienne version)

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

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.

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.

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
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.
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.

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é.

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
facultatif Array<AddressComponent>

Tableau contenant les composants distincts applicables à cette adresse.

Pour en savoir plus, consultez AddressComponent.

facultatif chaîne

Représentation de l'adresse du lieu dans le microformat adr.

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
facultatif booléen

Indique si l'établissement propose le retrait en voiture.
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.

facultatif booléen

Indique si l'établissement propose la livraison.
facultatif booléen

Indique si l'établissement propose des places assises à l'intérieur ou à l'extérieur.

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.

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é.

facultatif chaîne

Contient le numéro de téléphone du lieu dans son format local.

facultatif Geometry

Contient l'emplacement et la fenêtre d'affichage de l'emplacement.

Pour en savoir plus, consultez Geometry.
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.

facultatif chaîne

Contient le code couleur HEX par défaut pour la catégorie du lieu.
facultatif chaîne

Contient l'URL d'une icône recommandée, moins l'extension du type de fichier .svg ou .png.

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.

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.

facultatif PlaceOpeningHours

Indique les horaires d'ouverture habituels.

Pour en savoir plus, consultez PlaceOpeningHours.

facultatif booléen

Utilisez business_status pour obtenir l'état opérationnel des entreprises.

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.
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.

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.
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
facultatif nombre

Contient la note du lieu, sur une échelle de 1,0 à 5,0, basée sur l'ensemble des avis des utilisateurs.

facultatif chaîne
facultatif booléen

Indique si le lieu accepte les réservations.
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.

facultatif chaîne
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.

facultatif booléen

Indique si l'établissement sert de la bière.
facultatif booléen

Indique si l'établissement sert le petit-déjeuner.
facultatif booléen

Indique si l'établissement sert des brunchs.
facultatif booléen

Indique si l'établissement sert à dîner.
facultatif booléen

Indique si le lieu sert le déjeuner.
facultatif booléen

Indique si l'établissement propose des plats végétariens.
facultatif booléen

Indique si l'établissement sert du vin.
facultatif booléen

Indique si l'établissement propose des plats à emporter.
facultatif Array<string>

Contient un tableau de types d'entités décrivant le résultat donné. Consultez la liste des types compatibles.

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.

facultatif nombre

Nombre total d'avis (avec ou sans texte) pour ce lieu.

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).

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.

facultatif chaîne

Site Web faisant autorité pour ce lieu, comme la page d'accueil d'un établissement.

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
facultatif chaîne

Langue des champs précédents. Il n'est pas toujours présent.
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
facultatif booléen

Valeur booléenne indiquant si l'établissement est ouvert à l'heure actuelle.

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.

facultatif Array<PlaceSpecialDay>

Tableau contenant jusqu'à sept entrées correspondant aux sept prochains jours.

Pour en savoir plus, consultez PlaceSpecialDay.

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
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.

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
facultatif chaîne

Date exprimée au format RFC3339 dans le fuseau horaire local du lieu, par exemple 2010-12-31.

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
required nombre

Nombre compris entre 0 et 6, correspondant aux jours de la semaine (0 correspondant à dimanche). Par exemple, 2 signifie Mardi.

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.

facultatif chaîne

Date exprimée au format RFC3339 dans le fuseau horaire local du lieu, par exemple 2010-12-31.

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
required nombre

Hauteur de la photo.
required Array<string>

Attributions HTML pour la photo.
required chaîne

Chaîne utilisée pour identifier la photo lorsque vous effectuez une requête Photo.

required nombre

Largeur de la photo.

PlaceReview

Avis sur le lieu envoyé par un utilisateur.

Champ Obligatoire Type Description
required chaîne

Nom de l'utilisateur qui a envoyé l'avis. Les avis anonymes sont attribués à "Un utilisateur Google".

required nombre

Note globale que l'utilisateur a attribuée à ce lieu. Il s'agit d'un nombre entier compris entre 1 et 5.

required chaîne

Heure à laquelle l'avis a été envoyé, sous forme de texte, par rapport à l'heure actuelle.

required nombre

Heure à laquelle l'avis a été envoyé, mesurée en secondes depuis minuit le 1er janvier 1970 UTC.

facultatif chaîne

URL du profil Local Guides Google Maps de l'utilisateur, si disponible.

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.

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.

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é &amp; peut représenter un caractère esperluette.

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.