Località

L'API GoogleLocations consente di vedere in anticipo se una sede è stata rivendicata in Profilo dell'attività. In questo modo, se la sede è stata rivendicata, puoi richiedere immediatamente l'accesso alla sede. Inoltre, se gestisci account verificati collettivamente, puoi selezionare in modo più preciso le potenziali corrispondenze in anticipo ed evitare la creazione di sedi duplicate.

L'endpoint API restituisce un URL che indica se una località è già stata rivendicata. Se è stato rivendicato, lo stesso URL ti consente di avviare la procedura di richiesta di accesso.

L'immagine seguente fornisce una panoramica della procedura per acquisire la proprietà di una sede.

Figura 1. Diagramma bagnante della proprietà della sede di Profilo dell'attività

I seguenti passaggi consentono di utilizzare l'API GoogleLocations:

  1. Raccogli i dati sulla posizione dal commerciante.

  2. Chiama l'endpoint googleLocations.search. Fornisci i dati sulla posizione nel corpo della chiamata. In alternativa, puoi fornirlo in una stringa di query, simile a quella che un utente inserirà nella Ricerca o in Maps. Ad esempio, "Starbucks 5th ave NYC".

    L'API restituisce un elenco di località potenzialmente corrispondenti e informazioni su ogni località, ad esempio locationName e indirizzo.

  3. Seleziona la località che corrisponde alla tua posizione. Se non ci sono corrispondenze, chiama accounts.locations.create e vai al passaggio 5.

  4. In base allo stato di requestAdminRightsUrl nella risposta, esegui le seguenti azioni:

    1. Se requestAdminRightsUrl esiste già, un altro utente è proprietario della scheda. Indirizza il commerciante all'URL per avviare una richiesta di accesso e proprietà della sede esistente in Profilo dell'attività.
    2. Se requestAdminRightsUrl non esiste, chiama accounts.locations.create e crea una nuova scheda che verrà verificata in un secondo momento.
  5. Se hai creato nuove schede durante questa procedura, puoi utilizzare le API di verifica per iniziare la verifica delle schede. Per maggiori informazioni, consulta la pagina Gestire la verifica.