Omówienie
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.
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:
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.
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:
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ść:
- W przypadku aplikacji na Androida zapoznaj się z samouczkiem dodawania mapy z oznaczeniem i włącz tryb uproszczony, aby zapewnić ograniczoną interaktywność.
- W przypadku aplikacji na iOS zapoznaj się z samouczkiem dodawania mapy z oznacznikami oraz wyłącz kontrolki i gesty za pomocą flagi
GMSUiSettings
.