Premium-Daten

Kunden mit einer früheren Google Maps APIs for Work- oder Google Maps API for Business-Lizenz erwerben die Google Places API automatisch im Rahmen der Google Places API for Work. In diesem Abschnitt der Dokumentation wird die Aktivierung von Premium-Daten für diese API beschrieben.

Übersicht

Der Google Places API Web Service bietet Zugriff auf Bewertungen und Kritiken für Tausende von Restaurants, Bars und andere Lokale weltweit. Mit der Funktion Premium-Daten können Sie programmgesteuert auf erweiterte Bewertungsdaten im Rahmen des Google Places API Web Service zugreifen. Wenn die Funktion Premium-Daten aktiviert ist, erhalten Sie zusätzliche Inhalte wie eine 30-Punkte-Bewertung, detaillierte numerische Bewertungen und, sofern verfügbar, eine Zusammenfassung der Kritik.

Die Funktion Premium-Daten setzt auf dem vorhandenen Google Places API Web Service auf. Weitere Informationen finden Sie in der Entwicklerdokumentation.

Aktivierung

Zunächst einmal benötigen Sie Zugriff auf ein Konto, mit dem Sie über den Google Places API Web Service auf Premium-Daten zugreifen können. Nach der Aktivierung Ihres Kontos können Abfragen, die Ihren Schlüssel enthalten, auf erweiterte Kritiken und Bewertungen zugreifen. Die Detailebene in der Antwort variiert zwischen Ortssuche-Anforderungen und Ortsdaten-Anforderungen.

Gehen Sie wie folgt vor, um zu prüfen, ob Ihr Konto in der Google API Console aktiviert wurde.

  1. Gehen Sie zur Google API Console und melden Sie sich mit Ihrem Google-Konto an.
  2. Wählen Sie das Projekt, das bei Ihrer Registrierung für Sie erstellt wurde. Der Projektname beginnt mit Google Maps APIs for Business or Google Maps for Work or Google Maps.
  3. In der Liste aktivierter APIs muss der Dienst Places API - Zagat Content aktiviert sein. Der Dienst Google Places API Web Service muss deaktiviert sein.

Wenn Sie Premium-Daten nutzen möchten, Ihr Projekt aber nicht für Premium-Daten aktiviert ist, wenden Sie sich bitte an Ihren Account Manager.

Premium-Daten – Funktionen

Hinweis: Die Funktion Premium-Daten steht derzeit nur im Google Places API Web Service zur Verfügung. In der Places-Bibliothek der Google Maps JavaScript API ist sie nicht verfügbar.

Ortssuchen

Zusätzlich zu den Standardantwortfeldern können Google Places API for Work-Kunden folgende Felder angezeigt werden. Diese Felder erscheinen als untergeordnete Elemente der obersten Ebene des Felds „result“.

  • aspects (verworfen) enthält ein einziges Objekt AspectRating für die primäre Bewertung dieser Einrichtung. Jedes
    AspectRating wird wie folgt beschrieben:
    • type: Name des bewerteten Aspekts Beispiel: Atmosphäre, Bedienung, Essen, Gesamteindruck usw.
    • rating: Aggregierte Bewertung dieses Aspekts auf einer Skala von 0 bis 30. Beachten Sie, dass aggregierte Bewertungen von 0 bis 30 reichen, während Bewertungen, die im Rahmen einer Kritik erscheinen, von 0 bis 3 reichen.
  • zagat_selected (verworfen) gibt an, dass der Ort als Zagat-Qualitätsort ausgewählt wurde. Das Zagat-Label kennzeichnet Orte, die für ihre konstant hohe Qualität oder ihren besonderen und einzigartigen Charakter bekannt sind.

Ortsdatenanforderungen

Zusätzlich zu den Standardantwortfeldern können Google Places API for Work-Kunden folgende Felder angezeigt werden. Diese Felder erscheinen als untergeordnete Elemente der obersten Ebene des Felds „result“.

  • aspects (verworfen) enthält ein einziges Objekt AspectRating für die primäre Bewertung dieser Einrichtung. Jedes
    AspectRating wird wie folgt beschrieben:
    • type: Name des bewerteten Aspekts Beispiel: Atmosphäre, Bedienung, Essen, Gesamteindruck usw.
    • rating: Aggregierte Bewertung dieses Aspekts auf einer Skala von 0 bis 30. Beachten Sie, dass aggregierte Bewertungen von 0 bis 30 reichen, während Bewertungen, die im Rahmen einer Kritik erscheinen, von 0 bis 3 reichen.
  • review_summary (verworfen) wird einer umfassenden Überprüfung durch die Google-Redaktion unterzogen. Dieses Feld wird nur angezeigt, wenn Sie in Ihrer Ortsdatenanforderung den Parameter extensions=review_summary übergeben.
  • zagat_selected (verworfen) gibt an, dass der Ort als Zagat-Qualitätsort ausgewählt wurde. Das Zagat-Label kennzeichnet Orte, die für ihre konstant hohe Qualität oder ihren besonderen und einzigartigen Charakter bekannt sind.

Antworten auf Ortsdatenanforderungen

Das folgende Beispiel zeigt, wie die Felder aspects und review_summary in der Antwort erscheinen:

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