Przewodnik po implementacji rozszerzonych transakcji

Omówienie

sieć iOS Interfejs API

Google Maps Platform można używać w przeglądarkach (JS, TS), na Androidzie i iOS, a także interfejsy API usług internetowych, które pozwalają uzyskać informacje o miejscach, i odległości. Przykłady w tym przewodniku dotyczą jednej platformy, podane są linki do dokumentacji na potrzeby implementacji na innych platformach.

Wyciągi dotyczące transakcji są często trudne do zrozumienia dla użytkowników, ponieważ skróty, np. „ACMEHCORP” zamiast nazw sprzedawców, np. „Acme Houseware”; co może prowadzić do częstszego kontaktu z obsługą klienta i droższych sporów. Wzbogacone transakcje upraszczają te transakcje i ułatwiają ich obsługę przez zawierające imię i nazwisko sprzedawcy oraz kategorię działalności, zdjęcie sklepu, jego adresu i lokalizacji na mapie, pełnych danych kontaktowych itp. Ten pomaga zwiększyć zadowolenie użytkowników i przejrzystość, a także może zmniejszyć połączenia z obsługą klienta, zwiększenie NPS i wydłużenie czasu spędzonego w aplikacji.

Wzbogacone transakcje – przewodnik po implementacji i wskazówki dotyczące dostosowywania, jakie udostępniamy w ten temat—zalecamy jako optymalne połączenie Interfejsy API Google Maps Platform do tworzenia przydatnego użytkownika historii transakcji i aplikacji. Z tego przewodnika po implementacji dowiesz się, jak dopasować lokalizację z konkretnym sprzedawcą i pokazywać 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ć transakcje wzbogacone, musisz włączyć w Konsola Google Cloud. Te hiperlinki przekierują Cię do konsoli Google Cloud aby włączyć poszczególne interfejsy API w wybranym projekcie:

. Więcej informacji na ten temat znajdziesz w sekcji Uzyskiwanie dostępu zaczęło korzystać z Google Maps Platform.

Sekcje z przewodnikiem po implementacji

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

  • Podstawowym krokiem w implementacji jest ikona znacznika wyboru.
  • Ikona gwiazdki to opcjonalne, ale zalecane dostosowanie. w celu ulepszenia rozwiązania.
Zgodność sprzedawców z 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ą pomocne informacje na temat sprzedawcy, aby użytkownicy mogli szybko rozpoznać transakcję.
Dodawanie mapy lokalizacji sprzedawcy Dodaj mapę lokalizacji sprzedawcy.

Dopasowywanie sprzedawców z Google Maps Platform

W tym przykładzie wykorzystano: Places API

Schemat poniżej pokazuje, jak aplikacja pasuje do transakcji sprzedawcy , aby zwrócić wynik przy użyciu informacji o miejscu z istniejącej bazy danych sprzedawców. lub poprzez zapytanie w wyszukiwarce miejsca:

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 z podstawowymi informacjami o swojej firmie, imię i nazwisko oraz adres. Aby uzyskać informacje, które Google Maps Platform ma o tego miejsca, w tym dane kontaktowe i przesłane przez użytkowników, będzie potrzebować identyfikatora miejsca Google Maps Platform, który odpowiada każdemu sprzedawców w swojej bazie danych.

Aby uzyskać identyfikator miejsca dla firmy, wyślij prośbę do Punkt końcowy /findplacefromtext w: interfejsu Places API i zażądać tylko pola place_id wystawić prośbę jako bezpłatny Znajdź miejsce – tylko dokument tożsamości . Jeśli sprzedawca ma kilka lokalizacji, użyj jego nazwy w wraz z nazwą miasta lub ulicy. Jakość danych zwróconych przez będzie się różnić, więc musisz sprawdzić, czy wyniki zostały zwrócone które są zgodne z wybranym sprzedawcą.

Oto przykład prośby o identyfikator miejsca dla biura Google w Tajpej za pomocą 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 parametr wejściowy w żądaniu do interfejsu API.

Identyfikatory miejsc przechowywania

Aby w przyszłości przechowywać informacje o sprzedawcy z Google Maps Platform żądań, możesz zapisać identyfikator tego miejsca w bazie danych sprzedawcy jako atrybut. Ty powinna przesłać tylko jedno żądanie Znajdź miejsce dla każdego sprzedawcy. Dostępne opcje identyfikator miejsca za każdym razem, gdy użytkownik poprosi o szczegóły transakcji.

Aby mieć pewność, że zawsze masz jak najdokładniejsze informacje, odśwież identyfikatory miejsc co 12 miesięcy za pomocą szczegółów miejsca z parametrem place_id.

Jeśli podane przez Ciebie informacje o miejscu nie są zgodne ze sprzedawcą przeprowadził transakcję, zalecamy umożliwienie użytkownikom przekazywania opinii na temat jakości dopasowania sprzedawcy.

Wyświetlanie informacji o sprzedawcy

W tym przykładzie wykorzystano: Places API Dostępne też: SDK Miejsc na Androida | SDK Miejsc na iOS | Biblioteka Miejsc, Maps JavaScript API

Możesz udostępnić informacje o miejscu, które użytkownicy muszą znać po odwiedzeniu jednego z Twoich lokalizacji. Szczegółowe informacje o miejscach, takie jak dane kontaktowe, godziny otwarcia, ocen użytkowników i zdjęć, aplikacja może przypominać użytkownikom, transakcji. Po nawiązaniu połączenia z Places API do pobierania szczegółów miejsc; możesz filtrować i renderować odpowiedź w oknie informacyjnym lub na pasku bocznym w internecie 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. Patrz: Uzyskiwanie identyfikatorów miejsc. aby uzyskać identyfikator miejsca dla swojej lokalizacji.

Żądanie dotyczące informacji o miejscu zwraca adres, współrzędne, stronę internetową numer telefonu, ocena i godziny w wyniku json dla Google Taipei 101 identyfikator miejsca:

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 wykorzystano: Geocoding API | Statyczny interfejs API Map Google Dostępne też: Android | iOS

Określanie lokalizacji sprzedawcy

Maps Static API akceptuje adres lub współrzędne do rozmieszczenia znacznik. Jeśli dane sprzedawcy mają już adres, możesz przejść do następnego kroku. do następnej sekcji, ale zalecamy stosowanie współrzędnych zamiast adresów na mapie precyzję.

Jeśli baza danych sprzedawcy zawiera adresy, ale nie współrzędne geograficzne a nie wysłano jeszcze prośby o informacje o miejscu, za pomocą interfejsu Geocoding API możesz przekonwertować adresy szerokości i długości geograficznej po stronie serwera. Zachowaj współrzędne bazy danych i odświeżaj współrzędne raz co najmniej na 30 dni.

Oto przykład użycia interfejsu Geocoding API do pobrania szerokość i długość geograficzna identyfikatora miejsca w biurze Google Tajpej:

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ę, aby potwierdzać transakcje, zamiast przeglądać lub nawigacji, chcesz 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. szerokości i długości geograficznej lub adresu sprzedawcy. Za pomocą Maps static API za pomocą wywołania usługi sieciowej, które tworzy graficzną wersję mapy z uwzględnieniem określonych przez Ciebie parametrów. W przypadku urządzenia mobilnego przejdź do następna Dodawanie mapy w sekcji aplikacji mobilnej

Poniższe wywołanie przedstawia plan działania o rozmiarze 640 x 480 pikseli wyśrodkowany na w biurze Google w Tajpej na 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). signature=BASE64_SIGNATURE
Parametr kanału rozwiązania (zobacz dokumentacji 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 tutaj: Dokumentacja statycznego interfejsu API Map Google.

Dodawanie mapy w aplikacji mobilnej

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

Użytkownicy będą widzieć mapę, aby potwierdzać transakcje, zamiast przeglądać lub nawigacji, należy wybrać mapę o ograniczonej interaktywności: