Con le API Business Profile puoi creare una piattaforma per consentire ai tuoi commercianti di gestire la loro attività su Google. Sulla tua piattaforma, puoi consentire ai tuoi partner di cercare schede che corrispondono al nome, all'indirizzo e ai dati telefonici dell'attività. Possono stabilire la proprietà di una sede, nonché indicare con precisione la sede fisica dell'attività in base a latitudine e longitudine.
Prima di iniziare
Prima di utilizzare le API Business Profile, devi registrare la tua applicazione e ottenere le credenziali OAuth 2.0. Per informazioni dettagliate su come iniziare a utilizzare le API di Profilo dell'attività, consulta Configurazione di base.
Come utilizzare i dati degli indirizzi
Per lavorare con dati su indirizzi e geolocalizzazione sulla tua piattaforma, puoi utilizzare due diversi insiemi di API e risorse: le API Business Profile e l'API Maps.
Risorse di Profilo dell'attività più utilizzate
L'API GoogleLocations
consente al commerciante di sapere in anticipo se una sede è già stata rivendicata in Profilo dell'attività. In caso contrario, consente al commerciante di richiedere immediatamente l'accesso.
L'oggetto PostalAddress
rappresenta l'indirizzo fisico di un'attività.
Risorse di Google Maps più utilizzate
I widget JavaScript di Maps per i luoghi vengono comunemente utilizzati nei flussi di lavoro dei partner per creare una mappa interattiva. Inoltre, sono utili anche le seguenti API di Google Maps:
- Restituisci le previsioni sui luoghi con le opzioni Place Autocomplete (Completamento automatico del luogo) e Place Details (Dettagli luogo). Per i dettagli sui prezzi, consulta la pagina SKU: Completamento automatico (incluso in Places Details) - Per sessione.
- Query sulle informazioni sui luoghi con Ricerca di luoghi. Per i dettagli sui prezzi, consulta SKU: Find Place.
- Fornisci geocodifica e geocodifica inversa degli indirizzi con la geocodifica. Per i dettagli sui prezzi, consulta SKU: Geocodifica.
Una o zero corrispondenze
Quando un partner cerca schede corrispondenti per una località, l'obiettivo è restringere i risultati di ricerca a una o zero corrispondenze. Ciò significa che la sede soddisfa i criteri di ricerca o non esiste ancora in Profilo dell'attività.
In caso di una o nessuna corrispondenza, utilizza il metodo accounts.locations.create
per creare una nuova scheda o segui la guida GoogleLocations
per rivendicare la proprietà della scheda esistente. Se Google non riesce a geocodificare l'indirizzo, la creazione della località non va a buon fine e la risposta dell'API include una richiesta di dati di LatLng
. Per informazioni su come il commerciante può fornire i suoi dati LatLng
, consulta la sezione Aggiustamento manuale dei dati di geolocalizzazione.
Una volta determinate le coordinate di LatLng
, viene creata la nuova scheda.
Corrispondenze parziali e multiple
Quando il proprietario di un'attività o il team operativo del partner cerca schede che corrispondono a una località, le informazioni che digitano potrebbero risultare in una corrispondenza parziale oppure potrebbero ricevere più corrispondenze per la query di ricerca. Per restringere i risultati di ricerca a una o zero corrispondenze, le corrispondenze parziali e multiple vengono risolte manualmente da due casi d'uso dell'API Maps.
L'utente perfeziona la ricerca
Quando un utente della piattaforma partner cerca una località e si trova di fronte a più corrispondenze parziali, può risolvere il problema in uno dei seguenti modi:
- Analizza gli indirizzi corrispondenti parziali e seleziona quello corretto.
- Modifica o ridigita le parti dell'indirizzo per renderlo più preciso e limita i risultati a una o zero corrispondenze.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/partial-match.png?authuser=5&hl=it)
L'utente seleziona una o più corrispondenze complete
In alcuni casi, più sedi possono corrispondere completamente all'indirizzo di ricerca dell'utente. Ad esempio, un utente potrebbe inserire il seguente indirizzo in una piattaforma partner:
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
Supponiamo che vengano restituite le seguenti risposte, tutte corrispondenti all'indirizzo indicato:
- Kasperson Printer Center, una sede non verificata.
- Bengo Seguro, una sede verificata.
- Garush Productions, una sede non verificata.
L'utente deve selezionare manualmente l'attività corrispondente. Per garantire ai consumatori
indicazioni precise per raggiungere l'attività, potrebbe essere necessario modificare i dati su latitudine e longitudine
(LatLng
) di queste sedi al fine di fornire una maggiore precisione. Per informazioni su come gli utenti possono inserire manualmente il proprio LatLng
, consulta
Aggiustamento manuale dei dati di geolocalizzazione.
Aggiustamento manuale dei dati di geolocalizzazione
Le attività possono aggiungere le coordinate di latitudine e longitudine (LatLng
) della propria attività per aumentare l'accuratezza della scheda su Profilo dell'attività. Le nuove attività potrebbero non conoscere le coordinate di LatLng
, quindi inserire manualmente un segnaposto con il widget JavaScript di Maps per i luoghi per stabilire coordinate di LatLng
precise.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/my-business/images/latlng-manual-adjustment.png?authuser=5&hl=it)
LatLng
, è necessario modificare manualmente le coordinate di ogni sede.Qualità dei risultati di ricerca
I risultati di ricerca variano notevolmente in base alla precisione dell'indirizzo cercato e per area geografica. Le regioni in via di sviluppo spesso mostrano meno luoghi su Maps e una conformità incoerente con i formati degli indirizzi di Google. Ciò porta a risultati di ricerca di qualità inferiore e a una maggiore necessità di formattazione manuale degli indirizzi e di utilizzo dell'API di Google Maps.