Zurück zu den APIs
Unabhängige Google-Maps-Daten

Google Maps API

Finden Sie öffentliche Orte, rufen Sie normalisierte Details zu bekannten Maps-URLs ab und erfassen Sie öffentliche Bewertungen mit quellenverknüpftem Orts- und Autorenkontext.

Verfügbare Google-Maps-APIs

Verwenden Sie Search für die Suche nach Suchbegriff und Standort, Place Details für bekannte Maps-URLs und Reviews für die begrenzte Erfassung öffentlicher Bewertungen.

Welche Google-Maps-Daten können Sie abrufen?

SocQ liefert normalisierte öffentliche PlaceItem-Datensätze für Standortrecherche, Unternehmenssuche, Datenanreicherung und Marktmomentaufnahmen zu einem bestimmten Zeitpunkt.

Identität des Ortes

Ruft verfügbare Orts-IDs, Namen, Kategorien, Quell-URLs, Datensatztypen und Zeitstempel der Erfassung ab.

Adressen und geografischer Kontext

Behält verfügbare formatierte Adressen, Ortsbezeichnungen, Städte, Regionen, Länder, Breitengrad und Längengrad bei.

Öffentliche Kontaktdaten

Erfasst öffentliche Telefonnummern und Websites, wenn ein Suchergebnis sie bereitstellt.

Bewertungen und Anzahl der Rezensionen

Behält die von der Quelle gemeldete Bewertung und die Anzahl der Rezensionen bei, sofern verfügbar, ohne fehlende Werte abzuleiten.

Beschreibungen und Kategorien

Nutzt verfügbaren Zusammenfassungstext und Kategoriebezeichnungen, um Ortsergebnisse zu klassifizieren und in die engere Auswahl zu nehmen.

Aufgaben- und Paginierungsmetadaten

Verfolgt den Aufgabenstatus und result_count und blättert mit next_cursor und has_more durch die gespeicherten PlaceItem-Datensätze.

Standorttext und Koordinatenkontext

Google Maps Search erfordert immer query und location. Koordinaten sind im aktuellen Laufzeitvertrag optionaler Kontext und kein Ersatz für location.

EingabeoptionVerhalten zur LaufzeitWann sie sich eignet
Nur locationDer Standorttext wird für die Suche mit query kombiniertSuchen nach Stadt, Bezirk, Wahrzeichen oder Adresse
location plus beide Koordinatenlocation bleibt erforderlich, und die Koordinaten werden als lat und long weitergegebenEin geprüftes geografisches Zentrum liegt vor
location plus eine KoordinateDie übergebene Koordinate wird einzeln weitergegebenNur verwenden, wenn der unvollständige geografische Kontext gewollt ist
country und zoom_levelOptionaler Kontext wird mit der Suchzeile weitergegebenDie Anfrage braucht einen Länderhinweis oder einen expliziten Zoom von 0 bis 21

So funktioniert die Google Maps API

Senden Sie eine begrenzte Ortssuche, warten Sie auf die asynchrone Erfassung und blättern Sie durch die für die Aufgabe gespeicherten normalisierten Datensätze.

  1. 1. Ortssuche festlegen

    Wählen Sie eine konkrete query und die erforderliche location und ergänzen Sie nur den geprüften optionalen geografischen Kontext, den Sie brauchen.

  2. 2. Aufgabe senden und verfolgen

    Senden Sie die Anfrage per POST, speichern Sie task_id und fragen Sie /v1/tasks/{task_id} ab, bis die Verarbeitung erfolgreich ist oder fehlschlägt.

  3. 3. Normalisierte Orte lesen

    Verarbeiten Sie data.results.items und folgen Sie next_cursor, solange has_more den Wert true hat.

Öffentliche Orte suchen

Senden Sie eine query und eine location mit einer kleinen Ergebnisobergrenze und lesen Sie die normalisierten PlaceItem-Ergebnisse über den gemeinsamen Aufgaben-Endpunkt.

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

Typische Anwendungsfälle der Google Maps API

Lokale Unternehmenssuche

Finden Sie öffentliche Unternehmen zu einer Kategorie oder einem Service innerhalb einer Stadt, eines Bezirks, eines Wahrzeichens oder eines Adresskontexts.

Anreicherung von Ortsdaten

Ergänzen Sie bestehende Ortskandidaten um verfügbare Felder zu Kontakt, Adresse, Kategorie, Bewertung, Anzahl der Rezensionen, URL und Koordinaten.

Geografische Marktmomentaufnahmen

Erfassen Sie begrenzte Ergebnismengen für getrennt gesendete Gebiete und vergleichen Sie die Abdeckung öffentlicher Orte zu bestimmten Erfassungszeitpunkten.

Prüfwarteschlangen

Erstellen Sie aus öffentlichen Feldern zu Identität, Kontakt, Bewertung und Geografie eine Auswahlliste für die spätere Prüfung oder einen separaten Detailprozess.

Grenzen und Richtlinie für öffentliche Daten

Die Ergebnisse sind öffentliche Datensätze zu einem bestimmten Zeitpunkt. Verfügbarkeit der Suche und Vollständigkeit der Felder hängen davon ab, was die Quelle für die gesendete Anfrage bereitstellt.

  • query und location sind beide erforderliche, nicht leere Zeichenfolgen; location kann nicht durch Koordinaten ersetzt werden.
  • country, latitude, longitude und zoom_level sind optional; die aktuelle Laufzeit akzeptiert latitude und longitude unabhängig voneinander.
  • zoom_level muss eine ganze Zahl von 0 bis 21 sein, und results_limit hat den Standardwert 100 bei einem zulässigen Bereich von 1 bis 2.000.
  • results_limit ist ein Höchstwert für die Erfassung, während das limit des Aufgaben-GET die Größe jeder Antwortseite mit gespeicherten Ergebnissen steuert.
  • Öffentliche Ergebnisse können Beschreibungen, Kategorien, Kontaktdaten, Bewertungen, Anzahl der Rezensionen, URLs oder geografische Unterfelder auslassen.
  • Doppelt bereitgestellte Identitäten werden pro Aufgabe nur einmal gespeichert, sodass result_count niedriger sein kann als die Anzahl der beobachteten Quellzeilen.

Häufige Fragen zur Google Maps API

Was ist die Google Maps API?

Die Google-Maps-APIs suchen asynchron öffentliche Orte, lösen bekannte Orts-URLs auf und erfassen öffentliche Bewertungen als normalisierte Datensätze. Search akzeptiert query und location und liefert PlaceItem-Datensätze mit verfügbaren Feldern zu Identität, Adresse, Kontakt, Bewertung, Anzahl der Rezensionen, URL und Koordinaten.

Was erfordert Search?

Search erfordert nicht leere Zeichenfolgen für query und location. Country, latitude, longitude, zoom_level und results_limit sind optional.

Wie unterscheiden sich Erfassung und Paginierung der Antwort?

results_limit begrenzt die Datensätze, die für die gesendete Suche erfasst werden. Nach einem Erfolg liefert der Aufgaben-Endpunkt die gespeicherten Datensätze seitenweise, gesteuert durch die separaten Parameter limit und next_cursor.

Warum können Ortsfelder null sein?

Ein öffentliches Suchergebnis stellt möglicherweise nicht jedes Feld zu Kontakt, Bewertung, Rezension, Beschreibung, URL, Adresse oder Koordinaten bereit. Das normalisierte Schema behält diese fehlenden Werte als null bei.

Wie werden die Ergebnisse von Google Maps Search abgerechnet?

Jeder gespeicherte Ort kostet 0,15 Credits. Die Vorabschätzung verwendet results_limit oder 100, wenn der Wert fehlt, und beim erfolgreichen Abschluss wird anhand der tatsächlichen Anzahl gespeicherter Ergebnisse abgerechnet.

Führen Sie öffentliche Profile, Inhalte und Interaktionsdaten verschiedener Plattformen in einem Workflow zusammen, um Marken, Creator und Themen zu verfolgen und plattformübergreifend effizienter zu überwachen und zu analysieren.

Google Play API

Erfassen Sie öffentliche Google-Play-App-Details, Kategorie-Rankings und Bewertungen aus bekannten Store-URLs als normalisierte App- und Bewertungsdatensätze.

Amazon API

Durchsuchen Sie öffentliche Amazon-Produkte und erfassen Sie normalisierte Produktdetails, Bestseller, Bewertungen, Verkäuferprofil-Datensätze und Creator-Storefronts aus unterstützten Marktplätzen.

Apple App Store API

Erfassen Sie öffentliche Apple-App-Store-App-Details, Kategorie-Rankings und Bewertungen aus bekannten Store-URLs als normalisierte App- und Bewertungsdatensätze.

SEO API

Fragen Sie live organische Google-Ergebnisse ab, vergleichen Sie Keyword-Nachfrage und Ranking-Schwierigkeit, erweitern Sie Ausgangsbegriffe, finden Sie die Keywords und Seiten, die die Sichtbarkeit einer Website in der Suche bestimmen, klassifizieren Sie die Suchintention und sammeln Sie Ergebnisse aus Google News, Google Images, Google Autocomplete, Bing und YouTube. Jeder Endpunkt nutzt denselben SocQ-API-Schlüssel, denselben asynchronen Aufgabenablauf und dasselbe normalisierte Ergebnisformat.

Telegram API

Lesen Sie öffentliche Telegram-Kanäle über ihre t.me-Links: Kanalprofile mit Abonnentenzahl, Posts mit Aufrufen und Reaktionen, einzelne Posts, Kommentare aus Diskussionsgruppen, ähnliche Kanäle und eine Suche über die gesamte Historie.

Link in Bio API

Machen Sie aus dem einen Link in der Bio auf Instagram, TikTok oder YouTube strukturierte Daten: Anzeigename, Bio, Avatar, angegebene Kontakt-E-Mail, verknüpfte Social-Profile und jeder Button der Seite mit Titel und Ziel.