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.
| Eingabeoption | Verhalten zur Laufzeit | Wann sie sich eignet |
|---|---|---|
| Nur location | Der Standorttext wird für die Suche mit query kombiniert | Suchen nach Stadt, Bezirk, Wahrzeichen oder Adresse |
| location plus beide Koordinaten | location bleibt erforderlich, und die Koordinaten werden als lat und long weitergegeben | Ein geprüftes geografisches Zentrum liegt vor |
| location plus eine Koordinate | Die übergebene Koordinate wird einzeln weitergegeben | Nur verwenden, wenn der unvollständige geografische Kontext gewollt ist |
| country und zoom_level | Optionaler Kontext wird mit der Suchzeile weitergegeben | Die 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. 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. 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. Normalisierte Orte lesen
Verarbeiten Sie data.results.items und folgen Sie next_cursor, solange has_more den Wert true hat.
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 trueTypische 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.
Daten verschiedener Plattformen kombinieren und umfassendere Geschäftseinblicke gewinnen
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.


