Con le API Business Profile, puoi creare una piattaforma per consentire ai tuoi commercianti di gestire la propria attività su Google. Sulla tua piattaforma, puoi consentire ai tuoi partner di cercare schede che corrispondono ai dati relativi a nome, indirizzo e numero di telefono della loro attività. Possono stabilire la proprietà di una sede e posizionare 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 Business Profile, consulta Configurazione di base.
Come utilizzare i dati degli indirizzi
Per lavorare con i dati di indirizzo e geolocalizzazione sulla tua piattaforma, puoi utilizzare due diversi set di API e risorse: le API Business Profile e l'API di Google Maps.
Risorse di Profilo dell'attività di uso comune
L'API GoogleLocations consente al commerciante di vedere 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 di uso comune
I widget di Places dell'API Maps JavaScript sono di uso comune nei flussi di lavoro dei partner per creare una mappa interattiva. Inoltre, sono utili anche le seguenti API di Google Maps:
- Restituisci previsioni sui luoghi con Place Autocomplete e Place Details. Per i dettagli sui prezzi, consulta SKU: Autocomplete (included with Places Details) – Per Session.
- Esegui query per ottenere informazioni sui luoghi con Place Search. Per i dettagli sui prezzi, consulta SKU: Find Place.
- Fornisci la geocodifica e la geocodifica inversa degli indirizzi con Geocoding. Per i dettagli sui prezzi, consulta SKU: Geocoding.
Una o nessuna corrispondenza
Quando un partner cerca schede corrispondenti per una sede, il suo obiettivo è restringere i risultati di ricerca a una o zero corrispondenze. Ciò significa che la sede corrisponde ai criteri di ricerca o non esiste ancora in Profilo dell'attività, rispettivamente.
Se non ci sono corrispondenze o ce n'è una sola, 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 è in grado di geocodificare l'indirizzo, la creazione della località non va a buon fine e la risposta dell'API include una richiesta di dati LatLng. Per informazioni su come il commerciante può fornire i propri dati LatLng, consulta Regolazione manuale dei dati di geolocalizzazione.
Una volta determinate le coordinate LatLng, viene creata la nuova scheda.
Corrispondenze parziali e multiple
Quando un proprietario dell'attività o il team operativo del partner cerca schede che corrispondono a una località, le informazioni digitate potrebbero generare solo una corrispondenza parziale o 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 di Google 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 con corrispondenza parziale e seleziona quello corretto.
- Modifica o digita nuovamente parti dell'indirizzo per renderlo più preciso e restringere i risultati a una o zero corrispondenze.
L'utente seleziona una o più corrispondenze complete
In alcuni casi, più località potrebbero 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 fornito:
- 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 che ai consumatori vengano fornite indicazioni stradali precise per raggiungere l'attività, potrebbe essere necessario modificare i dati di latitudine e longitudine (LatLng) di queste sedi per fornire una maggiore precisione. Per informazioni su come gli utenti possono inserire manualmente la propria LatLng, consulta Regolazione manuale dei dati di geolocalizzazione.
Regolazione 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 nel profilo dell'attività. Le nuove attività potrebbero non conoscere le proprie coordinate LatLng, quindi possono inserire manualmente un segnaposto con il widget Places di Maps JavaScript per stabilire coordinate LatLng precise.
LatLng, è necessario regolare manualmente le coordinate di ogni sede.Qualità dei risultati di ricerca
I risultati di ricerca variano notevolmente in base all'accuratezza dell'indirizzo cercato e alla regione 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ò comporta risultati di ricerca di qualità inferiore e una maggiore necessità di formattazione manuale degli indirizzi e di utilizzo dell'API di Google Maps.