Google Maps Search
Google Maps Search wandelt eine Anfrage nach einem Unternehmen, einer Kategorie oder einem Ort zusammen mit einem erforderlichen Standort in strukturierte öffentliche Ortsdatensätze um. Jedes gespeicherte Ergebnis nutzt das anbieterunabhängige Schema PlaceItem, sodass verfügbare Felder zu Identität, Adresse, Kontakt, Bewertung, Bewertungsanzahl und Koordinaten in Recherche- und Anreicherungssysteme fließen können, ohne Clients an quellenspezifische Antwortschlüssel zu binden.
Funktionen der Google Maps Search API
- Entdeckung über Suchbegriff und StandortKombinieren Sie eine erforderliche, nicht leere query wie coffee mit einer erforderlichen location wie New York, NY, um passende öffentliche Orte zu finden.
- Optionale geografische SteuerungFügen Sie country, ein Paar aus Breiten- und Längengrad sowie zoom_level hinzu, wenn die Suche einen ausdrücklicheren geografischen Kontext braucht; weggelassene optionale Felder werden nicht erfunden.
- Normalisierte Ortsidentität und KontaktdatenErhalten Sie stabile PlaceItem-Felder für IDs, Quell-URLs, Namen, Kategorien, Adressen, öffentliche Telefonnummern, Websites und, sofern verfügbar, die Erfassungszeit.
- Bewertungen und geografische KoordinatenBehält verfügbare Bewertungen, Bewertungsanzahlen, Stadt, Region, Land, Breiten- und Längengrad bei jedem Ort bei und geht sicher mit fehlenden Quellfeldern um.
Parameter der Google Maps Search API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Erforderlicher, nicht leerer Suchbegriff für einen Ort, ein Unternehmen oder eine Kategorie. |
location | Erforderlich | Erforderliches, nicht leeres, für Menschen lesbares Suchgebiet, zum Beispiel eine Stadt, eine Region oder eine Adresse. Fehlen beide Koordinaten, wird es für die Suche mit der query kombiniert. |
country | Optional | Optionaler, nicht leerer Ländername oder -code, der als geografischer Kontext weitergegeben wird. |
latitude | Optional | Optionaler Breitengrad von -90 bis 90. Er muss zusammen mit longitude angegeben werden. |
longitude | Optional | Optionaler Längengrad von -180 bis 180. Er muss zusammen mit latitude angegeben werden. |
zoom_level | Optional | Optionale ganzzahlige Zoomstufe der Karte von 0 bis 21. |
results_limit | Optional | Maximale Anzahl der zu speichernden Ortsdatensätze; Standardwert ist 100, zulässig sind ganze Zahlen von 1 bis 2.000. |
So verwenden Sie die Google Maps Search API
Senden Sie einen Suchbegriff und einen Standort, verfolgen Sie die asynchrone Aufgabe und lesen Sie die normalisierten Ortsdatensätze per Cursor-Paginierung aus.
- Bereiten Sie eine nicht leere query und location vor; fügen Sie optional country, Koordinaten, zoom_level und ein results_limit von 1 bis 2.000 hinzu.
- Senden Sie die Anfrage per POST an /v1/google-maps/search und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen wird oder einen Fehler meldet.
- Lesen Sie data.results.items und übergeben Sie next_cursor an den Aufgaben-Endpunkt, solange has_more den Wert true behält.
curl -X POST "https://api.socq.ai/v1/google-maps/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"coffee","location":"New York, NY","country":"US","results_limit":3}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueAnwendungsfälle der Google Maps Search API
- Entdeckung lokaler Unternehmen: Erstellen Sie eine begrenzte Liste öffentlicher Unternehmen, die zu einer Kategorie oder Dienstleistung in einer bestimmten Stadt, einem Bezirk oder Adressgebiet passen.
- Anreicherung von Standortdaten: Ergänzen Sie Ortskandidaten, die bereits in einem CRM oder einer Recherche-Warteschlange vorliegen, um verfügbare Namen, Kategorien, Adressen, Telefonnummern, Websites und Koordinaten.
- Markt- und Abdeckungsrecherche: Vergleichen Sie erfasste Ortsanzahlen, Kategorien, Bewertungen und Bewertungsvolumen über unabhängig übermittelte geografische Suchen hinweg.
- Vorbereitung einer Ortsauswahl: Nutzen Sie öffentliche URLs, Kontaktfelder, Bewertungskontext und Koordinaten, um Orte für einen separaten Prüf- oder Detail-Workflow auszuwählen.
Profi-Tipps zur Google Maps Search API
- Verwenden Sie einen konkreten Kategorie- oder Unternehmensbegriff und in location eine eindeutige Stadt, einen Bezirk oder eine Adresse; vage Kombinationen können zu breiten oder mehrdeutigen Treffern führen.
- Senden Sie country, Koordinaten oder zoom_level nur, wenn sie überprüften geografischen Kontext liefern. Geben Sie Breiten- und Längengrad gemeinsam an und halten Sie beide Werte in den dokumentierten Bereichen.
- Halten Sie results_limit nahe an der Zahl der Datensätze, die Sie benötigen. Es steuert die Obergrenze der Erfassung, während das limit im GET der Aufgabe bestimmt, wie viele gespeicherte Datensätze pro Antwortseite zurückkommen.
- Fahren Sie mit next_cursor fort, bis has_more den Wert false hat, wenn die gespeicherten Ergebnisse die erste Antwortseite der Aufgabe übersteigen.
- Behandeln Sie Beschreibungen, Kontaktfelder, Bewertungen, Bewertungsanzahlen und Koordinaten als optionale öffentliche Daten und behalten Sie collected_at für Vergleiche zu bestimmten Zeitpunkten bei.
Verwandte APIs
Ergänzend zur Google Maps Search API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Google Maps-Daten benötigen.