G Maps Crawl per sviluppatori

Dati di Google Maps.
Integrati nel Suo workflow.

Cerchi attività, legga recensioni pubbliche e sfoghi foto e video dei luoghi. Sviluppi con un'API REST sincrona o dia al Suo assistente AI l'accesso tramite MCP.

JSON strutturato

Risultati nella stessa risposta

REST + MCP

Usi la Sua applicazione o il client AI

Una quota API

Condivisa tra richieste API e MCP

Scelga i Suoi dati

Un'API per ogni fase della Sua ricerca

Inizi con una ricerca di attività, poi usi il feature ID del luogo per richiedere recensioni o elementi della galleria. Ogni API ha i propri esempi e il riferimento dei campi.

La Sua prima richiesta API

Passi da una richiesta a dati strutturati

Usi una chiave API nell'header Authorization. Esplori i formati di richiesta qui sotto, poi segua la guida rapida per effettuare la Sua prima chiamata.

Esempi di richiesta

Per il contratto completo, consulti la documentazione API.

curl https://gmapscrawl.com/api/v1/search \
  -H "Authorization: Bearer $GMSCRAPER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seattle-coffee-search-001" \
  -d '{"q":"coffee shops in Seattle","page":1,"extra":false}'

Risposta vuota illustrativa. Una ricerca live restituisce le attività disponibili. Conservi la Sua chiave API lato server; usi una nuova chiave di idempotenza per nuovo lavoro e la conservi per un retry invariato.

Risposta

JSON illustrativo
{
  "data": {
    "total": 0,
    "params": {
      "q": "coffee shops in Seattle",
      "page": 1,
      "hl": "en",
      "extra": false
    },
    "businesses": []
  },
  "request_id": "req_example",
  "schema_version": "2026-09-22"
}

L'API restituisce JSON nella stessa risposta. Dopo un timeout, riprovi il body invariato con la stessa Idempotency-Key. Le credenziali di test restituiscono dati simulati senza usare la Sua quota live.

Sviluppi con HTTP standard

Una piccola integrazione. Un workflow di dati utile.

01

Crei una chiave API

Crei una credenziale nella Sua area di lavoro API e la conservi nella configurazione segreta del Suo server o client. REST e MCP usano la stessa quota API.

Apra le chiavi API
02

Scelga un'API

Cerchi con una parola chiave e una località. Per recensioni e foto, fornisca il feature ID di Maps che già possiede o legga place.dataId da un risultato di ricerca.

Segua la guida rapida
03

Legga la risposta JSON

Elabori la pagina restituita nella Sua applicazione. Segua le regole di paginazione dell'endpoint, ispezioni i campi mancanti e conservi la chiave di idempotenza della richiesta per i retry.

Comprenda la paginazione

Costruisca qualcosa di utile

Porti i dati di Maps nella Sua applicazione

Usi i record restituiti come input per le Sue ricerche, report e workflow interni.

01

Ricerca su attività locali

Cerchi una categoria e una località, poi organizzi nomi di attività, indirizzi, siti web, numeri di telefono e valutazioni disponibili nella Sua applicazione.

02

Analisi delle recensioni

Consulti le recensioni pubbliche di un luogo per studiare il feedback dei clienti. Scelga un ordinamento coerente e segua le pagine disponibili per la Sua analisi.

03

Ricerca sulla galleria di un luogo

Recuperi i link di foto e video disponibili per un luogo. Conservi il link della galleria di origine accanto ai record, così il Suo team potrà ispezionare il contesto originale.

Il Suo agente, connesso

Usi gli stessi dati tramite il Suo client AI.

Collegi il server MCP per strumenti rilevabili, oppure installi l'Agent Skill per istruzioni di workflow riutilizzabili e un fallback REST.

Attività di esempio per il Suo agente connesso

«Cerchi una pagina di caffetterie a Seattle. Restituisca nomi, siti web e valutazioni disponibili e segnali i dati mancanti.»

Le richieste usano la Sua quota API. Con una credenziale di test, i risultati sono simulati.

Pianifichi la Sua integrazione

Comprenda l'uso prima di scalare

Ogni pagina live riuscita, inclusa una pagina vuota, usa una richiesta API. REST e MCP condividono il Suo piano API; le quote Online ed Estensione sono separate.

Mantenga le richieste prevedibili

Inizi con una pagina, controlli i campi restituiti e imposti un timeout del client appropriato per l'endpoint. Per i retry, riusi la stessa Idempotency-Key con un body di richiesta invariato.

I limiti del piano, i rate limit, la disponibilità della sorgente e l'arricchimento influiscono sulle richieste live. Le credenziali di test restituiscono fixture simulati senza consumare la Sua quota live.

Usi le pagine degli endpoint per i limiti di richiesta e i campi dei risultati. La pagina dei prezzi elenca le richieste incluse attuali e le tariffe per eccedenze a pagamento.

Domande frequenti

Quali API di Google Maps sono disponibili?

G Maps Crawl offre API di ricerca di attività, recensioni pubbliche di luoghi e foto/galleria di luoghi. La ricerca restituisce record di attività; Reviews e Photos usano un feature ID di Maps per restituire una pagina di un luogo specifico.

Posso usare Python o JavaScript?

Sì. Le API usano richieste HTTP e JSON, quindi può chiamarle con Python, JavaScript, cURL o un altro client HTTP. Ogni pagina API include esempi di richiesta e una risposta di esempio.

Devo interrogare il risultato di un job?

Le API pubbliche Search, Reviews e Photos restituiscono JSON nella stessa risposta. Non richiedono polling di job né configurazione di webhook. Segua la guida su timeout e retry dell'endpoint.

Come funzionano insieme API, MCP e l'Agent Skill?

REST consente alla Sua applicazione di chiamare direttamente un endpoint. MCP rende gli strumenti disponibili a un client AI compatibile. L'Agent Skill fornisce istruzioni di workflow e script di supporto. Le richieste REST e MCP richiedono credenziali API e usano la Sua quota API.

Dove trovo un feature ID per recensioni e foto?

Usi un feature ID di Maps che già possiede, oppure copi place.dataId da un record corrispondente nell'array data.businesses dell'API Search. Passi quel valore come fid all'API Reviews o Photos.

La disponibilità di ogni campo è garantita?

No. I campi restituiti dipendono dalla sorgente e dall'operazione selezionata. Ispezioni i valori mancanti e i timestamp di osservazione disponibili prima di usare i dati. Una risposta riuscita può contenere una pagina vuota.

Faccia il passo successivo

Costruisca il Suo primo workflow di dati di Google Maps.

Crei una chiave API, inizi con una richiesta ed esplori i dati che la Sua applicazione può usare.