Google Maps Place Details
Le pagine pubbliche dei luoghi su Google Maps possono mostrare nomi, categorie, descrizioni, indirizzi, dati di contatto, valutazioni, numero di recensioni, siti web e contesto geografico. I record normalizzati rendono questi campi visibili più facili da collegare a inventari di sedi, ricerche sui locali, arricchimento di directory e monitoraggio puntuale nel tempo.
Funzionalità della Google Maps Place Details API
- Raccolta di dettagli da più URLInvia uno o più URL noti di Google Maps: ogni input non vuoto diventa una riga di dettaglio del provider, con un limite interno pari al numero di URL inviati.
- Record di luoghi stabiliRestituisce identità, URL di origine, nome, descrizione, categoria, indirizzo, telefono, sito web, valutazione e numero di recensioni tramite lo schema PlaceItem.
- Contesto geografico strutturatoMantiene insieme nome della località, città, regione, paese, latitudine e longitudine, senza doverli estrarre da testi di presentazione.
- Fatturazione basata sui risultatiLa stima è di 0,15 crediti per ogni URL inviato; il saldo finale è di 0,15 crediti per ogni record di luogo standard restituito con successo, mentre i risultati vuoti non hanno alcun costo.
Parametri della Google Maps Place Details API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Array obbligatorio e non vuoto di riferimenti da cui il parser ricava un hostname. Il runtime accetta per hostname google.com, goo.gl e i relativi sottodomini; accetta qualsiasi schema con una componente authority e i riferimenti relativi al protocollo, e non richiede un particolare formato di percorso. |
Come usare la Google Maps Place Details API
Invia URL noti di Google Maps, segui l’attività asincrona e leggi ogni PlaceItem salvato tramite il formato standard dei risultati con cursore.
- Prepara uno o più riferimenti il cui hostname analizzato sia google.com, goo.gl o un sottodominio di uno dei due host accettati.
- Invia con POST urls a /v1/google-maps/place-details e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività non termina con successo o con un errore.
- Leggi data.results.items e segui next_cursor finché has_more è true; la richiesta di invio non ha alcun campo results_limit.
curl -X POST "https://api.socq.ai/v1/google-maps/place-details" \
-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"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della Google Maps Place Details API
- Arricchimento di directory di sedi: Aggiungi categoria, indirizzo, telefono, sito web, valutazione, numero di recensioni e coordinate normalizzati agli URL di luoghi già noti.
- Verifiche di locali e filiali: Riesamina un elenco controllato di URL per confrontare identità, contatti, valutazioni e valori geografici visibili in momenti di raccolta definiti.
- Riconciliazione dei record dei luoghi: Usa ID, URL di origine, nomi, indirizzi e coordinate restituiti per abbinare i luoghi pubblici ai record di sedi interni.
Consigli degli esperti per la Google Maps Place Details API
- Invia URL di Maps assoluti e completi, così il parser può ricavare un hostname accettato; gli hostname senza schema non producono alcun hostname nel parser del runtime.
- Non aggiungere Place ID, chiavi API di Google, field mask o results_limit, perché non sono campi di questa specifica di richiesta di SocQ.
- Considera ogni URL inviato un candidato per i dettagli e non un risultato garantito; righe di origine non disponibili o inutilizzabili possono lasciare meno elementi degli URL.
- Conserva come nulli i membri phone, website, rating, review count, description, publication time e location, invece di inventare valori di ripiego.
- Prosegui con next_cursor finché has_more è true: la paginazione si applica alla lettura dei risultati salvati dell’attività, anche se il limite del provider dipende dal numero di URL.
API correlate
Oltre alla Google Maps Place Details 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 Reviews API