Guida all'implementazione delle transazioni avanzate

Panoramica

web iOS API

Google Maps Platform è disponibile per il web (JS, TS), Android e iOS e offre anche API di servizi web per ottenere informazioni su luoghi, indicazioni stradali e distanze. Gli esempi in questa guida sono scritti per una piattaforma, ma sono disponibili link alla documentazione per l'implementazione su altre piattaforme.

Le istruzioni relative alle transazioni sono spesso difficili da comprendere per gli utenti, poiché utilizzano abbreviazioni come "ACMEHCORP" anziché nomi commerciante come "Acme Houseware" e possono portare a un aumento delle chiamate all'assistenza clienti e a costose controversie. Le transazioni avanzate semplificano queste transazioni e le rende intuitive fornendo nome completo e categoria dell'attività di un commerciante, una foto della vetrina, il suo indirizzo e la sua posizione su una mappa, dati di contatto completi e altro ancora. Ciò contribuisce ad aumentare la soddisfazione e la trasparenza degli utenti, nonché a ridurre le chiamate all'assistenza clienti, ad aumentare gli NPS e a incrementare il tempo trascorso in-app.

Consigliamo le transazioni avanzate, la guida all'implementazione e i suggerimenti per la personalizzazione in questo argomento, come combinazione ottimale di API Google Maps Platform per creare esperienze utente con una cronologia delle transazioni ottimale. Questa guida all'implementazione ti illustrerà come abbinare una sede a un commerciante specifico e mostrerà le sue informazioni dettagliate.

Schermate di esempio per transazioni avanzate
Schermate di esempio per le transazioni arricchite (fai clic per ingrandire)

Abilitazione delle API in corso…

Per implementare le transazioni avanzate, devi abilitare le seguenti API nella console Google Cloud. I seguenti link ipertestuali ti indirizzano alla console Google Cloud per abilitare ciascuna API per il progetto selezionato:

Per ulteriori informazioni sulla configurazione, consulta la Guida introduttiva a Google Maps Platform.

Sezioni della guida all'implementazione

Di seguito sono riportate le implementazioni e le personalizzazioni che tratteremo in questo argomento.

  • L'icona del segno di spunta è un passaggio di implementazione principale.
  • L'icona a forma di stella è una personalizzazione facoltativa, ma consigliata, per migliorare la soluzione.
Abbinare i commercianti con Google Maps Platform Associazione di un commerciante nella cronologia delle transazioni a un luogo in Google Maps Platform.
Visualizzazione dei dettagli del commerciante Mostra transazioni ricche di dati che mostrano informazioni utili sul commerciante, in modo che gli utenti possano riconoscere rapidamente la transazione.
Aggiungere una mappa della sede del commerciante Aggiungi una mappa della sede del commerciante.

Abbinare i commercianti con Google Maps Platform

In questo esempio viene utilizzata: API Places

Il seguente diagramma mostra in che modo la tua applicazione associa le transazioni dei commercianti per restituire un risultato utilizzando Place Details da un database di commercianti esistente o tramite una richiesta Place Search:

Matrice di flusso di corrispondenza del commerciante
Matrice di flusso corrispondente al commerciante (fai clic per ingrandire)

Recupero degli ID luogo di Google Maps Platform

Potresti avere un database di commercianti con informazioni di base come il nome dell'attività e il relativo indirizzo. Per ottenere informazioni sul luogo di cui Google Maps Platform dispone, tra cui i dati di contatto e le informazioni fornite dagli utenti, devi l'ID luogo di Google Maps Platform corrispondente a ciascuno dei commercianti nel tuo database.

Per ottenere l'ID luogo per un'attività, effettua una richiesta all'endpoint /findplacefromtext nell'API Places e richiedi solo il campo place_id per fatturare la richiesta come chiamata Find Place - ID only senza costi. Se il commerciante ha più sedi, utilizza il nome del commerciante insieme al nome della città o della via. La qualità dei dati restituiti dalla chiamata varia, quindi devi verificare se i risultati restituiti corrispondono effettivamente al commerciante desiderato.

Ecco un esempio di richiesta dell'ID luogo per l'ufficio Google Taipei utilizzando il nome e la città del commerciante:

https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=google%20taipei&inputtype=textquery&fields=place_id&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

Assicurati di codificare con URL il parametro di input nella richiesta API.

Archiviazione degli ID luogo

Per memorizzare informazioni di Google Maps Platform sul commerciante per richieste future, puoi memorizzare questo ID luogo a tempo indeterminato nel tuo database come attributo del record del commerciante. Dovresti presentare la richiesta Trova luogo solo una volta per commerciante. Puoi anche cercare l'ID luogo ogni volta che un utente richiede i dettagli della transazione.

Per assicurarti di disporre sempre delle informazioni più accurate, aggiorna gli ID luogo ogni 12 mesi utilizzando una richiesta Place Details con il parametro place_id.

Nel caso in cui i dettagli sul luogo visualizzati non corrispondano al commerciante in cui è stata effettuata la transazione, ti consigliamo di consentire agli utenti di fornire un feedback sulla qualità della corrispondenza dei commercianti.

Visualizzazione dei dettagli del commerciante

In questo esempio viene utilizzata: API Places Disponibile anche: SDK Places per Android | SDK Places per iOS | Libreria Places, API Maps JavaScript

Puoi condividere i Place Details che gli utenti devono conoscere dopo aver visitato una delle tue sedi. Grazie a informazioni dettagliate sul luogo come i dati di contatto, gli orari di apertura, le valutazioni e le foto degli utenti, la tua app può ricordare agli utenti la loro transazione completata. Dopo aver effettuato una chiamata all'API Places per ottenere Place Details, puoi filtrare ed eseguire il rendering della risposta in una finestra informativa, in una barra laterale web o in qualsiasi altro modo.

Esempio di schermata con i dettagli del commerciante
Schermata di esempio dei dettagli del commerciante (fai clic per ingrandire)

Per richiedere i dettagli del luogo, devi disporre dell'ID luogo di ciascuna delle tue sedi. Consulta Recupero degli ID luogo per recuperare l'ID luogo della tua sede.

La seguente richiesta Place Details restituisce l'indirizzo, le coordinate, il sito web, il numero di telefono, la valutazione e gli orari in un output json per l'ID luogo 101 di Google Taipei:

https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJraeA2rarQjQRyAqIxkx2vN8&fields=name%2Cformatted_address%2Cwebsite%2Cformatted_phone_number%2Cgeometry/location%2Cicon%2Copening_hours%2Crating&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

Aggiungi una mappa della sede del commerciante

In questo esempio vengono utilizzati: API Geocoding | API Maps Static Disponibile anche: Android | iOS

Stabilire la località del commerciante

L'API Maps Static accetta un indirizzo o delle coordinate per posizionare un indicatore. Se il tuo record commerciante contiene già un indirizzo, puoi passare alla sezione successiva, ma ti consigliamo di utilizzare le coordinate anziché gli indirizzi per la precisione sulla mappa.

Se il tuo database di commercianti contiene indirizzi ma non coordinate geografiche e non stai già richiedendo Place Details, puoi utilizzare l'API Geocoding per convertire gli indirizzi stradali in coordinate di latitudine/longitudine sul lato server, archiviare le coordinate nel database e aggiornare le coordinate almeno una volta ogni 30 giorni.

Ecco un esempio di utilizzo dell'API Geocoding per ottenere la latitudine e la longitudine dell'ID località dell'ufficio di Google Taipei:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJraeA2rarQjQRyAqIxkx2vN8&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

Aggiunta di un indicatore per la sede del commerciante a una mappa

Poiché i tuoi utenti vedranno la mappa per confermare le transazioni anziché per sfogliare o navigare, è consigliabile creare una mappa con un'interattività limitata.

Per il web desktop e mobile, crea un URL dell'API Maps Static con un singolo indicatore alla latitudine/longitudine o all'indirizzo del commerciante. Puoi utilizzare l'API Maps Static con una chiamata al servizio web, che creerà una versione immagine di una mappa in base ai parametri specificati. Per i dispositivi mobili, passa alla sezione successiva Aggiunta di una mappa nella tua applicazione mobile.

Nella chiamata che segue viene mostrata una roadmap di dimensioni 640x480 px, centrata su un indicatore nella sede di Google Taipei con il livello di zoom predefinito. Inoltre, specifica un indicatore di luogo di consegna rosso e uno stile di mappa basato su cloud:

    https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:red%7C25.033976%2C121.5645389&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a

Questa sezione è suddivisa nelle seguenti sezioni:

URL API https://maps.googleapis.com/maps/api/staticmap?
Dimensioni delle immagini dimensione=640x480
Indicatori di posizione del commerciante (con la codifica dell'URL) pennarelli=colore:rosso%7C25.033976%2C121.5645389
Stile di mappa basato su cloud map_id=b224095f76859890
Chiave API key=YOUR_API_KEY
Firma digitale (scopri come firmare digitalmente la tua richiesta) firma=BASE64_SIGNATURE
Parametro canale della soluzione (consulta la documentazione relativa ai parametri) solution_channel=GMP_guides_enrichedtransactions_v1_a

Questa diventa l'immagine come mostrato di seguito:

Immagine mappa statica dell'ufficio di Google Taipei

Puoi anche utilizzare un indirizzo come posizione dell'indicatore:

https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:green%7CTaipei%20101%20Tower%2CNo.%207信義路五段信義區台北市%20Taiwan%20110&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a

Per ulteriori opzioni relative ai parametri, consulta la documentazione dell'API Maps Static.

Aggiunta di una mappa nella tua applicazione mobile

Se utilizzi Maps SDK for Android o Maps SDK for iOS, puoi inserire un indicatore utilizzando le coordinate presenti in Place Details (Dettagli luogo).

Poiché gli utenti vedranno la mappa per confermare le transazioni anziché per sfogliare o navigare, scegli una mappa con interattività limitata: