Guida all'implementazione di 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 dichiarazioni sulle transazioni sono spesso difficili da comprendere per gli utenti, in quanto utilizzano abbreviazioni come "ACMEHCORP" anziché nomi dei commercianti come "Acme Houseware", che possono portare a un aumento delle chiamate all'assistenza clienti e a contestazioni costose. Le transazioni avanzate semplificano queste transazioni e le rendono intuitive fornendo il nome completo e la categoria dell'attività di un commerciante, una foto della vetrina, il suo indirizzo e la sua posizione su una mappa, i dati di contatto completi e altro ancora. Ciò contribuisce ad aumentare la soddisfazione e la trasparenza degli utenti, ma può anche ridurre le chiamate all'assistenza clienti, aumentare l'NPS e aumentare il tempo trascorso in-app.

Le transazioni avanzate, ovvero la guida all'implementazione e i suggerimenti per la personalizzazione che forniamo in questo argomento, sono la combinazione ottimale di API di Google Maps Platform per creare esperienze utente straordinarie in termini di cronologia delle transazioni. Questa guida all'implementazione ti mostra come associare una località a un commerciante specifico e ne mostra le informazioni dettagliate.

Schermate di esempio per le transazioni avanzate
Schermate di esempio delle transazioni estese (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 a forma di 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 a Google Maps Platform Associare un commerciante nella cronologia delle transazioni a un luogo in Google Maps Platform.
Mostrare i dettagli del commerciante Mostra transazioni ricche di dati che mostrano informazioni utili sul commerciante, in modo che gli utenti possano riconoscere rapidamente la transazione.
Aggiunta di una mappa della sede del commerciante Aggiungi una mappa della sede del commerciante.

Abbinare i commercianti con Google Maps Platform

In questo esempio si utilizza: API Places

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

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

Ottenere gli ID luogo di Google Maps Platform

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

Per ottenere l'ID luogo di un'attività, invia 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 dell'ufficio di 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 l'URL il parametro di input nella richiesta API.

Archiviazione degli ID dei luoghi

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

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

Nel caso in cui i dettagli del luogo visualizzati non corrispondano al commerciante in cui ha effettuato la transazione, ti consigliamo di consentire agli utenti di fornire un feedback sulla qualità della corrispondenza del commerciante.

Visualizzazione dei dettagli del commerciante

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

Puoi condividere i Dettagli luogo che gli utenti devono conoscere dopo aver visitato una delle tue sedi. Grazie alle informazioni dettagliate sui luoghi, come i dati di contatto, gli orari di apertura, le valutazioni degli utenti e le foto degli utenti, la tua app può ricordare agli utenti la 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, una barra laterale web o in qualsiasi altro modo.

Esempio di schermata dei dettagli del commerciante
Esempio di schermata dei dettagli del commerciante (fai clic per ingrandire)

Per richiedere i Dettagli luogo, ti serve l'ID di ciascuna delle tue sedi. Consulta la sezione 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 l'orario in un output json per l'ID luogo di Google Taipei 101:

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

Aggiunta di una mappa della sede del commerciante

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

Determinazione della località del commerciante

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

Se il tuo database di commercianti contiene indirizzi stradali ma non coordinate geografiche e non richiedi i dettagli posizione, puoi utilizzare l'API Geocoding per convertire gli indirizzi in coordinate di latitudine/longitudine sul lato server, memorizzare le coordinate nel database e aggiornare le coordinate una volta almeno ogni 30 giorni.

Ecco un esempio di utilizzo dell'API Geocoding per ottenere la latitudine e la longitudine dell'ID luogo 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é gli utenti vedranno la mappa per confermare le transazioni anziché sfogliare o navigare, vuoi creare una mappa che abbia un'interattività limitata.

Per il Web desktop e il Web 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 utilizzando una chiamata al servizio web, che creerà una versione immagine di una mappa in base ai parametri specificati. Per i dispositivi mobili, vai alla sezione Aggiungere una mappa nell'applicazione mobile successiva.

La chiamata seguente mostra una roadmap, con dimensioni di 640 x 480 px, centrata su un indicatore nella sede di Google Taipei al livello di zoom predefinito. Specifica inoltre un indicatore di posizione 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

Il tutto è suddiviso nelle seguenti sezioni:

URL API https://maps.googleapis.com/maps/api/staticmap?
Dimensioni delle immagini dimensioni=640 x 480
Indicatori di posizione del commerciante (mediante la codifica dell'URL) indicatori=color:red%7C25.033976%2C121.5645389
Stile di mappa basato su cloud id_mappa=b224095f76859890
Chiave API key=YOUR_API_KEY
Firma digitale (scopri come firmare digitalmente la tua richiesta) firma=BASE64_SIGNATURE
Parametro del canale della soluzione (consulta la documentazione relativa ai parametri) Solutions_channel=GMP_guides_enrichedtransactions_v1_a

che diventerà l'immagine mostrata di seguito:

Immagine statica della mappa 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 relativa all'API Maps Static.

Aggiunta di una mappa nell'applicazione mobile

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

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