Google Maps Place Details
Öffentliche Ortsseiten in Google Maps können Namen, Kategorien, Beschreibungen, Adressen, Kontaktdaten, Bewertungen, Bewertungsanzahlen, Websites und geografischen Kontext zeigen. Normalisierte Datensätze erleichtern es, diese sichtbaren Felder mit Standortbeständen, Recherchen zu Lokalitäten, der Anreicherung von Verzeichnissen und der Beobachtung zu bestimmten Zeitpunkten zu verbinden.
Funktionen der Google Maps Place Details API
- Erfassung von Details per URL-StapelÜbergeben Sie eine oder mehrere bekannte Google-Maps-URLs; jede nicht leere Eingabe wird zu einer Detailzeile des Anbieters, intern begrenzt auf die Zahl der übergebenen URLs.
- Stabile OrtsdatensätzeLiefert Identität, Quell-URL, Name, Beschreibung, Kategorie, Adresse, Telefon, Website, Bewertung und Bewertungsanzahl über das Schema PlaceItem.
- Strukturierter geografischer KontextHält verfügbaren Standortnamen, Stadt, Region, Land, Breiten- und Längengrad zusammen, statt sie aus Darstellungstext zu parsen.
- Ergebnisbasierte AbrechnungDie Schätzung beträgt 0,15 Credits pro übergebener URL; abgerechnet werden anschließend 0,15 Credits für jeden erfolgreich zurückgegebenen Standard-Ortsdatensatz, leere Ergebnisse sind kostenlos.
Parameter der Google Maps Place Details API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliches, nicht leeres Array von Verweisen, aus denen der Parser einen Hostnamen ermitteln kann. Die Laufzeit akzeptiert google.com, goo.gl und deren Subdomains anhand des Hostnamens; sie akzeptiert jedes Schema mit Authority-Komponente sowie protokollrelative Verweise und verlangt kein bestimmtes Pfadmuster. |
So verwenden Sie die Google Maps Place Details API
Senden Sie bekannte Google-Maps-URLs, verfolgen Sie die asynchrone Aufgabe und lesen Sie jedes gespeicherte PlaceItem über die Standardstruktur der Cursor-Ergebnisse.
- Bereiten Sie eine oder mehrere Verweise vor, deren geparster Hostname google.com, goo.gl oder eine Subdomain eines der beiden akzeptierten Hosts ist.
- Senden Sie urls per POST an /v1/google-maps/place-details und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen wird oder fehlschlägt.
- Lesen Sie data.results.items und folgen Sie next_cursor, solange has_more den Wert true hat; die Sendeanfrage selbst hat kein Feld results_limit.
curl -X POST "https://api.socq.ai/v1/google-maps/place-details" \
-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"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der Google Maps Place Details API
- Anreicherung von Standortverzeichnissen: Ergänzen Sie bekannte Orts-URLs um normalisierte Felder zu Kategorie, Adresse, Telefon, Website, Bewertung, Bewertungsanzahl und Koordinaten.
- Prüfung von Lokalitäten und Filialen: Rufen Sie eine kontrollierte URL-Liste erneut ab, um sichtbare Identitäts-, Kontakt-, Bewertungs- und Geowerte zu festgelegten Erfassungszeitpunkten zu vergleichen.
- Abgleich von Ortsdatensätzen: Ordnen Sie öffentliche Orte mithilfe der zurückgegebenen IDs, Quell-URLs, Namen, Adressen und Koordinaten internen Standortdatensätzen zu.
Profi-Tipps zur Google Maps Place Details API
- Übergeben Sie vollständige absolute Maps-URLs, damit der Parser einen akzeptierten Hostnamen auflösen kann; bloße Hostnamen ohne Schema liefern im Parser der Laufzeit keinen Hostnamen.
- Fügen Sie keine Place-IDs, Google-API-Schlüssel, Feldmasken oder results_limit hinzu, denn sie sind keine Felder dieser SocQ-Anfragespezifikation.
- Behandeln Sie jede übergebene URL als Kandidaten für Details und nicht als garantiertes Ergebnis; nicht verfügbare oder unbrauchbare Quellzeilen können dazu führen, dass es weniger Elemente als URLs gibt.
- Behalten Sie nullable Angaben zu Telefon, Website, Bewertung, Bewertungsanzahl, Beschreibung, Veröffentlichungszeit und Standort bei, statt Ersatzwerte zu erfinden.
- Folgen Sie next_cursor, solange has_more den Wert true hat, denn die Paginierung greift beim Lesen gespeicherter Aufgabenergebnisse, auch wenn die Obergrenze des Anbieters aus der Zahl der URLs stammt.
Verwandte APIs
Ergänzend zur Google Maps Place Details 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 Reviews API