google-maps/
place-details

Details zu bekannten öffentlichen Google-Maps-URLs sammeln – mit normalisierten Feldern zu Ortsidentität, Kategorie, Adresse, Kontakt, Bewertung, Bewertungsanzahl, Website und Geografie.

Google Maps Place Details API

Bekannte Maps-URLs
Ortsdetails
Normalisierte Standorte
0,15 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

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

ParameterErforderlichBeschreibung
urlsErforderlichErforderliches, 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.

  1. Bereiten Sie eine oder mehrere Verweise vor, deren geparster Hostname google.com, goo.gl oder eine Subdomain eines der beiden akzeptierten Hosts ist.
  2. Senden Sie urls per POST an /v1/google-maps/place-details und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen wird oder fehlschlägt.
  4. 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 true

Anwendungsfä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.

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

Weitere Plattformen entdecken

Kombinieren Sie Google Maps-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

Google Maps Place Details API — FAQ

Google Maps Place Details API wandelt bekannte öffentliche Google-Maps-URLs in normalisierte PlaceItem-Datensätze um. Sie liefert verfügbare Felder zu Identität, Kategorie, Kontakt, Bewertung, Bewertungsanzahl, Adresse, Website und Standort.

Übergeben Sie Verweise, deren geparster Hostname google.com, goo.gl oder eine Subdomain eines der beiden Hosts ist. Jedes Schema wird akzeptiert, wenn Authority und Hostname vorhanden sind, protokollrelative Verweise werden ebenfalls akzeptiert, und ein bestimmter Pfad /maps/place ist nicht erforderlich.

Nein. Die Anfrage nimmt über SocQ bekannte öffentliche Google-Maps-URLs entgegen und akzeptiert weder eine offizielle Place-ID noch einen Google-API-Schlüssel, eine OAuth-Zugangsberechtigung oder eine Feldmaske.

Nein. Die Eingabe für den Anbieter enthält eine Detailzeile pro nicht leerer URL und eine interne Obergrenze in Höhe dieser Zeilenzahl; results_limit ist kein öffentliches Anfragefeld.

Eine Quell-URL kann nicht verfügbar sein, eine Fehlerzeile liefern oder keinen verwertbaren normalisierten Ort ergeben. Die übrigen übergebenen URLs werden unabhängig davon weiterverarbeitet.

Fragen Sie GET /v1/tasks/{task_id} ab, lesen Sie nach dem Erfolg data.results.items und fordern Sie mit next_cursor die nächste Seite an, solange has_more den Wert true hat.

Die Schätzung beträgt 0,15 SocQ-Credits pro nicht leerer übergebener URL. Abgerechnet werden 0,15 Credits pro erfolgreich zurückgegebenem Standard-Ortsdatensatz, und ein leeres Ergebnis kostet null Credits.