google-maps/
place-details

Raccogli i dettagli di URL pubblici noti di Google Maps, con campi normalizzati di identità, categoria, indirizzo, contatto, valutazione, numero di recensioni, sito web e posizione geografica.

Google Maps Place Details API

URL di Maps noti
Dettagli dei luoghi
Posizioni normalizzate
0,15 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
urlsObbligatorioArray 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.

  1. Prepara uno o più riferimenti il cui hostname analizzato sia google.com, goo.gl o un sottodominio di uno dei due host accettati.
  2. Invia con POST urls a /v1/google-maps/place-details e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività non termina con successo o con un errore.
  4. 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 true

Casi 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.

Oltre alla Google Maps Place Details API, usa queste API quando ti serve un altro tipo di dati pubblici di Google Maps.

Esplora altre piattaforme

Combina i dati di Google Maps con i dati pubblici delle altre piattaforme social supportate.

Google Maps Place Details API — FAQ

Google Maps Place Details API trasforma gli URL pubblici noti di Google Maps in record PlaceItem normalizzati. Restituisce i campi disponibili di identità, categoria, contatto, valutazione, numero di recensioni, indirizzo, sito web e posizione.

Invia riferimenti il cui hostname analizzato è google.com, goo.gl o un sottodominio di uno dei due host. Qualsiasi schema è accettato se sono presenti authority e hostname, sono accettati anche i riferimenti relativi al protocollo e non è richiesto alcun percorso /maps/place specifico.

No. La richiesta accetta tramite SocQ URL pubblici noti di Google Maps e non accetta un Place ID ufficiale, una chiave API di Google, credenziali OAuth o una field mask.

No. L’input del provider contiene una riga di dettaglio per ogni URL non vuoto e un limite interno pari al numero di righe; results_limit non è un campo pubblico della richiesta.

Un URL di origine può non essere disponibile, restituire una riga di errore o non produrre un luogo normalizzato utilizzabile. Gli altri URL inviati proseguono in modo indipendente.

Interroga GET /v1/tasks/{task_id}, leggi data.results.items dopo il successo e richiedi la pagina successiva con next_cursor finché has_more è true.

La stima è di 0,15 crediti SocQ per ogni URL inviato non vuoto. La fatturazione finale è di 0,15 crediti per ogni record di luogo standard restituito con successo, e un insieme di risultati vuoto costa zero crediti.