Google Maps Reviews
Le recensioni di Google Maps sono record pubblici di feedback sui luoghi che possono includere testo scritto, un riferimento al recensore, una valutazione, link di origine e dell’oggetto recensito, orari di pubblicazione e di raccolta, oltre ai contenuti multimediali. Supportano dataset di feedback collegati alla fonte e confronti tra luoghi noti o finestre di raccolta.
Funzionalità della Google Maps Reviews API
- Input di più URL notiInvia uno o più URL supportati di google.com o goo.gl in un’unica attività asincrona, senza risolvere i luoghi con un’API separata di identificatori.
- Finestra di giorni facoltativaApplica un unico valore positivo di days_limit a ogni riga di URL inviata, quando il flusso di lavoro richiede una finestra di recensioni recenti.
- Record di recensioni stabiliLeggi identità della recensione, testo, campi del recensore, valutazione, riferimenti al luogo, timestamp, URL di origine e contenuti multimediali disponibili tramite lo schema review v1.0.
Parametri della Google Maps Reviews API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Uno o più URL non vuoti su google.com, su qualsiasi sottodominio di google.com, su goo.gl o su un sottodominio di goo.gl, separati da virgole o da a capo. Per raccogliere le recensioni usa URL noti di luoghi di Maps. |
days_limit | Facoltativo | Intero positivo facoltativo, applicato a ogni riga di input del provider come finestra di recenza delle recensioni. Omettilo per non inviare alcun filtro per giorni. |
results_limit | Facoltativo | Intero facoltativo da 1 a 2.000 che limita il totale delle recensioni salvate per l’attività. Il valore predefinito è 100 e la disponibilità della fonte può produrre meno righe. |
Come usare la Google Maps Reviews API
Invia URL noti di Google Maps, segui l’attività asincrona e leggi i record delle recensioni salvati tramite il cursore dei risultati dell’attività.
- Prepara uno o più URL di luoghi di Google Maps supportati su google.com o goo.gl.
- Invia con POST urls e, se serve, days_limit e results_limit a /v1/google-maps/reviews.
- Interroga /v1/tasks/{task_id} finché status diventa succeeded o failed.
- Leggi /v1/tasks/{task_id}?limit=50 e prosegui con results.next_cursor finché results.has_more è true.
curl -X POST "https://api.socq.ai/v1/google-maps/reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.google.com/maps/place/Coffee%20Project%20New%20York%20%7C%20East%20Village/data=!4m7!3m6!1s0x89c2599b5a24d7fd:0x9e354f6cf514b9fc!8m2!3d40.7270884!4d-73.9893820!16s%2Fg%2F11c3svpqld!19sChIJ_dckWptZwokR_LkU9WxPNZ4?authuser=0&hl=en&rclk=1"],"days_limit":3650,"results_limit":3}'
# Poll GET /v1/tasks/{task_id}, then request
# GET /v1/tasks/{task_id}?limit=50&cursor={results.next_cursor}.Casi d’uso della Google Maps Reviews API
- Dataset di feedback su luoghi noti: Prepara testo delle recensioni, valutazioni, orari di pubblicazione e link di origine per un insieme definito di URL pubblici di luoghi.
- Ricerca sui recensori con tracciabilità della fonte: Conserva nomi, nomi utente, link ai profili e URL delle recensioni disponibili, così i record restano riconducibili al loro contesto pubblico.
- Confronti su finestre recenti: Esegui lo stesso insieme di luoghi con valori di days_limit documentati in momenti diversi, per confrontare raccolte circoscritte senza pretendere uno storico completo.
- Archivi di recensioni con media collegati: Tieni i contenuti multimediali disponibili accanto a testo, valutazione, riferimento al luogo e momento di raccolta in un record di ricerca normalizzato.
Consigli degli esperti per la Google Maps Reviews API
- Invia URL di Maps risolvibili su google.com o goo.gl: il nome di un luogo, un account Google Business Profile o un Place ID da soli non sono un elemento accettato di urls.
- Usa days_limit solo quando ha senso una finestra espressa in numeri interi positivi; se lo ometti, la riga inviata al provider resta senza quel filtro.
- Considera results_limit come un unico tetto globale di risultati salvati per l’intero gruppo di URL, non come una promessa per ogni singolo URL.
- Tieni separato results_limit dell’invio dal limit di lettura dell’attività: quest’ultimo controlla la dimensione della pagina da 1 a 500 e usa un cursore opaco.
- Metti in conto che testo, attributi del recensore, valutazione, riferimenti all’oggetto, timestamp e media possano mancare quando la fonte pubblica non li espone.
API correlate
Oltre alla Google Maps Reviews API, usa queste API quando ti serve un altro tipo di dati pubblici di Google Maps.
- Google Maps Search API — Cerca luoghi pubblici di Google Maps per query e località con identità, indirizzo, contatti, valutazione, numero di recensioni, URL e coordinate normalizzati.
- Google Maps Place Details API