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, wskazówek i odległości. 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 nazwy sprzedawcy, np. „Acme Houseware”. Może to prowadzić do zwiększenia liczby połączeń z obsługą klienta i drogich sporów. Usługi wzbogacone o dane ułatwiają i uproszczają transakcje, ponieważ zawierają pełną nazwę i kategorię firmy, zdjęcie sklepu, adres i położenie 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 raportów historii transakcji. 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łącz interfejsy API

Aby wdrożyć transakcje wzbogacone, musisz włączyć te interfejsy API w konsoli Google Cloud. 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

Oto implementacje i ustawienia, które omawiamy w tym artykule:

  • 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 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 tym miejscu dostępne w Google Maps Platform, w tym dane kontaktowe i informacje przesłane przez użytkowników, musisz mieć identyfikator 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, podając tylko pole place_id, aby obciążyć żądanie jako bezpłatne wywołanie interfejsu Find Place – ID only. Jeśli sprzedawca ma kilka lokalizacji, użyj nazwy sprzedawcy w połączeniu z nazwą miasta lub ulicy. Jakość danych zwróconych przez wywołanie jest różna, dlatego musisz sprawdzić, czy zwrócone wyniki rzeczywiście pasują do sprzedawcy.

Oto przykład żądania identyfikatora miejsca dla biura Google w Tajpej, w którym używamy nazwy sprzedawcy i miasta:

```html
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.

przechowywać identyfikatory miejsc,

Aby przechowywać informacje o sprzedawcu 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 informacje o miejscu nie pasują do sprzedawcy, w którego sklepie 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 zakoń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:

```html
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
```

Dodaj mapę z lokalizacją 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. Zalecamy jednak 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 Geocoding API do uzyskania szerokości i długości geograficznej identyfikatora miejsca biura Google w Tajwanie:

```html
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ć mapy ani nią 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:

```html
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
```

Rozmowa jest podzielona na te sekcje:

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 parametru) solution_channel=GMP_guides_enrichedtransactions_v1_a

Wynik będzie wyglądał tak:

Statyczny obraz mapy biura Google w Tajpej

Jako lokalizację znacznika możesz też użyć adresu:

```html
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ść: