Przewodnik po implementacji transakcji wzbogaconych

Omówienie

web iOS API

Google Maps Platform jest dostępny w przeglądarkach (JS, TS) oraz na urządzeniach z Androidem i iOS. Udostępnia też interfejsy API usług internetowych do uzyskiwania informacji o miejscach, wskazówkach dojazdu i odległościach. Przykłady w tym przewodniku dotyczą jednej platformy, ale podane są linki do dokumentacji na temat implementacji na innych platformach.

Wyrażenia transakcji są często trudne do zrozumienia dla użytkowników, ponieważ zamiast nazw sprzedawców, takich jak „Acme Houseware”, używają skrótów typu „ACMEHCORP”, co może prowadzić do częstszego kontaktu z obsługą klienta i prowadzenia kosztownych sporów. Wzbogacone transakcje upraszczają te transakcje i sprawiają, że są one bardziej intuicyjne, przez podanie pełnej nazwy sprzedawcy, kategorii działalności, zdjęcia witryny sklepu, adresu i lokalizacji na mapie oraz pełnych informacji kontaktowych. Pomaga to zwiększyć zadowolenie użytkowników i przejrzystość. Może też zmniejszyć liczbę połączeń z obsługą klienta, zwiększyć NPS i wydłużyć czas spędzany w aplikacji.

Wzbogacone transakcje, czyli przewodnik po implementacji i wskazówki dotyczące dostosowywania, które omówiliśmy w tym temacie, są zalecanym rozwiązaniem w przypadku interfejsów API Google Maps Platform, które zapewnia użytkownikom wygodę korzystania z historii transakcji. Z tego przewodnika po implementacji dowiesz się, jak dopasować lokalizację do konkretnego sprzedawcy i jak wyświetlić jego szczegółowe informacje.

Wzbogacone ekrany przykładowych transakcji
Wzbogacone ekrany z przykładowymi transakcjami (kliknij, aby powiększyć)

Włączam interfejsy API

Aby wdrożyć wzbogacone transakcje, musisz włączyć poniższe interfejsy API w konsoli Google Cloud. Te hiperlinki prowadzą do konsoli Google Cloud, gdzie możesz włączyć poszczególne interfejsy API w wybranym projekcie:

Więcej informacji o konfiguracji znajdziesz w artykule Pierwsze kroki z Google Maps Platform.

Sekcje przewodnika po implementacji

Poniżej opisujemy implementacje i dostosowania, które omówimy.

  • Ikona potwierdzenia to główny etap wdrażania.
  • Ikona gwiazdki to opcjonalne, ale zalecane dostosowanie w celu ulepszenia rozwiązania.
Pasowanie sprzedawców do Google Maps Platform Powiązanie sprzedawcy w historii transakcji z miejscem w Google Maps Platform.
Wyświetlanie informacji o sprzedawcy Pokaż transakcje z dużą ilością danych, które zawierają przydatne informacje o sprzedawcy, aby użytkownicy mogli szybko rozpoznać transakcję.
Dodawanie mapy z lokalizacją sprzedawcy Dodaj mapę z lokalizacją sprzedawcy.

Dopasowywanie sprzedawców do Google Maps Platform

W tym przykładzie użyto interfejsu Place API.

Na tym diagramie widać, w jaki sposób aplikacja dopasowuje transakcje sprzedawcy w celu zwrócenia wyniku z wykorzystaniem informacji o miejscu z istniejącej bazy danych sprzedawców lub żądania wyszukiwania miejsc:

Tabela procesu dopasowywania sprzedawców
Tabela procesów dopasowywania sprzedawców (kliknij, aby powiększyć)

Uzyskiwanie identyfikatorów miejsc Google Maps Platform

Być może masz bazę danych sprzedawców zawierającą podstawowe informacje, takie jak nazwa firmy i jej adres. Aby uzyskać informacje o tym miejscu dostępne przez Google Maps Platform, w tym dane kontaktowe i przesłane przez użytkowników, potrzebujesz identyfikatora miejsca Google Maps Platform odpowiadającego każdemu sprzedawcy w Twojej bazie danych.

Aby uzyskać identyfikator miejsca danej firmy, wyślij żądanie do punktu końcowego /findplacefromtext w interfejsie Places API i poproś tylko o pole place_id, aby rozliczyć żądanie w ramach bezpłatnego wywołania Znajdź miejsce – tylko identyfikator. Jeśli sprzedawca ma kilka lokalizacji, użyj jego nazwy w połączeniu z nazwą miasta lub ulicy. Jakość danych zwracanych przez to wywołanie może być różna, musisz więc sprawdzić, czy zwrócone wyniki odpowiadają sprzedawcy.

Oto przykład prośby o identyfikator miejsca dla biura Google w Tajpej, podając nazwę sprzedawcy i miasto:

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

Pamiętaj, aby zakodować adres URL w żądaniu do interfejsu API.

Przechowywanie identyfikatorów miejsc

Aby przechowywać informacje o sprzedawcy z Google Maps Platform na potrzeby przyszłych żądań, możesz bezterminowo zapisywać identyfikator miejsca w bazie danych jako atrybut wpisu o sprzedawcy. Żądanie Znajdź miejsce wystarczy wysłać raz na sprzedawcę. Możesz też wyszukiwać identyfikator miejsca za każdym razem, gdy użytkownik wysyła żądanie szczegółów transakcji.

Aby zawsze mieć najdokładniejsze informacje, odśwież identyfikatory miejsc co 12 miesięcy za pomocą żądania Place Details (Szczegóły miejsca) z parametrem place_id.

Jeśli wyświetlane szczegóły miejsca nie zgadzają się ze sprzedawcą, u którego zrealizował transakcję, zalecamy umożliwienie użytkownikom przesyłania opinii o jakości dopasowania sprzedawcy.

Wyświetlanie informacji o sprzedawcy

W tym przykładzie użyto interfejsu Place API. Dostępny też: Pakiet SDK Miejsc na Androida | Pakiet SDK Miejsc na iOS | Biblioteka miejsc, Maps JavaScript API

Możesz udostępniać szczegóły miejsca, które użytkownicy muszą znać po odwiedzeniu jednej z Twoich lokalizacji. Dzięki rozbudowanym informacjom o miejscu, takim jak informacje kontaktowe, godziny pracy, oceny i zdjęcia użytkowników, aplikacja może przypominać użytkownikom o zakończonych transakcjach. Po wywołaniu interfejsu Places API w celu pobrania szczegółów miejsca możesz filtrować i renderować odpowiedź w oknie informacyjnym, internetowym pasku bocznym lub w dowolny inny sposób.

Przykładowy ekran z informacjami o sprzedawcy
Przykładowy ekran z informacjami o sprzedawcy (kliknij, aby powiększyć)

Aby poprosić o szczegóły dotyczące miejsca, potrzebujesz identyfikatora każdej z Twoich lokalizacji. Informacje o tym, jak pobrać identyfikator miejsca swojej lokalizacji, znajdziesz w artykule Uzyskiwanie identyfikatorów miejsc.

To żądanie dotyczące szczegółów miejsca zwraca adres, współrzędne, witrynę, numer telefonu, ocenę i godziny w danych wyjściowych json dla identyfikatora miejsca 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

Dodawanie mapy z lokalizacją sprzedawcy

W tym przykładzie użyto: Geocoding API | Map Static API Dostępna również: Android | iOS

Określanie lokalizacji sprzedawcy

Maps Static API akceptuje adres lub współrzędne w celu umieszczenia znacznika. Jeśli Twój rekord sprzedawcy ma już adres, możesz przejść do następnej sekcji, ale zalecamy użycie współrzędnych zamiast adresów, aby zwiększyć dokładność mapy.

Jeśli w Twojej bazie danych sprzedawcy znajdują się adresy, ale nie współrzędne geograficzne, a nie wysyłasz jeszcze prośby o szczegóły dotyczące miejsca, możesz użyć interfejsu Geocoding API, aby przekonwertować adresy na współrzędne szerokości i długości geograficznej po stronie serwera, zapisać współrzędne w bazie danych i odświeżyć współrzędne co najmniej raz na 30 dni.

Oto przykład wykorzystania interfejsu Geocoding API w celu uzyskania szerokości i długości geograficznej identyfikatora miejsca biura Google Taipei:

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

Dodawanie znacznika lokalizacji sprzedawcy do mapy

Zamiast przeglądać czy poruszać się po mapie użytkownicy będą widzieć ją w celu potwierdzenia transakcji, dlatego musisz utworzyć mapę o ograniczonej interaktywności.

W przypadku stron na komputery i urządzenia mobilne utwórz adres URL statycznego interfejsu API Map Google z jednym znacznikiem na szerokości i długości geograficznej lub adresie sprzedawcy. Możesz użyć interfejsu Maps Static API za pomocą wywołania usługi internetowej, które utworzy wersję obrazu mapy z uwzględnieniem określonych przez Ciebie parametrów. W przypadku urządzeń mobilnych przejdź do następnego kroku Dodawanie mapy w sekcji aplikacji mobilnej.

Poniższa rozmowa przedstawia plan działania o rozmiarze 640 x 480 pikseli wyśrodkowany na znaczniku w biurze Google w Tajpej przy domyślnym poziomie powiększenia. Zawiera też czerwony znacznik miejsca dostawy oraz styl mapy w chmurze:

    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

Informacje można podzielić na następujące sekcje:

URL interfejsu API https://maps.googleapis.com/maps/api/staticmap?
Rozmiar obrazu rozmiar=640x480
Znaczniki lokalizacji sprzedawcy (korzystające z kodowania adresów URL) markery=kolor:czerwony%7C25.033976%2C121.5645389
Styl mapy w chmurze mapa_id=b224095f76859890
Klucz interfejsu API key=TWÓJ_KLUCZ_INTERFEJSU
Podpis cyfrowy (dowiedz się, jak cyfrowy podpisać prośbę). podpis=BASE64_SIGNATURE
Parametr kanału rozwiązania (patrz dokumentacja parametrów). Solutions_channel=GMP_guides_enrichedtransactions_v1_a

Spowoduje to zmianę obrazu w ten sposób:

Statyczny obraz mapy biura Google Taipei

Możesz też użyć adresu jako lokalizacji znacznika:

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

Informacje o dodatkowych opcjach parametrów znajdziesz w dokumentacji interfejsu Maps Static API.

Dodawanie mapy w aplikacji mobilnej

Jeśli używasz pakietu SDK Map Google na Androida lub pakietu SDK Map Google na iOS, możesz umieścić znacznik za pomocą współrzędnych z informacji w Szczegółach miejsca.

Ponieważ użytkownicy będą widzieć mapę tylko w celu potwierdzenia transakcji, zamiast przeglądać ją lub korzystać z nawigacji, wybierz mapę o ograniczonej interaktywności: