Omówienie
Google Maps Platform jest dostępny w przeglądarkach (JS, TS) oraz na urządzeniach z Androidem i iOS. Udostępnia też interfejsy API usług internetowych do uzyskiwania informacji o miejscach, wskazówkach dojazdu i odległościach. Przykłady w tym przewodniku dotyczą jednej platformy, ale podane są linki do dokumentacji na temat implementacji na innych platformach.
Wyrażenia transakcji są często trudne do zrozumienia dla użytkowników, ponieważ zamiast nazw sprzedawców, takich jak „Acme Houseware”, używają skrótów typu „ACMEHCORP”, co może prowadzić do częstszego kontaktu z obsługą klienta i prowadzenia kosztownych sporów. Wzbogacone transakcje upraszczają te transakcje i sprawiają, że są one bardziej intuicyjne, przez podanie pełnej nazwy sprzedawcy, kategorii działalności, zdjęcia witryny sklepu, adresu i lokalizacji na mapie oraz pełnych informacji kontaktowych. Pomaga to zwiększyć zadowolenie użytkowników i przejrzystość. Może też zmniejszyć liczbę połączeń z obsługą klienta, zwiększyć NPS i wydłużyć czas spędzany w aplikacji.
Wzbogacone transakcje, czyli przewodnik po implementacji i wskazówki dotyczące dostosowywania, które omówiliśmy w tym temacie, są zalecanym rozwiązaniem w przypadku interfejsów API Google Maps Platform, które zapewnia użytkownikom wygodę korzystania z historii transakcji. Z tego przewodnika po implementacji dowiesz się, jak dopasować lokalizację do konkretnego sprzedawcy i jak wyświetlić jego szczegółowe informacje.
Włączam interfejsy API
Aby wdrożyć wzbogacone transakcje, musisz włączyć poniższe interfejsy API w konsoli Google Cloud. Te hiperlinki prowadzą do konsoli Google Cloud, gdzie możesz włączyć poszczególne interfejsy API w wybranym projekcie:
- Interfejs Places API.
- Geocoding API.
- Map Static API, pakiet SDK Map Google na Androida lub pakiet SDK Map Google na iOS.
Sekcje przewodnika po implementacji
Poniżej opisujemy implementacje i dostosowania, które omówimy.
- Ikona potwierdzenia to główny etap wdrażania.
- Ikona gwiazdki to opcjonalne, ale zalecane dostosowanie w celu ulepszenia rozwiązania.
Pasowanie sprzedawców do 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ą przydatne informacje o sprzedawcy, aby użytkownicy mogli szybko rozpoznać transakcję. | |
Dodawanie mapy z lokalizacją sprzedawcy | Dodaj mapę z lokalizacją sprzedawcy. |
Dopasowywanie sprzedawców do Google Maps Platform
W tym przykładzie użyto interfejsu Place API. |
Na tym diagramie widać, w jaki sposób aplikacja dopasowuje transakcje sprzedawcy w celu zwrócenia wyniku z wykorzystaniem informacji o miejscu z istniejącej bazy danych sprzedawców lub żądania wyszukiwania miejsc:
Uzyskiwanie identyfikatorów miejsc Google Maps Platform
Być może masz bazę danych sprzedawców zawierającą podstawowe informacje, takie jak nazwa firmy i jej adres. Aby uzyskać informacje o tym miejscu dostępne przez Google Maps Platform, w tym dane kontaktowe i przesłane przez użytkowników, potrzebujesz identyfikatora miejsca Google Maps Platform odpowiadającego każdemu sprzedawcy w Twojej bazie danych.
Aby uzyskać identyfikator miejsca danej firmy, wyślij żądanie do punktu końcowego /findplacefromtext w interfejsie Places API i poproś tylko o pole place_id
, aby rozliczyć żądanie w ramach bezpłatnego wywołania Znajdź miejsce – tylko identyfikator. Jeśli sprzedawca ma kilka lokalizacji, użyj jego nazwy w połączeniu z nazwą miasta lub ulicy. Jakość danych zwracanych przez to wywołanie może być różna, musisz więc sprawdzić, czy zwrócone wyniki odpowiadają sprzedawcy.
Oto przykład prośby o identyfikator miejsca dla biura Google w Tajpej, podając 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 w żądaniu do interfejsu API.
Przechowywanie identyfikatorów miejsc
Aby przechowywać informacje o sprzedawcy z Google Maps Platform na potrzeby przyszłych żądań, możesz bezterminowo zapisywać identyfikator miejsca w bazie danych jako atrybut wpisu o sprzedawcy. Żądanie Znajdź miejsce wystarczy wysłać raz na sprzedawcę. Możesz też wyszukiwać identyfikator miejsca za każdym razem, gdy użytkownik wysyła żądanie szczegółów transakcji.
Aby zawsze mieć najdokładniejsze informacje, odśwież identyfikatory miejsc co 12 miesięcy za pomocą żądania Place Details (Szczegóły miejsca) z parametrem place_id
.
Jeśli wyświetlane szczegóły miejsca nie zgadzają się ze sprzedawcą, u którego zrealizował transakcję, zalecamy umożliwienie użytkownikom przesyłania opinii o jakości dopasowania sprzedawcy.
Wyświetlanie informacji o sprzedawcy
W tym przykładzie użyto interfejsu Place API. | Dostępny też: Pakiet SDK Miejsc na Androida | Pakiet SDK Miejsc na iOS | Biblioteka miejsc, Maps JavaScript API |
Możesz udostępniać szczegóły miejsca, które użytkownicy muszą znać po odwiedzeniu jednej z Twoich lokalizacji. Dzięki rozbudowanym informacjom o miejscu, takim jak informacje kontaktowe, godziny pracy, oceny i zdjęcia użytkowników, aplikacja może przypominać użytkownikom o zakończonych transakcjach. Po wywołaniu interfejsu Places API w celu pobrania szczegółów miejsca możesz filtrować i renderować odpowiedź w oknie informacyjnym, internetowym pasku bocznym lub w dowolny inny sposób.
Aby poprosić o szczegóły dotyczące miejsca, potrzebujesz identyfikatora każdej z Twoich lokalizacji. Informacje o tym, jak pobrać identyfikator miejsca swojej lokalizacji, znajdziesz w artykule Uzyskiwanie identyfikatorów miejsc.
To żądanie dotyczące szczegółów miejsca zwraca adres, współrzędne, witrynę, numer telefonu, ocenę i godziny w danych wyjściowych json
dla identyfikatora miejsca Google Taipei 101:
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 z lokalizacją sprzedawcy
W tym przykładzie użyto: Geocoding API | Map Static API | Dostępna również: Android | iOS |
Określanie lokalizacji sprzedawcy
Maps Static API akceptuje adres lub współrzędne w celu umieszczenia znacznika. Jeśli Twój rekord sprzedawcy ma już adres, możesz przejść do następnej sekcji, ale zalecamy użycie współrzędnych zamiast adresów, aby zwiększyć dokładność mapy.
Jeśli w Twojej bazie danych sprzedawcy znajdują się adresy, ale nie współrzędne geograficzne, a nie wysyłasz jeszcze prośby o szczegóły dotyczące miejsca, możesz użyć interfejsu Geocoding API, aby przekonwertować adresy na współrzędne szerokości i długości geograficznej po stronie serwera, zapisać współrzędne w bazie danych i odświeżyć współrzędne co najmniej raz na 30 dni.
Oto przykład wykorzystania interfejsu Geocoding API w celu uzyskania szerokości i długości geograficznej identyfikatora miejsca biura Google Taipei:
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
Zamiast przeglądać czy poruszać się po mapie użytkownicy będą widzieć ją w celu potwierdzenia transakcji, dlatego musisz utworzyć mapę o ograniczonej interaktywności.
W przypadku stron na komputery i urządzenia mobilne utwórz adres URL statycznego interfejsu API Map Google z jednym znacznikiem na szerokości i długości geograficznej lub adresie sprzedawcy. Możesz użyć interfejsu Maps Static API za pomocą wywołania usługi internetowej, które utworzy wersję obrazu mapy z uwzględnieniem określonych przez Ciebie parametrów. W przypadku urządzeń mobilnych przejdź do następnego kroku Dodawanie mapy w sekcji aplikacji mobilnej.
Poniższa rozmowa przedstawia plan działania o rozmiarze 640 x 480 pikseli wyśrodkowany na znaczniku w biurze Google w Tajpej przy domyślnym poziomie powiększenia. Zawiera też czerwony znacznik miejsca dostawy oraz styl mapy w chmurze:
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
Informacje można podzielić na następujące sekcje:
URL interfejsu API | https://maps.googleapis.com/maps/api/staticmap? |
Rozmiar obrazu | rozmiar=640x480 |
Znaczniki lokalizacji sprzedawcy (korzystające z kodowania adresów URL) | markery=kolor:czerwony%7C25.033976%2C121.5645389 |
Styl mapy w chmurze | mapa_id=b224095f76859890 |
Klucz interfejsu API | key=TWÓJ_KLUCZ_INTERFEJSU |
Podpis cyfrowy (dowiedz się, jak cyfrowy podpisać prośbę). | podpis=BASE64_SIGNATURE |
Parametr kanału rozwiązania (patrz dokumentacja parametrów). | Solutions_channel=GMP_guides_enrichedtransactions_v1_a |
Spowoduje to zmianę obrazu w ten sposób:
Możesz też użyć adresu jako lokalizacji znacznika:
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
Informacje o dodatkowych opcjach parametrów znajdziesz w dokumentacji interfejsu Maps Static API.
Dodawanie mapy w aplikacji mobilnej
Jeśli używasz pakietu SDK Map Google na Androida lub pakietu SDK Map Google na iOS, możesz umieścić znacznik za pomocą współrzędnych z informacji w Szczegółach miejsca.
Ponieważ użytkownicy będą widzieć mapę tylko w celu potwierdzenia transakcji, zamiast przeglądać ją lub korzystać z nawigacji, wybierz mapę o ograniczonej interaktywności:
- W przypadku aplikacji na Androida przeczytaj samouczek dodawania mapy ze znacznikiem i włącz tryb uproszczony, aby ograniczyć interaktywność.
- W przypadku aplikacji na iOS przeczytaj samouczek dodawania mapy ze znacznikiem i wyłącz elementy sterujące i gesty za pomocą flagi
GMSUiSettings
.