Vous êtes prêt !

Pour passer à l'étape de développement, accédez à notre documentation pour les développeurs.

Activer Google Places API Web Service

Pour commencer, nous allons vous guider à travers la console Google Developers et effectuer deux ou trois petites choses :

  1. Créer ou choisir un projet
  2. Activer Google Places API Web Service
  3. Créer les clés appropriées
Continuer

Détails des lieux

Une fois que vous avez obtenu un paramètre place_id ou reference à partir d'une recherche de lieux (Place Search), vous pouvez demander des détails supplémentaires sur un établissement ou un point d'intérêt spécifique en lançant une requête de détails de lieu (Place Details). Une requête Place Details renvoie des informations supplémentaires sur le lieu indiqué, telles que l'adresse complète, le numéro de téléphone, la note et les avis des utilisateurs.

Requêtes Place Details

Une requête de détails de lieu (Place Details) est une URL HTTP utilisant le format suivant :

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

output peut prendre l'une des valeurs suivantes :

  • json (recommandé) indique que la réponse doit être au format JSON (JavaScript Object Notation).
  • xml indique que la réponse doit être au format XML.

Certains paramètres sont obligatoires pour lancer une requête de recherche. Comme pour toutes les URL, les différents paramètres sont séparés par une esperluette (&). Vous trouverez ci-dessous la liste des paramètres et leurs différentes valeurs possibles.

  • key (obligatoire) - Clé d'API de votre application. Elle identifie votre application à des fins de gestion des quotas. Ainsi, les lieux ajoutés à partir de votre application sont immédiatement disponibles pour votre application. Pour plus d'informations, voir Obtenir une clé.
  • Soit placeid, soit reference (vous devez indiquer l'un de ces deux paramètres, mais pas les deux) :
Paramètres facultatifs
  • extensions (facultatif) — Indique si la réponse à la requête de détails de lieu doit inclure des champs supplémentaires. Les champs supplémentaires peuvent inclure des données premium, qui exigent une autre licence, ou des valeurs fréquemment demandées. Les extensions sont actuellement en phase de test. Les valeurs prises en charge pour le paramètre extensions sont les suivantes :
    • review_summary inclut une évaluation complète et concise organisée par l'équipe éditoriale de Google.
  • language (facultatif) — Code langue qui indique la langue dans laquelle les résultats doivent être renvoyés, si possible. Notez que certains champs peuvent ne pas être disponibles dans la langue demandée. Voir la liste des langues prises en charge et leurs codes. Notez que cette liste peut ne pas être exhaustive, car nous mettons régulièrement à jour les langues prises en charge.

L'exemple suivant est une requête de détails d'un lieu par placeid :

https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJN1t_tDeuEmsRUsoyG83frY4&key=YOUR_API_KEY

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

L'exemple suivant utilise le paramètre abandonné reference :

https://maps.googleapis.com/maps/api/place/details/json?reference=CmRYAAAAciqGsTRX1mXRvuXSH2ErwW-jCINE1aLiwP64MCWDN5vkXvXoQGPKldMfmdGyqWSpm7BEYCgDm-iv7Kc2PF7QA7brMAwBbAcqMr5i1f4PwTpaovIZjysCEZTry8Ez30wpEhCNCXpynextCld2EBsDkRKsGhSLayuRyFsex6JA6NPh9dyupoTH3g&key=YOUR_API_KEY

Réponses aux requêtes de détails de lieu

Les réponses aux requêtes de détails de lieu sont renvoyées au format défini par l'indicateur output dans le chemin 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 Road",
            "types" : [ "route" ]
         },
         {
            "long_name" : "Pyrmont",
            "short_name" : "Pyrmont",
            "types" : [ "locality", "political" ]
         },
         {
            "long_name" : "NSW",
            "short_name" : "NSW",
            "types" : [ "administrative_area_level_1", "political" ]
         },
         {
            "long_name" : "AU",
            "short_name" : "AU",
            "types" : [ "country", "political" ]
         },
         {
            "long_name" : "2009",
            "short_name" : "2009",
            "types" : [ "postal_code" ]
         }
      ],
      "formatted_address" : "48 Pirrama Road, Pyrmont NSW, Australia",
      "formatted_phone_number" : "(02) 9374 4000",
      "geometry" : {
         "location" : {
           "lat" : -33.8669710,
           "lng" : 151.1958750
         },
         "viewport" : {
            "northeast" : {
               "lat" : -33.8665053,
               "lng" : 151.1960371
            },
            "southwest" : {
               "lat" : -33.8669293,
               "lng" : 151.1952183
            }
         }
      },
      "icon" : "http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png",
      "id" : "4f89212bf76dde31f092cfc14d7506555d85b5c7",
      "international_phone_number" : "+61 2 9374 4000",
      "name" : "Google Sydney",
      "place_id" : "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "scope" : "GOOGLE",
      "alt_ids" : [
         {
            "place_id" : "D9iJyWEHuEmuEmsRm9hTkapTCrk",
            "scope" : "APP"
         }
      ],
      "rating" : 4.70,
      "reference" : "CnRsAAAA98C4wD-VFvzGq-KHVEFhlHuy1TD1W6UYZw7KjuvfVsKMRZkbCVBVDxXFOOCM108n9PuJMJxeAxix3WB6B16c1p2bY1ZQyOrcu1d9247xQhUmPgYjN37JMo5QBsWipTsnoIZA9yAzA-0pnxFM6yAcDhIQbU0z05f3xD3m9NQnhEDjvBoUw-BdcocVpXzKFcnMXUpf-nkyF1w",
      "reviews" : [
         {
            "aspects" : [
               {
                  "rating" : 3,
                  "type" : "quality"
               }
            ],
            "author_name" : "Simon Bengtsson",
            "author_url" : "https://plus.google.com/104675092887960962573",
            "language" : "en",
            "rating" : 5,
            "text" : "Just went inside to have a look at Google. Amazing.",
            "time" : 1338440552869
         },
         {
           "aspects" : [
              {
                 "rating" : 3,
                 "type" : "quality"
              }
             ],
            "author_name" : "Felix Rauch Valenti",
            "author_url" : "https://plus.google.com/103291556674373289857",
            "language" : "en",
            "rating" : 5,
            "text" : "Best place to work :-)",
            "time" : 1338411244325
         },
         {
           "aspects" : [
              {
                 "rating" : 3,
                 "type" : "quality"
              }
             ],
            "author_name" : "Chris",
            "language" : "en",
            "rating" : 5,
            "text" : "Great place to work, always lots of free food!",
            "time" : 1330467089039
         }
      ],
      "types" : [ "establishment" ],
      "url" : "http://maps.google.com/maps/place?cid=10281119596374313554",
      "vicinity" : "48 Pirrama Road, Pyrmont",
      "website" : "http://www.google.com.au/"
   },
   "status" : "OK"
}
      
XML

<?xml version="1.0" encoding="UTF-8"?>
<PlaceDetailsResponse>
 <status>OK</status>
 <result>
  <name>Google Sydney</name>
  <vicinity>48 Pirrama Road, Pyrmont</vicinity>
  <type>establishment</type>
  <formatted_phone_number>(02) 9374 4000</formatted_phone_number>
  <formatted_address>48 Pirrama Road, Pyrmont NSW, 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 Road</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>NSW</long_name>
   <short_name>NSW</short_name>
   <type>administrative_area_level_1</type>
   <type>political</type>
  </address_component>
  <address_component>
   <long_name>AU</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.8669710</lat>
     <lng>151.1958750</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8669293</lat>
     <lng>151.1952183</lng>
    </southwest>
    <northeast>
     <lat>-33.8665053</lat>
     <lng>151.1960371</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.7</rating>
  <url>http://maps.google.com/maps/place?cid=10281119596374313554</url>
  <icon>http://maps.gstatic.com/mapfiles/place_api/icons/generic_business-71.png</icon>
  <place_id>ChIJN1t_tDeuEmsRUsoyG83frY4</place_id>
  <scope>GOOGLE</scope>
  <alt_ids>
   <place_id>D9iJyWEHuEmuEmsRm9hTkapTCrk</place_id>
   <scope>APP</scope>
  </alt_ids>
  <reference>CnRsAAAAoGXc0eAcQOoO1A7sU58repRnghwM5q7UtsZFhVtjYtfKN_LFAPhdhBfUAU8m0EzeSyP0cDBi7kazZwNjlIMUqktqIanMiymuRDS8c539M6KCJNUMkjw22WXxtl3QoR25fIf-7YJnpza6bMIuFZ1CKBIQuBsbXu8xkbUNofECCkdvmxoU5k3Lpbr8XNCbofIKtsZxj8GloGA</reference>
  <id>4f89212bf76dde31f092cfc14d7506555d85b5c7</id>
  <international_phone_number>+61 2 9374 4000</international_phone_number>
  <website>http://www.google.com.au/</website>
  <review>
   <time>1338440552869</time>
   <text>Just went inside to have a look at Google. Amazing.</text>
   <author_name>Simon Bengtsson</author_name>
   <author_url>https://plus.google.com/104675092887960962573</author_url>
   <language>en</language>
   <rating>5</rating>
   <aspect>
     <type>quality</type>
     <rating>3</rating>
   </aspect>
  </review>
  <review>
   <time>1338411244325</time>
   <text>Best place to work :-)</text>
   <author_name>Felix Rauch Valenti</author_name>
   <author_url>https://plus.google.com/103291556674373289857</author_url>
   <language>en</language>
   <rating>5</rating>
   <aspect>
     <type>quality</type>
     <rating>3</rating>
   </aspect>
  </review>
  <review>
   <time>1330467089039</time>
   <text>Great place to work, always lots of free food!</text>
   <author_name>Chris</author_name>
   <author_url>https://maps.google.com/maps/user?uid=211457841236072500285</author_url>
   <language>en</language>
   <rating>5</rating>
   <aspect>
     <type>quality</type>
     <rating>3</rating>
   </aspect>
  </review>
 </result>
</PlaceDetailsResponse>

Une réponse JSON contient trois éléments racine :

  • "status" contient des métadonnées sur la requête. Voir Codes de statut ci-dessous.
  • "result" contient des informations détaillées sur le lieu demandé. Pour plus d'informations sur ces résultats, voir Résultats de la requête de détails de lieu.
  • "html_attributions" contient plusieurs mentions sur cette liste qui doivent être affichées à l'utilisateur.

Voir Traitement JSON avec Javascript pour obtenir de l'aide sur l'analyse des réponses JSON.

Une réponse XML est constituée d'un élément <PlaceDetailsResponse> unique et de trois éléments de niveau supérieur :

  • <status> contient des métadonnées sur la requête. Voir Codes de statut.
  • Un élément <result> unique contenant des informations détaillées sur un établissement unique. Pour plus d'informations sur ces résultats, voir Résultats de la requête de détails de lieu.
  • <html_attributions> contient plusieurs mentions qui doivent être affichées à l'utilisateur.

Des modèles de conception recommandés pour le traitement des résultats sont disponibles dans la section Analyse XML avec XPath.

Codes de statut

Le champ "status" de l'objet de la réponse à la requête de lieu contient le statut de la requête et éventuellement des informations de débogage qui vous aident à savoir pourquoi la requête de lieu a échoué. Le champ "status" peut contenir les valeurs suivantes :

  • OK indique qu'aucune erreur n'est survenue, que le lieu a été identifié et qu'au moins un résultat a été trouvé.
  • UNKNOWN_ERROR indique une erreur côté serveur ; un nouvel essai pourrait aboutir.
  • ZERO_RESULTS indique que la référence était valide, mais ne correspond plus à un résultat valide. Cette situation peut survenir si l'établissement a cessé son activité.
  • OVER_QUERY_LIMIT indique que vous avez dépassé votre quota.
  • REQUEST_DENIED indique que votre requête a été rejetée, généralement du fait de l'absence d'un paramètre key valide.
  • INVALID_REQUEST indique généralement que la requête (reference) est manquante.
  • NOT_FOUND indique que le point géographique référencé n'a pas été trouvé dans la base de données Places.

Messages d'erreur

Lorsque le service Google Places renvoie un code de statut autre que OK, l'objet de la réponse peut comporter un champ supplémentaire error_message. Ce champ contient des informations plus détaillées sur les causes de ce code de statut.

Résultats des requêtes Place Details

Le service Places renvoie les résultats d'une requête de détails au sein d'un objet result unique. Chaque résultat peut contenir les champs suivants :

  • address_components[] est un ensemble de différents composants d'adresse utilisés pour composer une adresse donnée. Par exemple, l'adresse « 111 8e Avenue, New York, NY » contient des composants d'adresse distincts pour « 111 » (le numéro de rue), « 8e Avenue » (la voie), « New York » (la ville) et « NY » (l'État). Chaque composant address_component contient généralement :
    • types[] est un tableau indiquant le type du composant d'adresse.
    • long_name est une description textuelle complète ou le nom du composant d'adresse.
    • short_name est le nom abrégé du composant d'adresse, le cas échéant. Par exemple, un composant d'adresse pour l'État de l'Alaska peut avoir un nom long (long_name) correspondant à « Alaska » et un nom court (short_name) « AK » utilisant l'abréviation postale à 2 lettres.
  • formatted_address est une chaîne contenant une adresse lisible de ce lieu. Bien souvent, cette adresse équivaut à l'« adresse postale », laquelle diffère parfois d'un pays à l'autre. Cette adresse est généralement composée d'un ou plusieurs champs address_component.
  • formatted_phone_number contient le numéro de téléphone du lieu dans son format local. Par exemple, le numéro local (formatted_phone_number) du bureau de Google à Sydney, Australie, est le (02) 9374 4000.
  • geometry contient les informations suivantes :
    • location contient la valeur latitude,longitude géocodée de ce lieu.
    • viewport contient la fenêtre d'affichage préférée pour l'affichage de ce lieu sur une carte en tant que LatLngBounds si elles sont connues.
  • icon contient l'URL d'une icône proposée pouvant être affichée à l'utilisateur avec l'indication de ce résultat sur une carte.
  • id contient un identifiant fixe unique correspondant à ce lieu. Cet identifiant peut ne pas être utilisé pour extraire des informations sur ce lieu, mais pour regrouper des données qui lui sont associées et en vérifier l'identité dans plusieurs recherches séparées. Dans la mesure où les identifiants sont susceptibles de changer, il est recommandé de comparer l'identifiant conservé pour un lieu à l'identifiant renvoyé dans les requêtes de détails ultérieures pour ce même lieu, et d'apporter les modifications nécessaires, le cas échéant. Remarque : La propriété id est progressivement abandonnée au profit de place_id. Voir l'avis lié à l'abandon sur cette page.
  • international_phone_number 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 numéro international (international_phone_number) du bureau de Google à Sydney, Australie, est le +61 2 9374 4000.
  • name contient le nom lisible du résultat renvoyé. Pour les résultats establishment, il s'agit généralement du nom du professionnel mis en forme canonique.
  • opening_hours contient les informations suivantes :
    • open_now est une valeur booléenne qui indique si le lieu est ouvert actuellement.
    • periods[] est un ensemble de périodes d'ouverture sur 7 jours à partir du dimanche, dans l'ordre chronologique. Chaque période contient les valeurs suivantes :
      • open contient une paire d'objets day et time décrivant le jour et l'heure d'ouverture du lieu :
        • day, un nombre compris entre 0 et 6 correspondant aux jours de la semaine, à partir du dimanche. Par exemple, 2 signifie Mardi.
        • time peut contenir une heure de la journée au format 24 heures (hhmm). Les valeurs sont comprises entre 0000 et 2359. Le paramètre time sera indiqué dans le fuseau horaire du lieu.
      • close peut contenir une paire d'objets day et time décrivant le jour et l'heure de fermeture du lieu. Remarque : Si un lieu est toujours ouvert, la section close sera absente de la réponse. Un lieu toujours ouvert est représenté par une période open contenant le paramètre day avec la valeur 0 et le paramètre time avec la valeur 0000, sans paramètre close.
    • weekday_text est un ensemble de 7 chaînes représentant les heures d'ouverture formatées pour chaque jour de la semaine. Si un paramètre language a été spécifié dans la requête de détails de lieu, le service Places formate et localise les heures d'ouverture en fonction de cette langue. L'ordre des éléments de ce tableau dépend du paramètre language. Pour certaines langues, le premier jour de la semaine est le lundi ; pour d'autres, c'est le dimanche.
  • permanently_closed est un indicateur booléen qui précise si le lieu a fermé définitivement (valeur true). Si le lieu n'a pas fermé définitivement, l'indicateur ne figure pas dans la réponse.
  • photos[] — Ensemble d'objets photo contenant chacun une référence à une image. Une requête de détails de lieu peut renvoyer jusqu'à 10 photos. Pour plus d'informations sur les photos de lieu et comment utiliser les images dans votre application, voir la documentation sur Place Photos. Un objet photo est décrit comme suit :
    • photo_reference — Chaîne utilisée pour identifier la photo lorsque vous lancez une requête de photo.
    • height — Hauteur maximale de l'image.
    • width — Largeur maximale de l'image.
    • html_attributions[] — Contient les mentions requises. Ce champ est toujours présent mais peut être vide.
  • place_id : Identifiant textuel qui identifie un lieu de manière unique. Pour extraire des informations sur le lieu, insérez cet identifiant dans le champ placeid d'une requête Places API. Pour plus d'informations sur les identifiants de lieu, voir la présentation des identifiants de lieu.
  • scope : Spécifie la validité de l'identifiant de lieu (place_id). Les valeurs possibles sont les suivantes :
    • APP : L'identifiant de lieu est reconnu par votre application uniquement. En effet, votre application a ajouté le lieu et ce dernier n'a pas encore été traité par le processus de modération.
    • GOOGLE : Le lieu est disponible pour les autres applications et sur Google Maps.
  • alt_ids — Ensemble d'un ou plusieurs autres identifiants de lieu, ou aucun, avec une validité correspondante pour chacun. Remarque : Cet ensemble peut être vide ou absent. S'il est présent, il contient les champs suivants :
    • place_id — La raison la plus probable pour laquelle un lieu possède un autre identifiant de lieu est le fait que votre application a ajouté un lieu et reçu un identifiant de lieu spécifique avant de recevoir ensuite un identifiant de lieu pour Google une fois le processus de modération passé.
    • scope — La validité d'un autre identifiant de lieu sera toujours APP pour indiquer que cet identifiant de lieu est reconnu par votre application uniquement.
    Par exemple, supposons que votre application ajoute un lieu et reçoit un paramètre place_id AAA pour ce nouveau lieu. Plus tard, le lieu est traité par le processus de modération et reçoit un identifiant Google place_id BBB. À partir de ce moment, les informations sur ce lieu contiennent les paramètres suivants :
        "results" : [
          {
            "place_id" : "BBB",
            "scope" : "GOOGLE",
            "alt_ids" : [
              {
                "place_id" : "AAA",
                "scope" : "APP",
              }
            ],
          }
        ]
        
  • price_level — 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 définitions des niveaux de prix sont les suivantes :
    • 0 — Gratuit
    • 1 — Bon marché
    • 2 — Modéré
    • 3 — Cher
    • 4 — Très cher
  • rating contient la note du lieu, sur une échelle de 1.0 à 5.0, basée sur l'ensemble des avis des utilisateurs.
  • reference contient un jeton pouvant être utilisé pour interroger le service Details (recherche de détails) ultérieurement. Ce jeton peut différer de la référence utilisée dans la requête envoyée au service Details (recherche de détails). Il est recommandé de mettre à jour régulièrement les références stockées pour les lieux. Même si ce jeton identifie le lieu de manière unique, l'inverse n'est pas vrai. Un lieu peut être associé à plusieurs jetons de référence valides. Remarque : La propriété reference est progressivement abandonnée au profit de place_id. Voir l'avis lié à l'abandon de cette page.
  • reviews[], un ensemble JSON de 5 évaluations maximum. Si un paramètre language a été spécifié dans la requête de détails de lieu, le service Places limite les résultats aux évaluations rédigées dans cette langue. Chaque évaluation contient plusieurs composants :
    • aspects contient un groupe d'objets AspectRating, chacun fournissant une note pour un attribut unique de l'établissement. Le premier objet du groupe est considéré comme l'aspect principal. Chaque objet AspectRating se compose comme suit :
      • type, le nom de l'aspect évalué. Les types suivants sont pris en charge : appeal (attrait), atmosphere (ambiance), decor (décor), facilities (commodités), food (nourriture), overall (général), quality (qualité) et service.
      • rating, la note de l'utilisateur pour cet aspect spécifique, sur une échelle de 0 à 3.
    • author_name, le nom de l'utilisateur qui a soumis l'évaluation. Les évaluations anonymes sont associées à l'indication « Utilisateur Google ».
    • author_url, l'URL du profil Google+ de l'utilisateur, si disponible.
    • language, un code langue IETF indiquant la langue utilisée dans l'évaluation de l'utilisateur. Ce champ contient uniquement l'indicateur principal de la langue et non l'indicateur 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.
    • rating, la note globale de l'utilisateur pour ce lieu. Il s'agit d'un nombre entier compris entre 1 et 5.
    • text, l'évaluation de l'utilisateur. Lors de la consultation d'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 marquage HTML simple. Par exemple, la référence d'entité &amp; peut représenter le caractère esperluette.
    • time, l'heure à laquelle l'évaluation a été envoyée, exprimée en nombre de secondes, à partir du 1er janvier 1970, minuit, UTC.
  • types[] contient un ensemble de types de caractéristiques qui décrivent le résultat donné. Pour plus d'informations, voir la liste des types pris en charge. Les réponses XML incluent plusieurs éléments <type> si plusieurs types sont affectés au résultat.
  • url 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.
  • utc_offset contient le décalage en minutes du fuseau horaire de ce lieu par rapport à l'heure UTC. 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), et pour les lieux situés en Californie, en heure d'hiver, ce paramètre est -480 (-8 heures par rapport à l'heure UTC).
  • vicinity indique une adresse simplifiée pour le lieu, y compris la rue, le numéro et la ville, mais sans le département/la province, le code postal ou le pays. Par exemple, pour le bureau de Google à Sydney, Australie, la valeur vicinity est 48 Pirrama Road, Pyrmont.
  • website contient l'adresse du site Web officiel de ce lieu, telle que la page d'accueil d'une entreprise.

Les notes multidimensionnelles peuvent ne pas être disponibles pour tous les lieux. Si le nombre d'évaluations est trop peu élevé, la réponse contenant les détails inclut une note héritée sur une échelle de 1.0 à 5.0 (si disponible) ou aucune note.

Données Premium

Outre les champs répertoriés ci-dessus, les clients Google Places API disposant d'une licence Premium Plan peuvent consulter les champs suivants. Ces champs s'affichent comme enfants de niveau supérieur du champ result.

  • aspects contient un groupe d'objets AspectRating, chacun fournissant une note globale pour un attribut unique de l'établissement. Le premier objet du groupe est considéré comme l'aspect principal. Chaque objet AspectRating se compose comme suit :
    • type, le nom de l'aspect évalué. Par exemple, ambiance, service, cuisine, général, etc.
    • rating, la note globale pour cet aspect spécifique, sur une échelle de 0 à 30. Notez que les notes globales sont comprises entre 0 et 30, tandis que les notes qui s'affichent dans le cadre d'une évaluation vont de 0 à 3.
  • review_summary inclut une évaluation complète et concise organisée par l'équipe éditoriale de Google. Ce champ est absent sauf si vous indiquez le paramètre extensions=review_summary dans la requête de détails. Notez que ce champ peut ne pas être disponible dans la langue demandée.
  • zagat_selected indique que le lieu est référencé dans le guide Zagat. Le label Zagat identifie les lieux connus pour leur qualité supérieure permanente ou leur caractère spécial ou unique.
Pour plus d'informations, voir Données Premium.

L'exemple suivant montre comment les champs aspects et review_summary apparaissent dans le corps de la réponse :

"aspects" : [
   {
      "rating" : 24,
      "type" : "food"
   },
   {
      "rating" : 21,
      "type" : "decor"
   },
   {
      "rating" : 24,
      "type" : "service"
   }
],

...

"review_summary" : "For a meal that's a \"leisurely celebration\",
Mountain View \"foodies\" head to this \"lovely\" old Victorian house, where
\"artful\", \"high-end\" New French tasting dinners that \"look great and taste
even better\" are enhanced by sommelier-selected wines and service that
\"anticipates your every need\"; a garden out back supplies some ingredients,
while four dining areas provide \"lovely decor and ambiance\"; P.S. an
abbreviated tasting menu is also available."

Paramètre sensor

Google Places API Web Service exigeait auparavant l'insertion du paramètre sensor pour savoir si votre application utilisait un capteur afin de déterminer la position géographique de l'utilisateur. Désormais, ce paramètre n'est plus obligatoire.

Envoyer des commentaires concernant…

location_on
Google Places API Web Service