Ce produit est obsolète. Depuis octobre 2026, l'ancienne API Places ne peut plus être activée pour les nouveaux projets Google Cloud. Les projets existants restent entièrement compatibles. Pour bénéficier de nouvelles fonctionnalités et de performances améliorées, migrez vers l'API Places (nouvelle version).

Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Place Details (ancien)

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 créez une application côté client, consultez le SDK Places pour Android (New), le SDK Places pour iOS (New) et la bibliothèque Places, API Maps JavaScript.

Une fois que vous avez obtenu un place_id à partir d'une recherche de lieu, vous pouvez demander plus d'informations sur un établissement ou un point d'intérêt particulier en envoyant une requête Place Details (ancienne version). 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, etc.

Requêtes Place Details (ancienne version)

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

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

où output peut correspondre à l'une des valeurs suivantes :

json (recommandé) indique une sortie au format JSON (JavaScript Object Notation).
xml indique une sortie 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 (&). Les sections suivantes listent les paramètres et leurs valeurs possibles.

Paramètres obligatoires

place_id

Identifiant textuel qui identifie un lieu de manière unique, renvoyé par une Place Search (ancienne version). Pour en savoir plus sur les ID de lieu, consultez la présentation des ID de lieu.

Paramètres facultatifs

champs

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

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 grille 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 les résultats doivent être renvoyés.
- Consultez la liste des langues acceptées. Google met souvent à jour les langues acceptées. Cette liste n'est donc pas exhaustive.
- Si 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 s'efforce de fournir une adresse postale lisible à la fois pour l'utilisateur et pour les habitants. Pour atteindre cet objectif, elle 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 préférée. Les composants d'adresse sont tous renvoyés dans la même langue, qui est choisie à partir du premier composant.
- Si aucun nom n'est disponible dans la langue préférée, l'API utilise la correspondance la plus proche.
- La langue préférée a une légère influence sur l'ensemble des résultats que l'API choisit de renvoyer et sur l'ordre dans lequel ils sont renvoyés. Le geocoder 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 (domaine de premier niveau) à 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, ou reviews_no_translations=false pour l'activer. Les avis sont renvoyés dans leur langue d'origine.

Si ce paramètre est omis ou transmis 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 pour renvoyer les 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 privilégie les résultats pour renvoyer les avis initialement rédigés 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 pas d'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 (ancien) est effectué. Chaque session peut comporter plusieurs requêtes, suivies d'une sélection de lieu. La ou les clés API utilisées pour chaque requête d'une session doivent appartenir au même projet de la console Google Cloud. 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.

Avertissement : Si vous ne spécifiez pas au moins un champ avec une requête ou si vous omettez le paramètre fields d'une requête, TOUS les champs possibles seront renvoyés, et cela vous sera facturé en conséquence. Cela ne s'applique qu'aux requêtes Place Details (ancienne version).

Exemple de Place Details (ancienne version)

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

Shell

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

Remplacez la clé de cet exemple par votre propre clé API pour que la requête fonctionne dans votre application.

Réponse Place Details (ancienne version)

Les réponses Place Details (ancienne version) sont renvoyées au format indiqué par l'option 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,
          },
          // ...
        ],
      "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,
          },
          // ...
        ],
      "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>
  <!-- ... -->
  <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>
  <!-- ... -->
  <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
`html_attributions`	required	Array<string>	Peut contenir un ensemble d'attributions concernant cette fiche qui doivent être présentées à l'utilisateur (certaines fiches peuvent ne pas avoir d'attribution).
`result`	required	Place	Contient des informations détaillées sur le lieu demandé. Pour en savoir plus, consultez Place.
`status`	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.
`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 être présent dans l'objet de réponse. Ce champ n'est renvoyé que pour les requêtes réussies. Il n'est pas toujours renvoyé et son contenu est susceptible d'être modifié.

Dans une réponse JSON, ils sont représentés en tant qu'éléments racines. 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 : Indique que l'emplacement référencé, place_id, était valide, mais qu'il 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é la limite de RPS.
- La facturation n'a pas été activée sur votre compte.
- Le crédit mensuel de 200 $ ou la limite d'utilisation que vous avez définie vous-même a été dépassé.
- Le mode de facturation fourni n'est plus valide (une carte de crédit est arrivée à expiration, par exemple).
Pour en savoir plus sur la résolution de cette erreur, consultez les questions fréquentes sur Maps.
REQUEST_DENIED, qui indique que votre requête a été rejetée, généralement pour les raisons suivantes :
- 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 sont 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 au 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 un service de drive.
`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 en intérieur ou en extérieur.
`editorial_summary`	facultatif	PlaceEditorialSummary	Contient un résumé du lieu. Un résumé comprend une présentation textuelle, ainsi que le code de langue de ces éléments, le cas échéant. Le texte du résumé doit être présenté tel quel et ne peut pas être modifié ni altéré. Pour en savoir plus, consultez PlaceEditorialSummary.
`formatted_address`	facultatif	chaîne	Chaîne contenant l'adresse lisible par l'humain 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 au 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 présentée à l'utilisateur lorsque ce résultat est indiqué sur une carte.
`icon_background_color`	facultatif	chaîne	Contient le code couleur hexadécimal 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 de 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 champ international_phone_number pour le bureau de Google à Sydney, en Australie, est `+61 2 9374 4000`.
`name`	facultatif	chaîne	Contient le nom lisible par l'humain du résultat renvoyé. Pour les résultats `establishment`, il s'agit généralement du nom canonique de l'établissement.
`opening_hours`	facultatif	PlaceOpeningHours	Contient 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 sur les photos de lieux. 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 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	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 €€€ 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 l'établissement accepte les réservations.
`reviews`	facultatif	Array<PlaceReview>	Tableau JSON comportant jusqu'à cinq avis. Par défaut, les avis sont triés par ordre de 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 privilégie les résultats pour renvoyer les avis initialement rédigés 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 pas d'incidence sur l'ordre de tri. Google recommande d'indiquer aux utilisateurs si les résultats sont classé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 d'ouverture principaux d'un établissement. Par exemple, un restaurant peut spécifier des horaires de drive ou de livraison comme horaires secondaires. Ce champ renseigne le sous-champ `type`, qui s'appuie sur une liste prédéfinie de types d'horaires d'ouverture (par exemple, `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 qui ont 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 propose un service de dîner.
`serves_lunch`	facultatif	booléen	Indique si l'établissement 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 propose du vin.
`takeout`	facultatif	booléen	Indique si l'établissement propose des plats à emporter.
`types`	facultatif	Array<string>	Contient un tableau de types d'éléments 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 l'élément politique (`types:["political", ...]`) le plus précis présent dans l'adresse du résultat. Ce contenu est destiné à être lu tel quel. N'analysez pas par programmation l'adresse formatée.
`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 l'établissement dispose d'une entrée accessible en fauteuil roulant.

PlaceEditorialSummary

Contient un résumé du lieu. Un résumé comprend une présentation textuelle, ainsi que le code de langue de ces éléments, le cas échéant. Le texte du résumé doit être présenté tel quel et ne peut pas être modifié ni altéré.

Champ	Obligatoire	Type	Description
`language`	facultatif	chaîne	Langue des champs précédents. Peut ne pas toujours être 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	Tableau<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 de sept entrées maximum 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'horaires secondaires (par exemple, `DRIVE_THROUGH`, `HAPPY_HOUR`, `DELIVERY`, `TAKEOUT`, `KITCHEN`, `BREAKFAST`, `LUNCH`, `DINNER`, `BRUNCH`, `PICKUP`, `SENIOR_HOURS`). Défini pour `secondary_opening_hours` uniquement.
`weekday_text`	facultatif	Array<string>	Tableau de chaînes décrivant les horaires du lieu dans un texte lisible par l'humain.

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 établissement est toujours ouvert, la section "close" ne figurera pas dans la réponse. Vous pouvez représenter un lieu toujours ouvert par une période d'ouverture contenant un jour avec la valeur `0` et une 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 définis 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 valeurs différentes dans les sous-champs de `current_opening_hours` et `secondary_opening_hours`, tels que `periods`, `weekday_text` et `open_now`. Les exceptions s'appliquent aux horaires, et les horaires sont utilisés 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 requête 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 s'étendre au-delà de 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 au format 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 de 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	Date et heure d'envoi de l'avis, par rapport à l'heure actuelle.
`time`	required	nombre	Heure à laquelle l'avis a été envoyé, mesurée en nombre de secondes depuis le 1er janvier 1970 à minuit 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` != `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'avis.
`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 une esperluette.
`translated`	facultatif	booléen	Valeur booléenne indiquant si l'avis a été traduit de la langue d'origine dans laquelle il a été rédigé.Si un avis a été traduit, ce qui correspond à la valeur "true", Google vous recommande de l'indiquer à vos utilisateurs. Par exemple, vous pouvez ajouter la chaîne "Traduit par Google" à l'avis.

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

Requêtes Place Details (ancienne version)

Paramètres obligatoires

place_id

Paramètres facultatifs

champs

language

région

reviews_no_translations

reviews_sort

sessiontoken

Exemple de Place Details (ancienne version)

Shell

HTTP

Réponse Place Details (ancienne version)

JSON

XML

PlacesDetailsResponse

html_attributions

result

status

info_messages

PlacesDetailsStatus

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

close

PlaceSpecialDay

Place Details (ancien)

`html_attributions`

`result`

`status`

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