Google Maps API
Trova i luoghi pubblici, recupera dettagli normalizzati da URL noti di Maps e raccogli le recensioni pubbliche con il contesto di luogo e autore collegato alla fonte.
API di Google Maps disponibili
Usa Search per la ricerca con query e località, Place Details per gli URL noti di Maps e Reviews per la raccolta limitata di recensioni pubbliche.
Quali dati di Google Maps puoi recuperare?
SocQ restituisce record PlaceItem pubblici normalizzati, per ricerche sulle località, scoperta di attività, arricchimento dei dati e istantanee di mercato in un dato momento.
Identità del luogo
Recupera ID dei luoghi, nomi, categorie, URL di origine, tipi di record e timestamp di raccolta, quando disponibili.
Indirizzi e contesto geografico
Conserva indirizzi formattati, etichette di località, città, regioni, paesi, latitudine e longitudine, quando disponibili.
Contatti pubblici
Raccogli numeri di telefono e siti web pubblici quando un risultato di ricerca li espone.
Valutazioni e numero di recensioni
Mantieni la valutazione e il numero di recensioni riportati dalla fonte, quando disponibili, senza dedurre i valori mancanti.
Descrizioni e categorie
Usa il testo di sintesi e le etichette di categoria disponibili per classificare e selezionare i risultati sui luoghi.
Metadati di attività e paginazione
Segui lo stato dell’attività e result_count, poi scorri i record PlaceItem salvati con next_cursor e has_more.
Testo della località e contesto delle coordinate
Google Maps Search richiede sempre query e location. Nella specifica attuale le coordinate sono un contesto facoltativo e non sostituiscono location.
| Scelta di input | Comportamento a runtime | Quando usarla |
|---|---|---|
| solo location | Il testo della località viene combinato con query per la ricerca | Ricerche guidate da città, quartiere, punto di riferimento o indirizzo |
| location più entrambe le coordinate | location resta obbligatoria e le coordinate vengono inoltrate come lat e long | È disponibile un centro geografico verificato |
| location più una sola coordinata | La coordinata fornita viene inoltrata in modo indipendente | Usala solo quando il contesto geografico parziale è voluto |
| country e zoom_level | Il contesto facoltativo viene inoltrato con la riga di ricerca | La richiesta ha bisogno di un suggerimento sul paese o di uno zoom esplicito da 0 a 21 |
Come funzionano le API di Google Maps
Invia una ricerca di luoghi limitata, attendi la raccolta asincrona e scorri i record normalizzati salvati per l’attività.
1. Definisci la ricerca di luoghi
Scegli una query specifica e la località obbligatoria, poi aggiungi solo il contesto geografico facoltativo verificato che ti serve.
2. Invia e segui l’attività
Invia la richiesta con POST, salva il task_id e interroga /v1/tasks/{task_id} finché l’elaborazione ha successo o fallisce.
3. Leggi i luoghi normalizzati
Elabora data.results.items e segui next_cursor finché has_more è true.
Invia una query e una località con un piccolo limite di risultati, poi leggi i risultati PlaceItem normalizzati dall’endpoint condiviso delle attività.
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 trueCasi d’uso comuni delle API di Google Maps
Ricerca di attività locali
Trova le attività pubbliche che corrispondono a una categoria o a un servizio all’interno di una città, un quartiere, un punto di riferimento o un indirizzo.
Arricchimento dei dati sui luoghi
Aggiungi contatti, indirizzo, categoria, valutazione, numero di recensioni, URL e coordinate disponibili ai luoghi candidati già in tuo possesso.
Istantanee di mercato geografiche
Raccogli insiemi limitati di risultati per aree inviate separatamente e confronta la copertura pubblica dei luoghi in momenti di raccolta specifici.
Code di verifica
Crea una selezione a partire dai campi pubblici di identità, contatto, valutazione e geografia, per una revisione successiva o per un processo di dettaglio separato.
Limiti e policy sui dati pubblici
I risultati sono record pubblici rilevati in un dato momento. La disponibilità della ricerca e la completezza dei campi dipendono da ciò che la fonte espone per la richiesta inviata.
- query e location sono entrambe stringhe obbligatorie e non vuote; location non può essere sostituita dalle coordinate.
- country, latitude, longitude e zoom_level sono facoltativi; la specifica attuale accetta latitude e longitude in modo indipendente.
- zoom_level deve essere un intero da 0 a 21 e results_limit ha come valore predefinito 100, con un intervallo accettato da 1 a 2.000.
- results_limit è un massimo di raccolta, mentre il limit del GET dell’attività controlla ogni pagina di risposta dei risultati salvati.
- I risultati pubblici possono omettere descrizioni, categorie, contatti, valutazioni, numero di recensioni, URL o sottocampi geografici.
- Le identità esposte duplicate vengono salvate una sola volta per attività, quindi result_count può essere inferiore al numero di righe della fonte osservate.
Domande frequenti sulle API di Google Maps
Che cosa sono le API di Google Maps?
Le API di Google Maps cercano in modo asincrono i luoghi pubblici, risolvono gli URL noti dei luoghi e raccolgono le recensioni pubbliche come record normalizzati. Search accetta query e location e restituisce record PlaceItem con i campi disponibili di identità, indirizzo, contatti, valutazione, numero di recensioni, URL e coordinate.
Che cosa richiede Search?
Search richiede stringhe query e location non vuote. Country, latitude, longitude, zoom_level e results_limit sono facoltativi.
In che cosa differiscono la raccolta e la paginazione della risposta?
results_limit limita i record raccolti per la ricerca inviata. Dopo il successo, l’endpoint delle attività restituisce i record salvati in pagine controllate dai suoi parametri separati limit e next_cursor.
Perché i campi dei luoghi possono essere null?
Un risultato di ricerca pubblico può non esporre ogni campo di contatto, valutazione, recensione, descrizione, URL, indirizzo o coordinata. Lo schema normalizzato mantiene questi valori mancanti come null.
Come vengono fatturati i risultati di Google Maps Search?
Ogni luogo salvato costa 0,15 crediti. La stima del pagamento anticipato usa results_limit, oppure 100 se è omesso, e il completamento riuscito viene regolato sul numero effettivo di risultati salvati.
Combina i dati di più piattaforme per analisi di business più complete
Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.
Google Play API
Raccogli dettagli delle app, classifiche per categoria e recensioni pubblici di Google Play da URL noti dello store, come record normalizzati di app e recensioni.
Amazon API
Cerca i prodotti pubblici di Amazon e raccogli dettagli dei prodotti, Best Sellers, recensioni, profili dei venditori e vetrine dei creator normalizzati dai marketplace supportati.
Apple App Store API
Raccogli dettagli delle app, classifiche per categoria e recensioni pubblici di Apple App Store da URL noti dello store, come record normalizzati di app e recensioni.
SEO API
Interroga in tempo reale i risultati organici di Google, confronta domanda delle parole chiave e difficoltà di posizionamento, espandi i termini di partenza, scopri le parole chiave e le pagine che determinano la visibilità di un sito nelle ricerche, classifica l’intento di ricerca e raccogli i risultati di Google News, Google Images, Google Autocomplete, Bing e YouTube. Ogni endpoint usa la stessa chiave API di SocQ, lo stesso flusso di attività asincrono e lo stesso formato di risultati normalizzato.
Telegram API
Leggi i canali Telegram pubblici dai loro link t.me: profili dei canali con iscritti, post con visualizzazioni e reazioni, singoli post, commenti dei gruppi di discussione, canali simili e ricerca in tutto lo storico.
Link in Bio API
Trasforma l’unico link nella bio Instagram, TikTok o YouTube di un creator in dati strutturati: nome visualizzato, bio, avatar, email di contatto indicata, profili social collegati e ogni pulsante della pagina con titolo e destinazione.


