Données Premium

Pour les clients disposant d'une licence antérieure de Google Maps APIs for Work ou de Google Maps API for Business, Google Places API est inclus avec Google Places API for Work. Cette section de la documentation décrit l'activation des Données Premium pour cette API.

Présentation

Google Places API Web Service donne accès aux notes et aux avis sur des milliers de restaurants, bars et autres lieux de par le monde. Avec la fonctionnalité Données Premium, vous pouvez accéder par programmation à des données d'évaluation améliorées dans le cadre du Google Places API Web Service. Lorsque la fonctionnalité Données Premium est activée, vous recevez du contenu supplémentaire, comme un score de 30 points, des évaluations numériques détaillées et, le cas échéant, un récapitulatif des évaluations.

La fonctionnalité Données Premium s'appuie sur le Google Places API Web Service existant. Consultez la documentation pour les développeurs pour en savoir plus.

Activation

Avant de commencer, vous devez avoir accès à un compte ayant accès aux Données Premium depuis le Google Places API Web Service. Une fois que votre compte est activé, les requêtes contenant votre clé peuvent accéder aux évaluations et notes améliorées. Le niveau de détail de la réponse varie entre les requêtes Place Search et les requêtes Place Details.

Vous pouvez vérifier que votre compte est activé dans la Google API Console en procédant comme suit.

  1. Accédez à la Google API Console et connectez-vous à l'aide de votre compte Google.
  2. Sélectionnez le projet créé pour vous lors de l'inscription. Le nom du projet commencera par Google Maps APIs for Business or Google Maps for Work or Google Maps.
  3. Dans la liste Enabled APIs, le service Places API - Zagat Content doit être activé. Le service Google Places API Web Service doit être désactivé.

Si vous souhaitez accéder aux Données Premium, mais que votre projet n'est pas activé pour cette fonctionnalité, contactez votre gestionnaire de compte.

Fonctionnalités des Données Premium

Remarque : La fonctionnalité Données Premium est actuellement disponible uniquement dans Google Places API Web Service . Elle n'est pas disponible dans la bibliothèque Google Maps JavaScript API Places.

Recherches de lieux

En plus des champs de réponse standard, les clients Google Places API for Work peuvent recevoir les champs suivants. Ces champs apparaîtront en tant qu'enfants de niveau supérieur du champ de résultat.

  • aspects (obsolète) contient un objet
    AspectRating unique, pour la note principale de cet établissement. Chaque objet
    AspectRating se compose comme suit :
    • type : le nom de l'aspect évalué. Ex.  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.
  • zagat_selected (obsolète) 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.

Requêtes de détails de lieu

En plus des champs de réponse standard, les clients Google Places API for Work peuvent recevoir les champs suivants. Ces champs apparaîtront en tant qu'enfants de niveau supérieur du champ de résultat.

  • aspects (obsolète) contient un objet
    AspectRating unique, pour la note principale de cet établissement. Chaque objet
    AspectRating se compose comme suit :
    • type : le nom de l'aspect évalué. Ex.  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 (obsolète) 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.
  • zagat_selected (obsolète) 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.

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

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