Guida all'implementazione delle transazioni avanzate

Panoramica

Le dichiarazioni relative alle transazioni sono spesso difficili da comprendere per gli utenti poiché abbreviazioni come "ACMEHCORP" anziché nomi commerciali come "Acme Houseware", il che può portare a un aumento delle chiamate all'assistenza clienti e a costose controversie. Le transazioni avanzate semplificano queste transazioni e le rende intuitive fornendo il nome completo e la categoria dell'attività di un commerciante, una foto del negozio fisico, indirizzo e posizione su una mappa, dati di contatto completi e altro ancora. Questo contribuisce ad aumentare la soddisfazione e la trasparenza degli utenti e può anche diminuire chiamate all'assistenza clienti, aumentare gli NPS e aumentare il tempo trascorso in-app.

Transazioni avanzate: la guida all'implementazione e i suggerimenti per la personalizzazione disponibili in questo argomento: consigliamo di utilizzare la combinazione ottimale API Google Maps Platform per creare una cronologia transazioni efficace ed esperienze variegate. Questa guida all'implementazione ti mostrerà come associare una località con uno specifico commerciante e mostrare le sue informazioni dettagliate.

Abilitazione delle API in corso…

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

• API Places.
• API Geocoding.
• API Maps Static, Maps SDK per Android, oppure SDK Maps per iOS.

Sezioni della guida all'implementazione

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

• check_circle_filled L'icona del segno di spunta è un passaggio di implementazione principale.
• stars L'icona a forma di stella è una personalizzazione facoltativa, ma consigliata per migliorare la soluzione.

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 di commercianti esistente o tramite una richiesta di Place Search:

Recupero degli ID luogo di Google Maps Platform

Potresti avere un database di commercianti con informazioni di base come l'attività nome e indirizzo. Per ottenere informazioni di cui Google Maps Platform dispone luogo, inclusi dati di contatto e informazioni fornite dagli utenti, dovrà essere l'ID luogo di Google Maps Platform che corrisponde a ciascuno dei i commercianti presenti nel tuo database.

Per ottenere l'ID luogo di un'attività, invia una richiesta al Endpoint /findplacefromtext in all'API Places e richiedi solo il campo place_id Fatturare la richiesta come Find Place - ID only senza costi chiamata. Se il commerciante ha più sedi, utilizza il nome del commerciante in in congiunzione con il nome della città o della via. La qualità dei dati restituiti la chiamata varierà, quindi devi verificare se i risultati sono stati restituiti che corrisponda effettivamente al commerciante desiderato.

Ecco un esempio di richiesta dell'ID luogo per l'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 eseguire la codifica degli URL. il parametro di input nella richiesta API.

Archiviazione degli ID luogo

Memorizzare informazioni di Google Maps Platform sul commerciante per il futuro richieste, puoi memorizzare questo ID luogo a tempo indeterminato nel tuo database come attributo del record del commerciante. Tu deve inviare la richiesta Trova luogo una sola volta per commerciante. Puoi Cerca anche l'ID luogo ogni volta che un utente richiede i dettagli della transazione.

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

Nel caso in cui i dettagli sul luogo visualizzati non corrispondano al commerciante per il quale sono stati visualizzati effettuato la transazione, ti consigliamo di consentire agli utenti di fornire sulla qualità della corrispondenza dei commercianti.

Puoi condividere i Place Details che gli utenti devono conoscere dopo aver visitato una delle tue luoghi. Con Place Details dettagliati come i dati di contatto, gli orari di apertura, le valutazioni e le foto degli utenti, la tua app può ricordare agli utenti il transazione. Dopo aver chiamato il API Places per ottenere Place Details, puoi filtrare ed eseguire il rendering della risposta in una finestra informativa, una barra laterale o in qualsiasi altro modo tu voglia.

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

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

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

Stabilire la località del commerciante

L'API Maps Static accetta un indirizzo o delle coordinate da posizionare un indicatore. Se nel tuo registro commerciante è già presente un indirizzo, puoi andare avanti alla prossima sezione, ma ti consigliamo di utilizzare le coordinate anziché gli indirizzi per la mappa la precisione.

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

Ecco un esempio di utilizzo dell'API Geocoding per ottenere latitudine e 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 sfogliare naviga, vuoi creare una mappa con un'interattività limitata.

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

La chiamata seguente mostra una roadmap, di dimensioni di 640x480px, centrata su una nell'ufficio di Google Taipei al livello di zoom predefinito. Inoltre, specifica 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

Questa sezione è suddivisa nelle seguenti sezioni:

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 di parametro, consulta 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 coordinate dalle informazioni in Place Details (Dettagli luogo).

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

• Per le app Android, consulta il tutorial per aggiungere una mappa con un indicatore. e attiva la modalità Lite per offrire un'interattività limitata.
• Per le applicazioni iOS, consulta il tutorial per aggiungere una mappa con un indicatore, e disattivare controlli e gesti. con il flag GMSUiSettings.