Przewodnik po implementacji rozszerzonych transakcji

Omówienie

web iOS API

Google Maps Platform jest dostępna w wersji internetowej (JS, TS), na Androida i iOS. Oferuje też interfejsy API usług internetowych do uzyskiwania informacji o miejscach, kierunkach i odległościach. Przykłady w tym przewodniku zostały napisane z myślą o jednej platformie, ale w dokumentacji znajdziesz linki do implementacji na innych platformach.

Oświadczenia o transakcji są często trudne do zrozumienia dla użytkowników, ponieważ zawierają skróty takie jak „ACMEHCORP” zamiast nazw sprzedawców takich jak „Acme Houseware”. Może to prowadzić do zwiększenia liczby połączeń z obsługą klienta i drogich sporów. Usługi wzbogacone ułatwiają i upraszczają transakcje, podając pełną nazwę i kategorię firmy, zdjęcie witryny sklepowej, adres i lokalizację na mapie, pełne dane kontaktowe i inne informacje. Pomoże to zwiększyć zadowolenie użytkowników i przejrzystość, a także może zmniejszyć liczbę połączeń z zespołem pomocy, zwiększyć NPS i wydłużyć czas spędzany w aplikacji.

Transakcje wzbogacone – w tym artykule znajdziesz przewodnik implementacji i wskazówki dotyczące dostosowywania, które stanowią optymalne połączenie interfejsów API Google Maps Platform, umożliwiające tworzenie atrakcyjnych historii transakcji dla użytkowników. Z tego przewodnika dowiesz się, jak dopasować lokalizację do konkretnego sprzedawcy i wyświetlić szczegółowe informacje o nim.

Przykładowe ekrany wzbogaconych transakcji
Przykładowe ekrany wzbogaconych transakcji (kliknij, aby powiększyć)

Włączam interfejsy API

Aby wdrożyć transakcje wzbogacone, musisz włączyć te interfejsy API w Google Cloud Console. Te hiperlinki przekierowują Cię do konsoli Google Cloud, aby włączyć poszczególne interfejsy API w wybranym projekcie:

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

Sekcje przewodnika po implementacji

Poniżej omówimy implementacje i dostosowywanie, które są związane z tym tematem.

  • Ikona wyboru to kluczowy krok implementacji.
  • Ikona gwiazdy jest opcjonalną, ale zalecaną funkcją dostosowywania, która pozwala ulepszać rozwiązanie.
Dopasowywanie sprzedawców do Google Maps Platform Powiązanie sprzedawcy w historii transakcji z miejscem w Google Maps Platform.
Wyświetlanie informacji o sprzedawcy Wyświetlaj transakcje zawierające wiele danych, które zawierają przydatne informacje o sprzedawcy, aby użytkownicy mogli szybko rozpoznać transakcję.
Dodawanie mapy lokalizacji sprzedawcy Dodaj mapę z lokalizacją sprzedawcy.

Dopasowywanie sprzedawców do Google Maps Platform

Ten przykład korzysta z: Places API

Ten diagram pokazuje, jak aplikacja dopasowuje transakcje sprzedawcy, aby zwrócić wynik za pomocą Szczegółów miejsca z dotychczasowej bazy danych sprzedawców lub za pomocą żądania wyszukiwania miejsca:

Tablica procesu dopasowywania danych o sprzedawcy
Tablica procesu dopasowywania sprzedawców (kliknij, aby powiększyć)

Pobieranie identyfikatorów miejsc w Google Maps Platform

Możesz mieć bazę danych sprzedawców z podstawowymi informacjami, takimi jak nazwa firmy i adres. Aby uzyskać informacje o danym miejscu dostępne w Google Maps Platform, w tym informacje kontaktowe i dane przesłane przez użytkowników, musisz podać identyfikator miejsca w Google Maps Platform odpowiadający 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, podając tylko pole place_id, aby obciążyć żądanie jako bezpłatne wywołanie Find Place – ID only. Jeśli sprzedawca ma kilka lokalizacji, użyj nazwy sprzedawcy w połączeniu z nazwą miasta lub ulicy. Jakość danych zwracanych przez wywołanie może się różnić, dlatego musisz sprawdzić, czy zwrócone wyniki rzeczywiście pasują do wybranego sprzedawcy.

Oto przykład żądania identyfikatora miejsca dla biura Google w Tajpej, w którym używamy 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ć URL parametru wejściowego w żądaniu interfejsu API.

Przechowywanie identyfikatorów miejsc

Aby przechowywać informacje o sprzedawcy z Platformy Map Google na potrzeby przyszłych żądań, możesz zapisać ten identyfikator miejsca na stałe w swojej bazie danych jako atrybut rekordu sprzedawcy. Prośbę o znajdowanie miejsca musisz wysłać tylko raz na sprzedawcę. Możesz też wyszukać identyfikator miejsca za każdym razem, gdy użytkownik poprosi o szczegóły transakcji.

Aby mieć zawsze najdokładniejsze informacje, odświeżaj identyfikatory miejsc co 12 miesięcy, korzystając z żądania Szczegóły miejsca z parametrem place_id.

Jeśli wyświetlane przez Ciebie szczegóły miejsca nie pasują do sprzedawcy, w którego użytkownik dokonał transakcji, zalecamy umożliwienie użytkownikom przesyłania opinii na temat jakości dopasowania sprzedawcy.

Wyświetlanie informacji o sprzedawcy

Ten przykład korzysta z: Places API Dostępne są też te rozwiązania: Pakiet SDK Miejsc na Androida | Pakiet SDK Miejsc na iOS | Biblioteka Miejsc, Maps JavaScript API

Możesz udostępnić informacje o miejscu, które użytkownicy powinni znać po wizycie w jednym z Twoich obiektów. Dzięki szczegółowym informacjom o miejscu, takim jak dane kontaktowe, godziny otwarcia, oceny użytkowników i ich zdjęcia, Twoja aplikacja może przypominać użytkownikom o ukończonej transakcji. Po wywołaniu interfejsu Places API w celu uzyskania szczegółów miejsca możesz odfiltrować i wyrenderować odpowiedź w oknie informacyjnym, na pasku bocznym lub w dowolny inny sposób, o ile nie narusza to naszych Warunków korzystania z usługi.

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

Aby poprosić o szczegóły miejsca, musisz podać identyfikator każdej lokalizacji. Aby pobrać identyfikator miejsca, zapoznaj się z artykułem Pobieranie identyfikatorów miejsc.

Na podstawie identyfikatora miejsca „Google Taipei 101” następująca prośba o szczegóły miejsca zwraca adres, współrzędne, stronę internetową, numer telefonu, ocenę i godziny otwarcia w formacie json:

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

Ten przykład korzysta z: Geocoding API | Maps Static API Dostępne też na: Android | iOS

Określanie lokalizacji sprzedawcy

Interfejs Maps Static API akceptuje adres lub współrzędne do umieszczenia znacznika. Jeśli w rekordzie sprzedawcy jest już podany adres, możesz przejść do następnej sekcji, ale zalecamy używanie współrzędnych zamiast adresów, aby zwiększyć dokładność mapy.

Jeśli baza danych sprzedawcy zawiera adresy ulicy, ale nie ma współrzędnych geograficznych, a nie wysyłasz żądania szczegółów miejsca, możesz użyć interfejsu Geocoding API, aby przekształcić adresy ulicy w współrzędne geograficzne na serwerze, zapisać je w bazie danych i odświeżać co najmniej raz na 30 dni.

Oto przykład użycia interfejsu Geokodowanie API do uzyskania szerokości i długości geograficznej identyfikatora miejsca biura Google w Tajpei:

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ą korzystać z mapy, aby potwierdzać transakcje, a nie przeglądać ani nawigować, dlatego warto utworzyć mapę o ograniczonej interaktywności.

W przypadku komputerów i urządzeń mobilnych utwórz adres URL interfejsu Maps Static API z pojedynczym znacznikiem na współrzędnych geograficznych lub adresie sprzedawcy. Możesz użyć interfejsu Maps Static API, wywołując usługę internetową, która na podstawie podanych przez Ciebie parametrów utworzy wersję mapy w postaci obrazu. W przypadku urządzeń mobilnych przejdź do następnej sekcji Dodawanie mapy w aplikacji mobilnej.

Poniższe wywołanie pokazuje mapę drogową o wymiarach 640 x 480 pikseli, wyśrodkowaną na znaczniku w biurze Google w Tajwanie przy domyślnym poziomie powiększenia. Określa ona też czerwony znacznik lokalizacji dostawy i styl mapy w Google 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

Ta sekcja zawiera te części:

URL interfejsu API https://maps.googleapis.com/maps/api/staticmap?
Rozmiar obrazu size=640x480
Oznaczenia lokalizacji sprzedawcy (za pomocą kodowania adresów URL) markers=color:red%7C25.033976%2C121.5645389
Definiowanie stylów map w Google Cloud map_id=b224095f76859890
Klucz API key=YOUR_API_KEY
Podpis cyfrowy (dowiedz się, jak podpisać cyfrowo prośbę) signature=BASE64_SIGNATURE
Parametr kanału rozwiązania (patrz dokumentacja parametrów) solution_channel=GMP_guides_enrichedtransactions_v1_a

W efekcie obraz będzie wyglądał tak:

Statyczny obraz mapy biura Google w Tajpej

Jako lokalizację 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

Więcej opcji parametrów znajdziesz w dokumentacji interfejsu Maps Static API.

Dodawanie mapy w aplikacji mobilnej

Jeśli używasz pakietu 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.

Użytkownicy będą korzystać z mapy do potwierdzania transakcji, a nie do przeglądania ani nawigacji, dlatego wybierz mapę z ograniczoną interaktywność: