POST /api/v2/photos

API di scraping di foto di Google Maps

Legga fino a 20 elementi di galleria di un luogo per pagina. Ottenga URL di foto e video nell'ordine in cui appaiono nella galleria.

Esempi di richiesta

Per il contratto completo, consulti la documentazione API.

curl https://gmapscrawl.com/api/v2/photos \
  -H "Authorization: Bearer $GMSCRAPER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: place-photos-page-1-example" \
  -d '{"fid":"0x89c259af336b3341:0xa4969e07ce3108de","page":1}'

Sostituisca il fid di esempio con il feature ID del Suo luogo. La risposta è simulata; gli URL dei media di example.com sono segnaposto. Conservi la stessa chiave di idempotenza e lo stesso body quando riprova una richiesta in corso.

Risposta

JSON illustrativo
{
  "photos": [
    {
      "photoUrl": "https://example.com/gallery-image.jpg"
    },
    {
      "photoUrl": "https://example.com/gallery-preview.jpg",
      "videoUrl": "https://example.com/gallery-video.mp4"
    }
  ],
  "next": false,
  "total": 2,
  "url": "https://www.google.com/maps/uv?pb=!1s0x89c259af336b3341:0xa4969e07ce3108de!15sCgIgAQ",
  "params": {
    "fid": "0x89c259af336b3341:0xa4969e07ce3108de",
    "page": 1
  }
}

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.

Inizi con un luogo

Apra la galleria pubblica di un luogo.

Richieda metadati di immagini e video per un singolo luogo usando il suo feature ID.

Parametri di richiesta dell'API di scraping di foto di Google Maps
CampoSignificato
fid · obbligatorioUn feature ID di Google Maps, come 0x89c259af336b3341:0xa4969e07ce3108de. Usi place.dataId da un risultato dell'API Search, o un feature ID che già possiede.
page · predefinito 1Una pagina numerata positiva. La incrementi solo quando la risposta precedente ha next: true.

Per scoprire un feature ID, cerchi un'attività con l<link>API di scraping di Google Maps</link>. Copi <code>place.dataId</code> dalla voce corrispondente in <code>data.businesses</code> e lo passi come <code>fid</code>. Un place ID o un nome di attività non è lo stesso formato di input.

Record della galleria

Link di foto, link di video e la galleria di origine.

Ogni elemento ha un photoUrl per l'immagine o l'anteprima del video. Gli elementi video includono anche un videoUrl. L'url di primo livello rimanda alla galleria del luogo.

Campi di risposta dell'API di scraping di foto di Google Maps
CampoSignificato
photoUrlL'URL della foto disponibile, o l'immagine di anteprima di un elemento video.
videoUrlUn URL video opzionale. È presente per i record video che includono una sorgente video.
urlL'URL della galleria di Google Maps del luogo richiesto.
nextSe è disponibile un'altra pagina numerata della galleria.
totalIl conteggio in questa risposta, da zero a 20. Non è la dimensione totale della galleria del luogo.
paramsIl fid e la page normalizzati usati per questa risposta.

L'endpoint restituisce questo oggetto pagina direttamente come JSON. Legga photos dal livello superiore. L'API restituisce metadati e link dei media. La disponibilità di un'immagine o di un video dipende dalla sorgente; un elemento di galleria non garantisce un video scaricabile.

Una pagina delimitata alla volta

Legga fino a 20 elementi di galleria in ogni risposta.

Usi il flag next restituito per decidere se il Suo workflow ha bisogno di un'altra richiesta.

01

Inizi con la pagina 1

Invii il fid del luogo e la pagina 1. I record seguono l'ordine fornito dalla galleria del luogo.

02

Ispezioni la pagina corrente

total conta gli elementi di galleria restituiti in questa risposta. Una pagina vuota è un risultato valido. Controlli i campi disponibili prima di aggiungere record alla Sua analisi.

03

Continui deliberatamente

Quando next è true, incrementi page e mantenga lo stesso fid. Si fermi quando next è false, o quando il Suo workflow ha abbastanza record di media.

Esplori un luogo visivamente

Porti i metadati della galleria nel Suo workflow di ricerca.

01

Ricerca sulle schede delle attività

Ispezioni la galleria associata a un'attività selezionata e conservi il link della galleria di origine accanto ai record restituiti.

02

Organizzazione di foto e video

Separi i record di foto da quelli di video usando il campo opzionale videoUrl, e presenti le immagini di anteprima disponibili nella Sua interfaccia di ricerca.

03

Revisione della galleria assistita dall'agente

Permetta a un agente connesso di recuperare una pagina di metadati della galleria ed elencare i link dei media disponibili per ulteriori ispezioni.

Autenticazione e uso

Usi la Sua chiave API per ogni pagina.

Quota API condivisa

Invii Authorization: Bearer con una chiave che consenta scrapes:write. Ogni pagina live riuscita, inclusa una pagina vuota, usa un'unità di richiesta API. REST e MCP usano la stessa quota API. Se ha una credenziale di test, le sue risposte sono simulate e non consumano quota live.

Veda piani e limiti API →

Mantenga i retry legati alla richiesta

Invii una Idempotency-Key opzionale con la Sua prima richiesta e la conservi con un body identico per un retry dopo timeout. Un timeout di elaborazione può lasciare un'unità riservata. Se un errore segnala che il tentativo è terminato, segua la sua guida di retry prima di creare un nuovo tentativo con una nuova chiave.

Legga la guida a errori e retry →

Domande frequenti

Cosa restituisce l'API di scraping di foto di Google Maps?

Restituisce fino a 20 record di metadati di foto e video di un luogo in ogni risposta JSON. Ogni record ha un photoUrl, e i record video possono includere anche videoUrl. L'url di primo livello rimanda alla galleria del luogo.

Come ottengo il feature ID della galleria di un luogo?

Usi place.dataId di un'attività corrispondente in una risposta dell'API Search e lo invii come fid. Può anche fornire un feature ID di Maps esistente. Invii lo stesso fid quando richiede altre pagine della galleria.

L'API Photos scarica file di immagini o video?

L'endpoint restituisce metadati e URL dei media in JSON. La Sua applicazione può ispezionare i link disponibili e la sorgente della galleria. La disponibilità della sorgente determina quali record e URL vengono restituiti; un photoUrl può essere l'immagine di anteprima di un video.

Come pagino una galleria di Google Maps?

Inizi con la pagina 1. total conta i record di quella risposta. Se next è true, richieda la pagina successiva con lo stesso fid e una nuova chiave di idempotenza per la nuova richiesta. Si fermi quando next è false o il Suo workflow ha abbastanza record.

L'ordine della galleria è configurabile?

L'API Photos accetta fid e page. Restituisce gli elementi nell'ordine della galleria fornito dalla sorgente; non espone un parametro sort_by in stile recensioni.

Un agente AI può recuperare metadati della galleria?

Sì. Colleghi un client MCP compatibile per usare get_google_maps_photos con le Sue credenziali API. L'Agent Skill aggiunge istruzioni di workflow e un fallback REST. Ogni pagina di galleria live riuscita usa la quota API condivisa.

Faccia il passo successivo

Esplori la galleria di un luogo.

Crei una chiave API, fornisca il feature ID di un luogo e recuperi metadati strutturati di foto e video.