Cercare schede corrispondenti

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 corrispondenti al nome, all'indirizzo e ai dati di contatto della loro attività. Possono stabilire la proprietà di una località, nonché 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 la sezione Configurazione di base.

Come utilizzare i dati sugli indirizzi

Per lavorare con i dati di 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à 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, il commerciante può 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 di Maps JavaScript vengono spesso utilizzati nei flussi di lavoro dei partner per creare una mappa interattiva. Inoltre, sono utili anche le seguenti API di Maps:

Una o nessuna corrispondenza

Quando un partner cerca schede corrispondenti per una località, il suo obiettivo è limitare i risultati di ricerca a una o nessuna corrispondenza. Ciò significa che la località corrisponde ai criteri di ricerca o non esiste ancora in Profilo dell'attività.

Se non sono presenti corrispondenze o se 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 stazione di ricarica 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 sulla geolocalizzazione.

Una volta determinate le coordinate LatLng, viene creata la nuova scheda.

Corrispondenze parziali e multiple

Quando il proprietario di un'attività o il team operativo del partner cerca schede corrispondenti a una località, le informazioni digitate potrebbero generare solo una corrispondenza parziale o più corrispondenze alla query di ricerca. Per limitare 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.

Quando un utente della piattaforma partner cerca una località e trova più corrispondenze parziali, può risolvere il problema in uno dei seguenti modi:

  • Analizza gli indirizzi con corrispondenza parziale e seleziona quello corretto.
  • Modifica o ridigita parti dell'indirizzo per ottenere risultati più precisi e limitare le corrispondenze a una o nessuna.
Un utente si trova di fronte a diverse corrispondenze parziali in risposta alla sua ricerca di indirizzi.

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 località non verificata.
  • Bengo Seguro, una località verificata.
  • Garush Productions, una località non verificata.

L'utente deve selezionare manualmente l'attività corrispondente. Per garantire ai consumatori indicazioni accurate per raggiungere l'attività, i dati di latitudine e longitudine (LatLng) di queste sedi potrebbero dover essere modificati per una maggiore precisione. Per informazioni su come gli utenti possono inserire manualmente il proprio LatLng, consulta Aggiustamento manuale dei dati sulla geolocalizzazione.

Regolazione manuale dei dati di geolocalizzazione

Le attività possono aggiungere le coordinate di latitudine e longitudine (LatLng) della loro attività per aumentare l'accuratezza della scheda su Profilo dell'attività. Le nuove attività potrebbero non conoscere le coordinate LatLng, quindi possono inserire manualmente un segnaposto con il widget dei luoghi di Maps JavaScript per stabilire coordinate LatLng precise.

Un singolo indirizzo risolve in tre posizioni distanti 450 metri. Per associare con precisione l'indirizzo dell'attività alle relative LatLng coordinate, è 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 per cui viene eseguita la ricerca e alla regione geografica. Le regioni in via di sviluppo spesso mostrano meno luoghi di Maps e una conformità incoerente ai 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 Maps.