Google Maps Reviews
Google-Maps-Bewertungen sind öffentliche Rückmeldungen zu Orten, die geschriebenen Text, einen Verweis auf die bewertende Person, eine Sternebewertung, Quell- und Ortslinks, Veröffentlichungs- und Erfassungszeiten sowie Medien enthalten können. Sie unterstützen Feedback-Datensätze mit Quelllink und Vergleiche zwischen bekannten Orten oder Erfassungszeiträumen.
Funktionen der Google Maps Reviews API
- Stapeleingabe bekannter URLsÜbergeben Sie eine oder mehrere unterstützte google.com- oder goo.gl-URLs in einer asynchronen Aufgabe, statt Orte über eine separate Kennungs-API aufzulösen.
- Optionales TagesfensterWenden Sie einen positiven Wert days_limit auf jede übergebene URL-Zeile an, wenn der Workflow ein Fenster für aktuelle Bewertungen benötigt.
- Stabile BewertungsdatensätzeLiest Bewertungsidentität, Text, Felder zur bewertenden Person, Sternebewertung, Ortsverweise, Zeitstempel, Quell-URL und verfügbare Medien über das Bewertungsschema v1.0.
Parameter der Google Maps Reviews API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Eine oder mehrere nicht leere URLs auf google.com, einer beliebigen Subdomain von google.com, goo.gl oder einer Subdomain von goo.gl, getrennt durch Kommas oder Zeilenumbrüche. Verwenden Sie für die Erfassung von Bewertungen bekannte URLs von Maps-Orten. |
days_limit | Optional | Optionale positive ganze Zahl, die auf jede Eingabezeile des Anbieters als Fenster für die Aktualität der Bewertungen angewendet wird. Lassen Sie sie weg, um keinen Filter für das Tagesfenster zu senden. |
results_limit | Optional | Optionale ganze Zahl von 1 bis 2.000, die die Gesamtzahl der für die Aufgabe gespeicherten Bewertungen begrenzt. Der Standardwert ist 100, und je nach Verfügbarkeit der Quelle können weniger Zeilen entstehen. |
So verwenden Sie die Google Maps Reviews API
Senden Sie bekannte Google-Maps-URLs, verfolgen Sie die asynchrone Aufgabe und lesen Sie die gespeicherten Bewertungsdatensätze über den Cursor der Aufgabenergebnisse.
- Bereiten Sie eine oder mehrere unterstützte URLs von Google-Maps-Orten auf google.com oder goo.gl vor.
- Senden Sie urls und bei Bedarf days_limit und results_limit per POST an /v1/google-maps/reviews.
- Fragen Sie /v1/tasks/{task_id} ab, bis status den Wert succeeded oder failed hat.
- Lesen Sie /v1/tasks/{task_id}?limit=50 und fahren Sie mit results.next_cursor fort, solange results.has_more den Wert true hat.
curl -X POST "https://api.socq.ai/v1/google-maps/reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.google.com/maps/place/Coffee%20Project%20New%20York%20%7C%20East%20Village/data=!4m7!3m6!1s0x89c2599b5a24d7fd:0x9e354f6cf514b9fc!8m2!3d40.7270884!4d-73.9893820!16s%2Fg%2F11c3svpqld!19sChIJ_dckWptZwokR_LkU9WxPNZ4?authuser=0&hl=en&rclk=1"],"days_limit":3650,"results_limit":3}'
# Poll GET /v1/tasks/{task_id}, then request
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}.Anwendungsfälle der Google Maps Reviews API
- Feedback-Datensätze zu bekannten Orten: Bereiten Sie Bewertungstext, Sternebewertungen, Veröffentlichungszeiten und Quelllinks für eine festgelegte Menge öffentlicher Orts-URLs auf.
- Recherche zu Bewertenden mit Quellenbezug: Behalten Sie verfügbare Namen und Benutzernamen der Bewertenden, Profillinks und Bewertungs-URLs bei, damit Datensätze auf ihren öffentlichen Kontext zurückführbar bleiben.
- Vergleiche über aktuelle Zeitfenster: Führen Sie dieselbe Ortsmenge zu verschiedenen Zeiten mit dokumentierten days_limit-Werten aus, um begrenzte Erfassungen zu vergleichen, ohne eine lückenlose Historie zu behaupten.
- Bewertungsarchive mit Medien: Halten Sie verfügbare Bewertungsmedien zusammen mit Text, Sternebewertung, Ortsverweis und Erfassungszeit in einem normalisierten Recherchedatensatz.
Profi-Tipps zur Google Maps Reviews API
- Übergeben Sie auflösbare Maps-URLs auf google.com oder goo.gl; ein Ortsname, ein Google-Business-Profile-Konto oder eine Place-ID allein ist kein zulässiges Element von urls.
- Verwenden Sie days_limit nur, wenn ein Fenster in positiven ganzen Tagen sinnvoll ist; ohne diesen Wert bleibt die Zeile des Anbieters ohne diesen Filter.
- Betrachten Sie results_limit als eine globale Obergrenze gespeicherter Ergebnisse über den gesamten URL-Stapel und nicht als Zusage pro URL.
- Halten Sie das results_limit der Übermittlung getrennt vom limit beim Lesen der Aufgabe: Letzteres steuert die Seitengröße von 1 bis 500 und arbeitet mit einem undurchsichtigen Cursor.
- Rechnen Sie damit, dass Text, Attribute der Bewertenden, Sternebewertung, Bezugsverweise, Zeitstempel und Medien fehlen, wenn die öffentliche Quelle sie nicht bereitstellt.
Verwandte APIs
Ergänzend zur Google Maps Reviews API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Google Maps-Daten benötigen.
- Google Maps Search API — Öffentliche Orte auf Google Maps per Suchanfrage und Standort suchen – mit normalisierten Feldern zu Identität, Adresse, Kontakt, Sternebewertung, Bewertungsanzahl, URL und Koordinaten.
- Google Maps Place Details API