Place Details (ancien)

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

Une fois que vous avez obtenu un place_id à partir d'une recherche de lieux, vous pouvez demander plus d'informations sur un établissement ou un point d'intérêt en particulier en envoyant une requête Place Details (Legacy). Une requête Place Details (ancienne version) renvoie des informations plus complètes sur le lieu indiqué, comme son adresse complète, son numéro de téléphone, les avis et notes des visiteurs.

Requêtes Place Details (ancienne version)

Une requête Place Details (Legacy) est une URL HTTP au format suivant :

https://maps.googleapis.com/maps/api/place/details/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 obligatoires pour lancer une requête de recherche. Comme c'est la norme pour les URL, les différents paramètres sont séparés par une esperluette (&). Vous trouverez ci-dessous la liste des paramètres et de leurs valeurs possibles.

Paramètres obligatoires

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

  • région

    Code régional, spécifié sous la forme d'une valeur ccTLD ("top-level domain") à deux caractères. La plupart des codes ccTLD 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").

  • reviews_no_translations

    Spécifiez reviews_no_translations=true pour désactiver la traduction des avis et reviews_no_translations=false pour l'activer. Les avis sont renvoyés dans leur langue d'origine.

    Si elle est omise ou transmise sans valeur, la traduction des avis est activée. Si le paramètre language a été spécifié dans la requête, utilisez la langue spécifiée comme langue préférée pour la traduction. Si language est omis, l'API tente d'utiliser l'en-tête Accept-Language comme langue préférée.

  • reviews_sort

    Méthode de tri à utiliser lors du renvoi des avis. Peut être défini sur most_relevant (par défaut) ou newest.

    • 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 vous recommande d'indiquer à l'utilisateur final comment les avis sont triés.

  • sessiontoken

    Chaîne aléatoire qui identifie une session de saisie semi-automatique à des fins de facturation.

    La session commence lorsque l'utilisateur commence à saisir une requête et se termine lorsqu'il sélectionne un lieu et qu'un appel à Place Details est effectué. Chaque session peut comporter plusieurs requêtes, suivies d'une sélection de lieu. Les clés API utilisées pour chaque requête d'une session doivent appartenir au même projet Google Cloud Console. Lorsque la session prend fin, le jeton n'est plus valide. Votre application doit générer un nouveau jeton pour chaque session. Si vous omettez le paramètre sessiontoken ou si vous réutilisez un jeton de session, la session est facturée comme si aucun jeton n'était fourni (chaque requête est facturée séparément).

    Nous vous recommandons de respecter les consignes suivantes:

    • Utilisez des jetons de session pour toutes les sessions de saisie semi-automatique.
    • Générez un nouveau jeton pour chaque session. Nous vous recommandons d'utiliser la version 4 de l'UUID.
    • Assurez-vous que les clés API utilisées pour toutes les requêtes Place Autocomplete et Place Details d'une session appartiennent au même projet de la console Cloud.
    • N'oubliez pas de transmettre un jeton de session unique pour chaque nouvelle session. Si vous utilisez le même jeton pour plusieurs sessions, chaque requête est facturée individuellement.

Exemple de Place Details (Legacy)

L'exemple suivant demande les détails d'un lieu par place_id et inclut les champs name, rating et formatted_phone_number :

Coquille Rose

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJN1t_tDeuEmsRUsoyG83frY4&fields=name%2Crating%2Cformatted_phone_number&key=YOUR_API_KEY'

HTTP

https://maps.googleapis.com/maps/api/place/details/json
  ?fields=name%2Crating%2Cformatted_phone_number
  &place_id=ChIJN1t_tDeuEmsRUsoyG83frY4
  &key=YOUR_API_KEY

Notez que vous devrez remplacer la clé de cet exemple par votre propre clé API pour que la requête fonctionne dans votre application.

Réponse Place Details (ancienne)

Les réponses Place Details (ancienne version) sont renvoyées dans le format indiqué par le flag output dans le chemin d'URL de la requête.

JSON

{
  "html_attributions": [],
  "result":
    {
      "address_components":
        [
          { "long_name": "48", "short_name": "48", "types": ["street_number"] },
          {
            "long_name": "Pirrama Road",
            "short_name": "Pirrama Rd",
            "types": ["route"],
          },
          {
            "long_name": "Pyrmont",
            "short_name": "Pyrmont",
            "types": ["locality", "political"],
          },
          {
            "long_name": "City of Sydney",
            "short_name": "City of Sydney",
            "types": ["administrative_area_level_2", "political"],
          },
          {
            "long_name": "New South Wales",
            "short_name": "NSW",
            "types": ["administrative_area_level_1", "political"],
          },
          {
            "long_name": "Australia",
            "short_name": "AU",
            "types": ["country", "political"],
          },
          {
            "long_name": "2009",
            "short_name": "2009",
            "types": ["postal_code"],
          },
        ],
      "adr_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "business_status": "OPERATIONAL",
      "formatted_address": "48 Pirrama Rd, Pyrmont NSW 2009, Australia",
      "formatted_phone_number": "(02) 9374 4000",
      "geometry":
        {
          "location": { "lat": -33.866489, "lng": 151.1958561 },
          "viewport":
            {
              "northeast":
                { "lat": -33.8655112697085, "lng": 151.1971156302915 },
              "southwest":
                { "lat": -33.86820923029149, "lng": 151.1944176697085 },
            },
        },
      "icon": "https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png",
      "icon_background_color": "#7B9EB0",
      "icon_mask_base_uri": "https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet",
      "international_phone_number": "+61 2 9374 4000",
      "name": "Google Workplace 6",
      "opening_hours":
        {
          "open_now": false,
          "periods":
            [
              {
                "close": { "day": 1, "time": "1700" },
                "open": { "day": 1, "time": "0900" },
              },
              {
                "close": { "day": 2, "time": "1700" },
                "open": { "day": 2, "time": "0900" },
              },
              {
                "close": { "day": 3, "time": "1700" },
                "open": { "day": 3, "time": "0900" },
              },
              {
                "close": { "day": 4, "time": "1700" },
                "open": { "day": 4, "time": "0900" },
              },
              {
                "close": { "day": 5, "time": "1700" },
                "open": { "day": 5, "time": "0900" },
              },
            ],
          "weekday_text":
            [
              "Monday: 9:00 AM – 5:00 PM",
              "Tuesday: 9:00 AM – 5:00 PM",
              "Wednesday: 9:00 AM – 5:00 PM",
              "Thursday: 9:00 AM – 5:00 PM",
              "Friday: 9:00 AM – 5:00 PM",
              "Saturday: Closed",
              "Sunday: Closed",
            ],
        },
      "photos":
        [
          {
            "height": 3024,
            "html_attributions":
              [
                "Cynthia Wei",
              ],
            "photo_reference": "Aap_uEC6jqtpflLS8GxQqPHBjlcwBf2sri0ZErk9q1ciHGZ6Zx5HBiiiEsPEO3emtB1PGyWbBQhgPL2r9CshoVlJEG4xzB71QMhGBTqqeaCNk1quO3vTTiP50aM1kmOaBQ-DF1ER7zpu6BQOEtnusKMul0m4KA45wfE3h6Xh2IxjLNzx-IiX",
            "width": 4032,
          },
          {
            "height": 3264,
            "html_attributions":
              [
                "Heyang Li",
              ],
            "photo_reference": "Aap_uECyRjHhOQgGaKTW6Z3ZfTEaDhNc44m0F6GrNSFIMffixwI5xqD35QhecdzVY-FUuDtVE1huu8-2HkxgI9Gwvy6W18fU-_E3UUkdSFBQqGK8_slKlT8BZZc66sTX53IEcTDrZfT-E5_YUBYBOm13yxOTOfWfEDABhaxCGC5Hu_XYh0fI",
            "width": 4912,
          },
          {
            "height": 3036,
            "html_attributions":
              [
                "Anna Linetsky",
              ],
            "photo_reference": "Aap_uEAumTzSdhRHDutPAj6wVPSZZmBV-brI6TPFwI0tcQlbSR74z44mUPr4aXMQKck_AzHaKmbfR3P2c1qsu45i1RQPHrcpIXxrA78FmDjCdWYYZWUnFozdcmEj9OQ_V0G08adpKivMKZyeaQ1NuwRy9GhSopeKpzkzkFZG5vXMYPPSgpa1",
            "width": 4048,
          },
          {
            "height": 4016,
            "html_attributions":
              [
                "Jonah Dell",
              ],
            "photo_reference": "Aap_uECC7cSbDkh-TdmXr6m5d5pgVXJmvXg8dF2jzhL0b0Ko4CtnVll6-tIvdz7vhbCsd3hl2u9EgZ4Y30FBxKmFcimfeYUgW2XJyv8JY5IYGuXsKkCLqpV3QH9dIGwoUv2uX0eosDsUsTN2DOlyOasUgVxcYqzIzEmrL5ofIssThQWZeozD",
            "width": 6016,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Anthony Huynh",
              ],
            "photo_reference": "Aap_uEDTdw58CglFmZZAR9iZ05x3y2oK9r5_dRqKWnbZKSS9gs6gp9AeBa1QDvBL6dzZyQAZfN8H2Eppu6y4NBaPOp-GkulZYiKRM7Yww8sUEv-8dmcq35Tx38pe4LEX2wIicFkQHedRgMc0FfV9aFtgosQ5ps5-HCjJSApg8eLGyuxxqPm9",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jasen Baker",
              ],
            "photo_reference": "Aap_uEAGqslqZPhZUk0T2Y6l7mkCYnY7JN9li4g5NkZsE0N4Cdy7_cZ-fZWyV02VhpQR4Ph4fLUL6_WTXrlGMXXzUJXUcSmSTs2d_Dzf3Q_A1y07Dm-vtv7pS3JXsWyrWETGIoT1pIj81PPdUc1vlR2i3GFMWAbx9rCC472ZJclY8JlvMg-x",
            "width": 4032,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uEBaGxeN90YFjD-AUjxZqM44kpMcICKKBBhb0RQQS7DHHFaay8RRAwjWsAt8GEmmB5QnxrbQWHU3TwhVXXHP0m-YNp9Ds3ihpiFan0moNv4QB7kern5cfjWhhrWe8B0dz_vYvmPssJE24P-24YfWWHubOo0L2MjQyueZfDv57N_RvDZk",
            "width": 4032,
          },
          {
            "height": 1515,
            "html_attributions":
              [
                "Andrew W",
              ],
            "photo_reference": "Aap_uEBDzJlmTeNUreMop6_hkC1HKTCRLyPs5fikJi58qCejtkWp5PIM6vzNN3HErkSWUwnamTr_WLyT7jXMAIdByR-hx8dG-OHjj5JxzmcPvuT_VeVLmdSbNPeIlpmp6EUcPOhaVrhEKojSd44QXkl0za29eZ0oj1KDOnAsGxmhanDFW7lI",
            "width": 2048,
          },
          {
            "height": 3024,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uEBvYFpzCDQzvQ0kdBxxB70lTkLbTM0yH3xF-BCHsb7DQ63cuWnutvwv8oVLDSbA14_kns3WVlEInTyy2elvmH5lzQteb6zzRu3exkwE65_55TgJqdLO7RYYiPFliWk4ocszn9nn5ELv5uP2BQmqr9QET5vwgxR-0eshyVmcdM42jb39",
            "width": 4032,
          },
          {
            "height": 4032,
            "html_attributions":
              [
                "Jeremy Hsiao",
              ],
            "photo_reference": "Aap_uECQynuD_EnSnbz8sJQ6-B6uR-j2tuu4Z1tuGUjq8xnxFDk-W8OdeLzWBX8suNKTCsPlkzTqC22BXf_hX33XclGPL4SS9xnPmHcMrLoUl0H_xHYevFvT17Hgw5DZpSyVmLvDvxzzJ1rsZTh55QwopmAty083a1r1ZIfL32iXh_q8FUas",
            "width": 3024,
          },
        ],
      "place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "plus_code":
        {
          "compound_code": "45MW+C8 Pyrmont NSW, Australia",
          "global_code": "4RRH45MW+C8",
        },
      "rating": 4,
      "reference": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "reviews":
        [
          {
            "author_name": "Luke Archibald",
            "author_url": "https://www.google.com/maps/contrib/113389359827989670652/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "a week ago",
            "text": "Beautiful building with a great view.",
            "time": 1652286798,
          },
          {
            "author_name": "Tevita Taufoou",
            "author_url": "https://www.google.com/maps/contrib/105937236918123663309/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "6 months ago",
            "text": "Conference rooms were well equipped.",
            "time": 1637215605,
          },
          {
            "author_name": "Jordy Baker",
            "author_url": "https://www.google.com/maps/contrib/102582237417399865640/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "4 months ago",
            "text": "The staff is very friendly.",
            "time": 1641389490,
          },
          {
            "author_name": "Prem Rathod",
            "author_url": "https://www.google.com/maps/contrib/115981614018592114142/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo",
            "rating": 1,
            "relative_time_description": "4 months ago",
            "text": "The location is convenient and easy to find.",
            "time": 1640159655,
          },
          {
            "author_name": "Husuni Hamza",
            "author_url": "https://www.google.com/maps/contrib/102167316656574288776/reviews",
            "language": "en",
            "profile_photo_url": "https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo",
            "rating": 5,
            "relative_time_description": "7 months ago",
            "text": "A modern and impressive facility.",
            "time": 1633197305,
          },
        ],
      "types": ["point_of_interest", "establishment"],
      "url": "https://maps.google.com/?cid=10281119596374313554",
      "user_ratings_total": 939,
      "utc_offset": 600,
      "vicinity": "48 Pirrama Road, Pyrmont",
      "website": "http://google.com/",
    },
  "status": "OK",
}

XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceDetailsResponse>
 <status>OK</status>
 <result>
  <name>Google Workplace 6</name>
  <vicinity>48 Pirrama Road, Pyrmont</vicinity>
  <type>point_of_interest</type>
  <type>establishment</type>
  <formatted_phone_number>(02) 9374 4000</formatted_phone_number>
  <formatted_address>48 Pirrama Rd, Pyrmont NSW 2009, Australia</formatted_address>
  <address_component>
   <long_name>48</long_name>
   <short_name>48</short_name>
   <type>street_number</type>
  </address_component>
  <address_component>
   <long_name>Pirrama Road</long_name>
   <short_name>Pirrama Rd</short_name>
   <type>route</type>
  </address_component>
  <address_component>
   <long_name>Pyrmont</long_name>
   <short_name>Pyrmont</short_name>
   <type>locality</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>City of Sydney</long_name>
   <short_name>City of Sydney</short_name>
   <type>administrative_area_level_2</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>New South Wales</long_name>
   <short_name>NSW</short_name>
   <type>administrative_area_level_1</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>Australia</long_name>
   <short_name>AU</short_name>
   <type>country</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>2009</long_name>
   <short_name>2009</short_name>
   <type>postal_code</type>
  </address_component>
  <geometry>
   <location>
    <lat>-33.8664890</lat>
    <lng>151.1958561</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8682092</lat>
     <lng>151.1944177</lng>
    </southwest>
    <northeast>
     <lat>-33.8655113</lat>
     <lng>151.1971156</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.0</rating>
  <url>https://maps.google.com/?cid=10281119596374313554</url>
  <icon>https://maps.gstatic.com/mapfiles/place_api/icons/v1/png_71/generic_business-71.png</icon>
  <reference>ChIJN1t_tDeuEmsRUsoyG83frY4</reference>
  <international_phone_number>+61 2 9374 4000</international_phone_number>
  <website>http://google.com/</website>
  <review>
   <time>1652286798</time>
   <text>Beautiful building with a great view.</text>
   <author_name>Luke Archibald</author_name>
   <author_url>https://www.google.com/maps/contrib/113389359827989670652/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a-/AOh14GhGGmTmvtD34HiRgwHdXVJUTzVbxpsk5_JnNKM5MA=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>a week ago</relative_time_description>
  </review>
  <review>
   <time>1637215605</time>
   <text>Conference rooms were well equipped.</text>
   <author_name>Joe Schmoe</author_name>
   <author_url>https://www.google.com/maps/contrib/105937236918123663309/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwZANdRSSg96QeZG--6BazG5uv_BJMIvpZGqwSz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>6 months ago</relative_time_description>
  </review>
  <review>
   <time>1641389490</time>
   <text>The staff is very friendly.</text>
   <author_name>Jordy Baker</author_name>
   <author_url>https://www.google.com/maps/contrib/102582237417399865640/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwgg1tM4aVA4nJCMjlfJtHtFZuxF475Vb6tT74S=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>4 months ago</relative_time_description>
  </review>
  <review>
   <time>1640159655</time>
   <text>The location is convenient and easy to find.</text>
   <author_name>Prem Rathod</author_name>
   <author_url>https://www.google.com/maps/contrib/115981614018592114142/reviews</author_url>
   <rating>1.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJyEQpqs4YvPPzMPG2dnnRTFPC4jxJfn8YXnm2gz=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>4 months ago</relative_time_description>
  </review>
  <review>
   <time>1633197305</time>
   <text>A modern and impressive facility.</text>
   <author_name>Husuni Hamza</author_name>
   <author_url>https://www.google.com/maps/contrib/102167316656574288776/reviews</author_url>
   <rating>5.0</rating>
   <language>en</language>
   <profile_photo_url>https://lh3.googleusercontent.com/a/AATXAJwRkyvoSlgd06ahkF9XI9D39o6Zc_Oycm5EKuRg=s128-c0x00000000-cc-rp-mo</profile_photo_url>
   <relative_time_description>7 months ago</relative_time_description>
  </review>
  <opening_hours>
   <open_now>false</open_now>
   <period>
    <open>
     <day>1</day>
     <time>0900</time>
    </open>
    <close>
     <day>1</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>2</day>
     <time>0900</time>
    </open>
    <close>
     <day>2</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>3</day>
     <time>0900</time>
    </open>
    <close>
     <day>3</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>4</day>
     <time>0900</time>
    </open>
    <close>
     <day>4</day>
     <time>1700</time>
    </close>
   </period>
   <period>
    <open>
     <day>5</day>
     <time>0900</time>
    </open>
    <close>
     <day>5</day>
     <time>1700</time>
    </close>
   </period>
   <weekday_text>Monday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Tuesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Wednesday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Thursday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Friday: 9:00 AM – 5:00 PM</weekday_text>
   <weekday_text>Saturday: Closed</weekday_text>
   <weekday_text>Sunday: Closed</weekday_text>
  </opening_hours>
  <utc_offset>600</utc_offset>
  <photo>
   <photo_reference>Aap_uEDT4DC26Lk_VoI6CvsZl1NzU7BOPjEyqEHlf8tCA0hFtlrsI1Tmed_LmjSUQghWnZq-E7SsYZSlvGP0X5ZAfH6w0Tmw6biO4PPI8BTPwvo6FqLfZgC2RGNQyI81HRnJGB3ZJUAYEXvxBfA_upEcsITxk52joPkK9d7cfFptY0z-Oy7Y</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/117600448889234589608&quot;&gt;Cynthia Wei&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAPNVkxDxxHa0aRFAkA2gMygFUuaKujSSv-zdad_vuaxTkaDHgX-aVPeNATp7VEgwqa3A3QutoeKdDd6aGZPBPCLl8XTf1vYckEBxIWEXZjFlMXK2TwIVfe4qa6O31AbYQQ5TCrEs9nz2fuBBWJwifTiKIIrv4NrEpQok6i8nnn8xKS</photo_reference>
   <width>4912</width>
   <height>3264</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102493344958625549078&quot;&gt;Heyang Li&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBXOmqXNblj10HJavekmUNyUwccggfNN9KVE9TjYcU9HXkBHdvnwfYHDx3dfrjJJwnN8yooP-5412iJNRk8cwUbAVYbD2326cfiJJ3oK6pOrAi1oBmCYuAwKTHnX3EQvSbheVhJZPNDHlT5TjKcwfwAb80eyLB2UNyWl3Y6D7YS7ZSf</photo_reference>
   <width>4048</width>
   <height>3036</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/104829437842034782235&quot;&gt;Anna Linetsky&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAWyGsK1fp3SE73xICq8FJNlrVVqRk8E6YfMiz-o8IJj1vESmuDj4NnPDP4S2kWFrfoBpqw9lmXBGxtYo6nPMySfBAcRIbdEg0ko4dcdzsBvo6cRUz9XpmlcoptCpIAKEb6f7Bh_OD0zFntYbTz-pLdQ9ZHB8tBvTb3kzfTdK2Du0yC</photo_reference>
   <width>6016</width>
   <height>4016</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/107755640736541028674&quot;&gt;Jonah Dell&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEAxbn61tx1hwCo3kUMd2KPlWaBkrFhXHxsZDgkYxpJqc-ZYC6U0MH6urfbHVrwmMoosOG0G39anmR68B7p2Up3AACxTa21vCopSL6-RHIphVsBhfhOrFMlGNqBDEsnmY15X0FzzNMKASXqmqtzBphiRyGhAFKfRs3Js1ymXP_FWjqzT</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/115886271727815775491&quot;&gt;Anthony Huynh&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEClwnjuvgS58OknaXxZeVGf5ydyG6U6lO9srr8FU7tPoZ4DvqQo-GUeemssC11tzDBUMWit4ILWF-GmlRfIHS8FuAtttOgp2wvgPhs-ADUrznLRXYKBRkNQnRLEIA1PBgJN9Eev8tFWxpY_jBMklkEUZJRjm-mk9R0bSKSelpPgMYAz</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/102939237947063969663&quot;&gt;Jasen Baker&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBvISYtwjSgTQntTJJ_-XhPUF4CVCQF3wxM0FjcQJuzomYLfZWFlIWsOgXhwt2Sd8K6OqFrSP8XHHrBaqQJHD-om-H_wfRLVmiAoQa8QG5oxt540AucTMP4H2QfhTXngqEoNuOcbb-xo2l01OPUetTdIZQ3S6U5s2iyGrHpTs3qz8CH</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEB2cYxbKE7uIXQ_IhX3TvZHDcFHXjWSwezoiwP3eWlfIDTWwq3xtsYZY7QSrhR2d9s1eWmZlM5zr9iHlC_n0gsJXNeRcfd2JjuLFaNuC7VfpeIsdQchhOybG0drJ2CxzD187Az-Foip-6MutDA22LINPw0Iyc_yT04WbxQDxhiwu2Cn</photo_reference>
   <width>2048</width>
   <height>1515</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/112343109286948028063&quot;&gt;Andrew W&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEBJyLgeilgow1JnoKW83IBsl8CPkmryN8nGYtBzzLaiLjFicWxC1YPQusM-_Fvfb1bkbuShrzjXmHCOp5HoBgJsgit8o0HPYWgjSwrdySqde1BgfKbwS-TWbPg_dwTnVR8LrVPxa_vpLzNlx1b-WpDZo3-_KvxH2GARhVrcvWkvMYD0</photo_reference>
   <width>4032</width>
   <height>3024</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <photo>
   <photo_reference>Aap_uEADyMSxLevgbLWCJeHA8kIN3w6-JcndbuHvTB0oqR-IlWbml4bbYmR-_iYU15HBh8xi3w5hZ455pda6m-BlLCscr6g_Zc5FmBOHW56IsZF3Pxif5UmeGZSsg3WIjHCoL-JyndN0nkfyzS31E05tZi61RfXQ2UPY2_5ceKYua5U6d5Zd</photo_reference>
   <width>3024</width>
   <height>4032</height>
   <html_attribution>&lt;a href=&quot;https://maps.google.com/maps/contrib/100678816592586275978&quot;&gt;Jeremy Hsiao&lt;/a&gt;</html_attribution>
  </photo>
  <adr_address>&lt;span class=&quot;street-address&quot;&gt;48 Pirrama Rd&lt;/span&gt;, &lt;span class=&quot;locality&quot;&gt;Pyrmont&lt;/span&gt; &lt;span class=&quot;region&quot;&gt;NSW&lt;/span&gt; &lt;span class=&quot;postal-code&quot;&gt;2009&lt;/span&gt;, &lt;span class=&quot;country-name&quot;&gt;Australia&lt;/span&gt;</adr_address>
  <user_ratings_total>939</user_ratings_total>
  <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id>
  <plus_code>
   <global_code>4RRH45MW+C8</global_code>
   <compound_code>45MW+C8 Pyrmont NSW, Australia</compound_code>
  </plus_code>
  <icon_background_color>#7B9EB0</icon_background_color>
  <business_status>OPERATIONAL</business_status>
  <icon_mask_base_uri>https://maps.gstatic.com/mapfiles/place_api/icons/v2/generic_pinlet</icon_mask_base_uri>
 </result>
</PlaceDetailsResponse>

Les réponses JSON et XML contiennent chacune les éléments suivants :

PlacesDetailsResponse

Champ Obligatoire Type Description
required Array<string>

Peut contenir un ensemble d'attributions concernant cette fiche, qui doivent être affichées à l'utilisateur (certaines fiches peuvent ne pas avoir d'attribution).

required Place

Contient des informations détaillées sur le lieu demandé.

Pour en savoir plus, consultez Place.
required PlacesDetailsStatus

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

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

Dans une réponse JSON, ils sont représentés sous forme d'éléments racine. Dans une réponse XML, ils apparaissent en tant qu'éléments de premier niveau sous <PlaceDetailsResponse>.

PlacesDetailsStatus

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

  • OK, qui indique que la requête API a abouti.
  • ZERO_RESULTS indiquant que le lieu référencé, place_id, était valide, mais ne fait plus référence à un résultat valide. Cette situation peut survenir si l'établissement a cessé son activité.
  • NOT_FOUND indiquant que l'emplacement référencé, place_id, est introuvable dans la base de données Places.
  • INVALID_REQUEST, qui indique que la requête API n'a pas été rédigée correctement ;
  • 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 l'établissement 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.