Torna alle API
Dati indipendenti di Google Maps

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 inputComportamento a runtimeQuando usarla
solo locationIl testo della località viene combinato con query per la ricercaRicerche guidate da città, quartiere, punto di riferimento o indirizzo
location più entrambe le coordinatelocation resta obbligatoria e le coordinate vengono inoltrate come lat e longÈ disponibile un centro geografico verificato
location più una sola coordinataLa coordinata fornita viene inoltrata in modo indipendenteUsala solo quando il contesto geografico parziale è voluto
country e zoom_levelIl contesto facoltativo viene inoltrato con la riga di ricercaLa 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. 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. 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. 3. Leggi i luoghi normalizzati

    Elabora data.results.items e segui next_cursor finché has_more è true.

Cerca i luoghi pubblici

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 true

Casi 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.

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.