Przewodnik po implementacji rozszerzonych transakcji

Przegląd

web iOS Interfejs API

Usługa Google Maps Platform jest dostępna w wersji internetowej (JS, TS), na Androida i iOS. Oferuje również interfejsy API usług internetowych do uzyskiwania informacji o miejscach, trasach dojazdu i odległościach. Przykłady w tym przewodniku zostały napisane z myślą o 1 platformie, ale podane są linki do dokumentacji na potrzeby implementacji na innych platformach.

Zdania dotyczące transakcji są często trudne do zrozumienia dla użytkowników. Użycie skrótów takich jak „ACMEHCORP” zamiast nazw sprzedawców (np. „Acme Houseware”), co może prowadzić do większej liczby połączeń z obsługą klienta i kosztownych sporów. Wzbogacone transakcje upraszczają te transakcje i ułatwiają ich obsługę dzięki udostępnieniu pełnej nazwy i kategorii działalności sprzedawcy, zdjęcia witryny sklepu, jej adresu i lokalizacji na mapie, pełnych danych kontaktowych oraz innych informacji. Pomoże to zwiększyć zadowolenie użytkowników i przejrzystość, a także ograniczyć liczbę połączeń z obsługą klienta, zwiększyć NPS i wydłużyć czas spędzany w aplikacji.

Wzbogacone transakcje – przewodnik po implementacji i wskazówki dotyczące dostosowywania, które podajemy w tym temacie – to optymalne połączenie 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 wyświetlić jego szczegółowe informacje.

Wzbogacone ekrany przykładowych transakcji
Przykładowe wzbogacone ekrany transakcji (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 przekierują Cię do konsoli Google Cloud umożliwiającej włączenie poszczególnych interfejsów API w wybranym projekcie:

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

Sekcje z przewodnikiem po implementacji

Poniżej omawiamy implementacje i opcje dostosowywania, które omówimy w tym temacie.

  • Głównym krokiem w implementacji jest ikona znacznika wyboru.
  • Ikona gwiazdki to opcjonalne, ale zalecane dostosowanie, które ulepsza rozwiązanie.
Zgodność sprzedawców z Google Maps Platform Powiązanie sprzedawcy w historii transakcji z miejscem w Google Maps Platform.
Wyświetlanie informacji o sprzedawcy Pokazuj transakcje pełne danych, które zawierają przydatne informacje o sprzedawcy, dzięki czemu użytkownicy mogą je szybko rozpoznać.
Dodawanie mapy lokalizacji sprzedawcy Dodaj mapę lokalizacji sprzedawcy.

Dopasowywanie sprzedawców z Google Maps Platform

W tym przykładzie zastosowano: interfejs Places API

Poniższy diagram pokazuje, w jaki sposób aplikacja dopasowuje transakcje sprzedawcy, aby zwrócić wynik przy użyciu informacji o miejscu z istniejącej bazy danych sprzedawców lub żądania wyszukiwania miejsc:

Schemat procesu dopasowywania sprzedawców
Schemat procesu dopasowywania sprzedawcy (kliknij, aby powiększyć)

Uzyskiwanie identyfikatorów miejsc Google Maps Platform

Możesz mieć bazę sprzedawców, która zawiera podstawowe informacje, takie jak nazwa firmy i jej adres. Aby uzyskać informacje o tym miejscu przez Google Maps Platform, w tym dane kontaktowe i przesłane przez użytkowników, potrzebujesz identyfikatora miejsca w Google Maps Platform, który odpowiada każdemu sprzedawcy w Twojej bazie danych.

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

Oto przykład żądania identyfikatora miejsca dla biura Google w Tajpej z użyciem nazwy sprzedawcy i miasta:

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 parametr wejściowy w żądaniu do interfejsu API.

Identyfikatory miejsc przechowywania

Aby przechowywać informacje o sprzedawcy z Google Maps Platform na potrzeby przyszłych zamówień, możesz zapisywać ten identyfikator miejsca na czas nieokreślony w bazie danych jako atrybut w rejestrze sprzedawcy. Wystarczy, że raz wyślesz prośbę o znalezienie miejsca dla każdego sprzedawcy. Możesz też wyszukiwać identyfikator miejsca za każdym razem, gdy użytkownik poprosi o szczegóły transakcji.

Aby zapewnić użytkownikom jak najdokładniejsze informacje, co 12 miesięcy odświeżaj identyfikatory miejsc za pomocą żądania Szczegóły miejsca z parametrem place_id.

Jeśli wyświetlane informacje o miejscu nie są zgodne ze sprzedawcą, u którego zrealizował transakcję, zalecamy umożliwienie użytkownikom przekazywania opinii na temat jakości dopasowania sprzedawcy.

Wyświetlanie informacji o sprzedawcy

W tym przykładzie zastosowano: interfejs Places API Dostępne też: Places SDK for Android | Places SDK for iOS | Places Library, Maps JavaScript API

Możesz udostępnić informacje o miejscu, które użytkownicy muszą znać po odwiedzeniu jednej z Twoich lokalizacji. Szczegółowe informacje o miejscach, takie jak informacje kontaktowe, godziny pracy, oceny i zdjęcia użytkowników, mogą przypominać użytkownikom o zakończeniu transakcji. Po wywołaniu interfejsu Places API w celu pobrania szczegółów miejsca możesz filtrować i renderować odpowiedź w oknie informacyjnym, na 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 przesłać prośbę o podanie informacji o miejscu, potrzebujesz identyfikatora miejsca każdej z lokalizacji. Aby dowiedzieć się, jak pobrać identyfikator miejsca dla swojej lokalizacji, zobacz Uzyskiwanie identyfikatorów miejsc.

To żądanie dotyczące informacji o miejscu zwraca adres, współrzędne, adres strony internetowej, numer telefonu, ocenę i godziny otwarcia 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 lokalizacji sprzedawcy

W tym przykładzie zastosowano: interfejs Geocoding API | Maps Static API Dostępny też: Android | iOS

Określanie lokalizacji sprzedawcy

Maps Static API akceptuje adres lub współrzędne, by umieścić znacznik. Jeśli Twój rekord sprzedawcy zawiera 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 Twoja baza danych sprzedawcy zawiera adresy, ale nie współrzędne geograficzne, i nie wysyłasz żądań dotyczących informacji o miejscu, możesz użyć interfejsu Geocoding API do konwertowania adresów na współrzędne szerokości i długości geograficznej po stronie serwera, zapisywania współrzędnych w bazie danych i odświeżania współrzędnych co najmniej raz na 30 dni.

Oto przykład użycia interfejsu Geocoding API do uzyskania szerokości i długości geograficznej identyfikatora miejsca w 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

Użytkownicy będą widzieć mapę do potwierdzania transakcji, zamiast przeglądać czy nawigować, dlatego należy utworzyć mapę o ograniczonej interaktywności.

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

Poniższe połączenie przedstawia plan o rozmiarze 640 x 480 pikseli wyśrodkowany na znaczniku w biurze Google w Tajpej przy domyślnym poziomie powiększenia. Określa też czerwony znacznik lokalizacji dostawy i styl mapy 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

Zostały one podzielone na te sekcje:

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

Będzie to obraz taki jak poniżej:

Obraz statycznej mapy biura Google w Tajpej

Jako lokalizacji znacznika możesz też użyć adresu:

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

Dodatkowe opcje parametrów znajdziesz w dokumentacji statycznego interfejsu Maps API.

Dodawanie mapy w aplikacji mobilnej

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

Aby potwierdzić transakcje, zamiast przeglądać czy nawigować, użytkownicy będą widzieć mapę, więc wybierz mapę o ograniczonej interaktywności: