Panoramica
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](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/solutions/enriched-transactions/images/diagram.png?authuser=9&hl=it)
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](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/solutions/enriched-transactions/images/decision-matrix-diagram.png?authuser=9&hl=it)
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](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/solutions/enriched-transactions/images/enriched-transactions.png?authuser=9&hl=it)
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:
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:
- Per le app per Android, consulta il tutorial sull'aggiunta di una mappa con un indicatore e attiva la modalità Lite per offrire un'interattività limitata.
- Per le applicazioni iOS, consulta il tutorial sull'aggiunta di una mappa con un indicatore e disattiva controlli e gesti con il flag
GMSUiSettings
.