google-maps/
search

Öffentliche Orte in Google Maps per Suchbegriff und Standort suchen – mit normalisierten Namen, Kategorien, Adressen, Kontaktdaten, Bewertungen, Bewertungsanzahlen, URLs und Koordinaten.

Google Maps Search API

Eingabe aus Suchbegriff und Standort
Optionaler geografischer Kontext
1 bis 2.000 angeforderte Ergebnisse
Normalisierte Ortsdatensätze
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 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

ParameterErforderlichBeschreibung
queryErforderlichErforderlicher, nicht leerer Suchbegriff für einen Ort, ein Unternehmen oder eine Kategorie.
locationErforderlichErforderliches, 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.
countryOptionalOptionaler, nicht leerer Ländername oder -code, der als geografischer Kontext weitergegeben wird.
latitudeOptionalOptionaler Breitengrad von -90 bis 90. Er muss zusammen mit longitude angegeben werden.
longitudeOptionalOptionaler Längengrad von -180 bis 180. Er muss zusammen mit latitude angegeben werden.
zoom_levelOptionalOptionale ganzzahlige Zoomstufe der Karte von 0 bis 21.
results_limitOptionalMaximale 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.

  1. 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.
  2. Senden Sie die Anfrage per POST an /v1/google-maps/search und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen wird oder einen Fehler meldet.
  4. 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 true

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

Ergänzend zur Google Maps Search API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Google Maps-Daten benötigen.

Weitere Plattformen entdecken

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

Google Maps Search API — FAQ

Google Maps Search API ist eine asynchrone Schnittstelle zum Finden öffentlicher Orte anhand einer erforderlichen Suchanfrage und eines Standorts. Sie liefert anbieterunabhängige PlaceItem-Datensätze mit verfügbaren Feldern zu Identität, Kategorie, Adresse, Kontakt, Bewertung, Bewertungsanzahl, URL und Geografie.

query und location sind beide erforderliche, nicht leere Zeichenfolgen. country, latitude, longitude, zoom_level und results_limit sind optional.

Ja. Die aktuelle Anfragespezifikation akzeptiert Koordinaten nur als Paar. Lassen Sie beide weg, um location mit query zu kombinieren, oder geben Sie latitude von -90 bis 90 zusammen mit longitude von -180 bis 180 an.

results_limit ist ein Höchstwert der Erfassung und keine Garantie. Die Quelle kann weniger öffentliche Treffer liefern, und Datensätze mit derselben sichtbaren Identität werden pro Aufgabe nur einmal gespeichert.

Ein öffentliches Ortsergebnis kann Beschreibung, Kategorie, Adresse, Telefon, Website, Bewertung, Bewertungsanzahl, URL oder einzelne Standortfelder auslassen. Clients sollten null-Werte verarbeiten, ohne sie als Fehler der Aufgabe zu behandeln.

Jeder gespeicherte Ortsdatensatz kostet 0,15 SocQ-Credits. Die Vorabbelastung richtet sich nach results_limit oder nach 100, wenn der Wert fehlt; nach dem Erfolg wird anhand der tatsächlich gespeicherten Ergebnisse abgerechnet, und ein leeres Ergebnis verursacht keine ergebnisabhängigen Kosten.