Inizi con la pagina 1
Invii il fid del luogo e la pagina 1. I record seguono l'ordine fornito dalla galleria del luogo.
POST /api/v2/photos
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.
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.
{
"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
Richieda metadati di immagini e video per un singolo luogo usando il suo feature ID.
| Campo | Significato |
|---|---|
| fid · obbligatorio | Un 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 1 | Una 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
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.
| Campo | Significato |
|---|---|
| photoUrl | L'URL della foto disponibile, o l'immagine di anteprima di un elemento video. |
| videoUrl | Un URL video opzionale. È presente per i record video che includono una sorgente video. |
| url | L'URL della galleria di Google Maps del luogo richiesto. |
| next | Se è disponibile un'altra pagina numerata della galleria. |
| total | Il conteggio in questa risposta, da zero a 20. Non è la dimensione totale della galleria del luogo. |
| params | Il 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
Usi il flag next restituito per decidere se il Suo workflow ha bisogno di un'altra richiesta.
Invii il fid del luogo e la pagina 1. I record seguono l'ordine fornito dalla galleria del luogo.
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.
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
Ispezioni la galleria associata a un'attività selezionata e conservi il link della galleria di origine accanto ai record restituiti.
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.
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
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.
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.
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.
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'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.
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'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.
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
Crei una chiave API, fornisca il feature ID di un luogo e recuperi metadati strutturati di foto e video.