Przewodnik po implementacji rozszerzonych transakcji

Omówienie

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.

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:

• Places API.
• Geocoding API
• Maps static API, Maps SDK na Androida lub Maps SDK na iOS

Sekcje z przewodnikiem po implementacji

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

• check_circle_filled Podstawowym krokiem w implementacji jest ikona znacznika wyboru.
• stars Ikona gwiazdki to opcjonalne, ale zalecane dostosowanie. w celu ulepszenia rozwiązania.

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:

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.

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.

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

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:

Będzie to obraz taki jak poniżej:

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:

• Informacje o aplikacjach na Androida znajdziesz w artykule Dodawanie mapy za pomocą znacznika, i włącz wersję uproszczoną aby zapewnić ograniczoną interaktywność.
• Informacje o aplikacjach na iOS znajdziesz w samouczku na temat dodawania mapy za pomocą znacznika. i wyłączanie elementów sterujących i gestów z flagą GMSUiSettings.