Przekierowywanie użytkowników do informacji o miejscach i trasach w Mapach Google za pomocą adresu URL Map lub interfejsu Places API

W dzisiejszym świecie zorientowanym na lokalizację użytkownicy oczekują łatwego dostępu do informacji o miejscach, wskazówek dojazdu i nawigacji. Niezależnie od tego, czy korzystają z aplikacji do przesyłania wiadomości, aplikacji do odkrywania lokalnego kontekstu, platformy logistycznej i transportowej, planera podróży czy platformy z ofertami nieruchomości, użytkownicy często potrzebują szybkiego dostępu do szczegółów lokalizacji lub znalezienia najlepszej trasy z A do B. Deweloperzy mogą tworzyć własne wrażenia w aplikacji, ale korzystanie z wszechstronnego i znajomego interfejsu Map Google zapewnia lepsze wrażenia.

Dobrze sformatowany adres URL Map Google jest niezbędny do zapewnienia użytkownikom płynnego działania. Nieprawidłowe adresy URL mogą zakłócić to działanie, kierując użytkowników do niewłaściwej lokalizacji, wyświetlając ogólny widok mapy zamiast szczegółowych informacji lub nawet powodując niedziałający link. To frustruje użytkowników i uniemożliwia im osiągnięcie celu. Na przykład nawet przy prawidłowym adresie URL Map użytkownik, który oczekuje informacji o konkretnej firmie, może trafić na ogólny widok mapy bez żadnych istotnych informacji. Zobacz przykład poniżej:

https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152

Ten adres URL Map umożliwia otwieranie Map Google i wyświetlanie lokalizacji na podstawie szerokości i długości geograficznej. Nie udostępnia jednak użytkownikom szczegółowych informacji o konkretnym miejscu.

Bezproblemowe połączenie aplikacji z Mapami Google za pomocą dokładnych adresów URL

Google Maps Platform (GMP) oferuje 2 podstawowe metody tworzenia dokładnych adresów URL: interfejs API Miejsca(Nowy), który wymaga klucza interfejsu API, oraz adresy URL Map, które są bezpłatne i nie wymagają klucza. Poniższe rozwiązania są przeznaczone do różnych scenariuszy i przypadków użycia:

Korzystanie z pola googleMapsUri lub googleMapsLinks interfejsu GMP Places API(New)

Interfejs GMP Places API(nowy) zwraca obszerny zestaw informacji o konkretnym miejscu. Gdy żądasz pola googleMapsUri lub googleMapsLinks (określając je w masce pola), odpowiedź interfejsu API zawiera obiekt miejsce. Ten obiekt zawiera sformatowane adresy URL, które można wykorzystać do bezpośredniego otwierania odpowiednich widoków, np. widoku szczegółów miejsca, w Mapach Google.

Przykład:

Prośba o informacje o miejscu

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: YOUR_API_KEY" \
-H "X-Goog-FieldMask: googleMapsUri,googleMapsLinks" \
https://places.googleapis.com/v1/places/ChIJ3S-JXmauEmsRUcIaWtf4MzE

Odpowiedź na żądanie z danymi miejsca:

{
    "googleMapsUri": "https://maps.google.com/?cid=3545450935484072529",
    "googleMapsLinks": {
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!3e0",
        "placeUri": "https://maps.google.com/?cid=3545450935484072529",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!10e5"
    }
}

ChIJ3S-JXmauEmsRUcIaWtf4MzE w tym przykładzie to identyfikator miejsca, czyli opery w Sydney. Identyfikator miejsca to identyfikator tekstowy, który jednoznacznie identyfikuje miejsce w bazie danych Miejsc Google i w Mapach Google.

Pobieranie identyfikatorów miejsc bezpłatnie

Aby automatycznie pobierać identyfikatory miejsc, możesz użyć funkcji Places API: wyszukiwanie tekstowe(tylko identyfikator). To bezpłatna metoda uzyskiwania identyfikatorów miejsc. Dowiedz się więcej o identyfikatorze miejsca i o żądaniu Place API(nowy).

Zapytanie do interfejsu Places API dotyczące wyszukiwania tekstowego(tylko identyfikator):

curl -X POST -d '{"textQuery" : "Sydney Opera House"}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'

Places API Text Search(ID Only) Response:

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

Identyfikatory miejsc mogą być też pobierane, gdy użytkownik kliknie lub dotknie punktu zainteresowania na mapach. Dowiedz się więcej o klikalnych ikonach punktów zainteresowania(JavaScript, Android, iOS).

Implementacja

Korzystając z interfejsu Places API, deweloperzy mogą po prostu wyodrębnić z odpowiedzi pole googleMapsUri lub googleMapsLinks i użyć go do wyświetlenia odpowiedniego widoku w aplikacji Mapy Google lub w przeglądarce, jeśli aplikacja nie jest zainstalowana.

Zapoznaj się ze wskazówkami dla programistów i wypróbuj tę funkcję już dziś.

Korzystanie z adresów URL Map

Za pomocą adresów URL Map możesz tworzyć uniwersalne adresy URL na różne platformy, aby uruchamiać Mapy Google i przeprowadzać w nich wyszukiwania, wyświetlać wskazówki dojazdu i nawigację oraz przeglądać widoki mapy i zdjęcia panoramiczne. Składnia adresu URL jest taka sama niezależnie od używanej platformy. Aby używać adresów URL Map, nie musisz mieć klucza interfejsu API Google.

Dostępne działania na mapie:

• Funkcja wyszukiwania uruchamia aplikację Mapy Google lub, jeśli nie jest ona zainstalowana, uruchamia przeglądarkę, w której wyświetla się pin z określonym miejscem. Może też przeprowadzić ogólne wyszukiwanie i uruchomić mapę, na której wyświetli wyniki.

• Funkcja Trasy uruchamia aplikację Mapy Google lub, jeśli nie jest ona zainstalowana, przeglądarkę, w której można wyświetlić trasę między punktami lub włączyć nawigację krok po kroku w Mapach Google na urządzeniach mobilnych.

• Funkcja panoramy Street View umożliwia wyświetlenie obrazów Street View jako interaktywnych panoram.

Więcej funkcji i przykładów znajdziesz w dokumentacji dla deweloperów dotyczącej adresów URL w mapach GMP.

W tym artykule omawiamy 2 kluczowe funkcje adresów URL Map:

• Wyświetlanie szczegółów miejsca w Mapach Google: w tej sekcji dowiesz się, jak tworzyć adresy URL, które wyświetlają szczegóły konkretnej lokalizacji w Mapach Google. Znajdziesz tam też szczegółowe informacje o tym, jak za pomocą identyfikatorów miejsc i zapytań dokładnych pracować z miejscami o nieunikalnych nazwach.

• Udostępnianie wskazówek dojazdu za pomocą adresów URL Map: w tej sekcji dowiesz się, jak tworzyć adresy URL, które zawierają wskazówki dojazdu między lokalizacjami, w tym wskazówki z wieloma punktami pośrednimi i szczegółową nawigacją.

Wyświetlanie szczegółów miejsca w Mapach Google

Funkcja wyszukiwania przyjmuje 2 parametry, aby umożliwić wyszukiwanie miejsc: query(wymagany) i query_place_id(opcjonalny).

Parametr query jest wymagany w przypadku wszystkich żądań wyszukiwania. Możesz podać nazwę miejsca, współrzędne długości i szerokości geograficzne rozdzielone przecinkami lub ogólne hasło wyszukiwania.

Struktura adresu URL wyszukiwarki:

https://www.google.com/maps/search/?api=1&parameters

Scenariusz 1. Wyświetlanie informacji o miejscu o wyjątkowej nazwie

https://www.google.com/maps/search/?api=1&query=Sydney%20Opera%20House

Teraz rozważ miejsce o niepowtarzalnej nazwie. Co się stanie, gdy wyszukujesz tylko za pomocą tej niewyróżniającej nazwy? Zobacz następny scenariusz.

Scenariusz 2. Wyszukiwanie miejsc o niejednoznacznej nazwie

https://www.google.com/maps/search/?api=1&query=7-Eleven

Ponieważ nazwa miejsca nie jest unikalna, ten adres URL otwiera listę pobliskich sklepów 7-Eleven w obszarze widoku. Użytkownicy mogą wybrać konkretny sklep, aby wyświetlić jego szczegóły.

Aby pominąć listę lokalizacji i przejść bezpośrednio do konkretnej strony z informacjami, możesz użyć dokładniejszej metody. Zobacz następny przykład.

Sytuacja 3. Wyświetlanie szczegółów miejsca o niejednoznacznej nazwie

W przypadku popularnych nazw miejsc proste wyszukiwanie nazwy często zwraca listę lokalizacji. Aby utworzyć link bezpośrednio do konkretnej strony z informacjami, możesz użyć jednej z tych metod:

Metoda 1. Użycie dokładnego zapytania z nazwą i adresem miejsca

https://www.google.com/maps/search/?api=1&query=7-Eleven%2C37%20Swanston%20St%2C%20Melbourne%20Australia

W tym adresie URL parametr query ma format nazwa miejsca, adres. Pomaga to zawęzić zakres wyszukiwania i utworzyć bezpośredni link do wybranej lokalizacji.

Metoda 2. Korzystanie z identyfikatora miejsca

Identyfikatory miejsc jednoznacznie identyfikują miejsce w bazie danych Miejsc Google i w Mapach Google.

https://www.google.com/maps/search/?api=1&query=7-Elevan&query_place_id=ChIJGcmcg7ZC1moRAOacd3HoEwM

W tym przypadku ChIJGcmcg7ZC1moRAOacd3HoEwM to unikalny identyfikator miejsca. Parametr query jest nadal wymagany, ale zostanie użyty tylko wtedy, gdy Mapy Google nie znajdą identyfikatora miejsca.

Scenariusz 4. Wyświetlanie szczegółów miejsca za pomocą współrzędnych geograficznych oraz identyfikatora miejsca

Użycie identyfikatora miejsca zapewnia, że Mapy Google będą wyświetlać szczegółowe informacje o miejscu.

https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE

Pobieranie identyfikatorów miejsc bezpłatnie

Aby automatycznie pobierać identyfikatory miejsc, możesz użyć funkcji Places API: wyszukiwanie tekstowe(tylko identyfikator). To bezpłatna metoda uzyskiwania identyfikatorów miejsc. Dowiedz się więcej o identyfikatorze miejsca i żądaniu Place API(nowy).

Zapytanie do interfejsu Places API dotyczące wyszukiwania tekstowego(tylko identyfikator):

curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: places.id'
'https://places.googleapis.com/v1/places:searchText'

Places API Text Search(ID Only) Response:

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

Identyfikatory miejsc mogą być też pobierane, gdy użytkownik kliknie lub dotknie punktu zainteresowania na mapach. Dowiedz się więcej o klikalnych ikonach punktów zainteresowania(JavaScript, Android, iOS).

Podsumowanie

Podanie dokładnych informacji o miejscu jest kluczowe dla zadowolenia klientów. Aby użytkownicy trafiali na właściwą stronę z informacjami o miejscu, twórz adresy URL wyszukiwania w jednym z tych zalecanych formatów:

• query=PLACE_NAME, ADDRESS
• query=PLACE_NAME&query_place_id=PLACE_ID

Jeśli chcesz wyświetlić szczegóły konkretnego miejsca, unikaj używania tylko współrzędnych geograficznych w parametrze query. Formaty takie jak query=latitude,longitude, query=PLACE_NAME,latitude,longitude lub query=ADDRESS,latitude,longitude nie zawsze prowadzą do odpowiedniej strony z informacjami o miejscu. Zamiast tego wyświetli szerokość i długość geograficzną lokalizacji.

Wyszukiwanie według kategorii za pomocą adresów URL Map

W wyszukiwaniu według kategorii podajesz ogólne hasło wyszukiwania, a Mapy Google próbują znaleźć informacje spełniające Twoje kryteria w określonej lokalizacji. Jeśli nie zostanie określona lokalizacja, Mapy Google spróbują znaleźć informacje o miejscach w pobliżu Twojej bieżącej lokalizacji.

Scenariusz 1. Wyszukiwanie miejsc w pobliżu

https://www.google.com/maps/search/?api=1&query=Cafe%20near%20Sydney%20Opera%20House%20that%20are%20open%20now

Udostępnianie wskazówek dojazdu za pomocą adresów URL Map

Funkcja Wskazówki dojazdu wyświetla na mapie ścieżkę między co najmniej 2 wskazanymi punktami, a także odległość i czas podróży. Zapewnia ona deweloperom większą kontrolę nad wyświetlanymi wskazówkami. Dokumentacja Mapy Google – adresy URL tras zawiera szczegółowe instrukcje tworzenia adresów URL niestandardowych tras.

Struktura adresu URL wskazówek:

https://www.google.com/maps/dir/?api=1&parameters

Scenariusz 1. Wyszukiwanie najlepszej trasy od bieżącej lokalizacji użytkownika do miejsca docelowego

https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving

Ten adres URL otwiera Mapy Google i wyświetla wskazówki dojazdu z obecnej lokalizacji użytkownika.

W tym URL brakuje parametru origin. Jeśli parametr origin zostanie pominięty, ścieżka zostanie domyślnie ustawiona na najbardziej odpowiednią lokalizację początkową, np. lokalizację urządzenia (jeśli jest dostępna). Jeśli nie ma żadnego, na mapie wyświetli się formularz, za pomocą którego użytkownik może podać miejsce wylotu. Wartością miejsca pochodzenia i miejsca docelowego może być nazwa miejsca, adres lub rozdzielane przecinkami współrzędne długości i szerokości geograficznej.

Parametr travelmode jest opcjonalny. Określa sposób podróży. Ten parametr może mieć następujące ustawienia:

• samochodem
• pieszo
• trasy rowerowe
• motocykl
• transport publiczny

Jeśli nie zostanie określony tryb podróży, Mapy Google wyświetlą co najmniej 1 najbardziej odpowiedni środek transportu dla wybranej trasy lub preferencji użytkownika.

Deweloperzy mogą też określać identyfikatory miejsc za pomocą parametru origin_place_id i destination_place_id. Użycie identyfikatora miejsca to najlepsza gwarancja, że link będzie prowadził do właściwego miejsca.

Pobieranie identyfikatorów miejsc bezpłatnie

Aby automatycznie pobierać identyfikatory miejsc, możesz użyć funkcji Places API: wyszukiwanie tekstowe(tylko identyfikator). To bezpłatna metoda uzyskiwania identyfikatorów miejsc. Dowiedz się więcej o identyfikatorze miejsca i żądaniu Place API(nowy).

Zapytanie do interfejsu Places API dotyczące wyszukiwania tekstowego(tylko identyfikator):

curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: places.id'
'https://places.googleapis.com/v1/places:searchText'

Places API Text Search(ID Only) Response:

{
  "places": [
    {
      "id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
    }
  ]
}

Identyfikatory miejsc mogą być też pobierane, gdy użytkownik kliknie lub dotknie punktu zainteresowania na mapach. Dowiedz się więcej o klikalnych ikonach punktów zainteresowania(JavaScript, Android, iOS).

Scenariusz 3. Dostarczanie szczegółowej nawigacji

https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving&dir_action=navigate

Ustawienie dir_action=navigate w adresie URL uruchamia Mapy Google w trybie nawigacji krok po kroku, jeśli aktualna lokalizacja użytkownika(lokalizacja urządzenia) jest dostępna i używana jako punkt początkowy (wyraźnie podany lub używany domyślnie, gdy parametr origin zostanie pominięty). W przeciwnym razie wyświetli się podgląd trasy.

Szczegółowa nawigacja jest uruchamiana, gdy ustawiono parametr dir_action=navigate, a także:

• miejsce nadania jest określone i znajduje się w pobliżu bieżącej lokalizacji użytkownika;
• pochodzenie jest pominięte, a dostępna jest bieżąca lokalizacja użytkownika;

Podgląd trasy jest uruchamiany, gdy:

• Ustawienie „dir_action=navigate” nie jest skonfigurowane
• parametr dir_action=navigate jest ustawiony, a pochodzenie jest określone i nie znajduje się w pobliżu bieżącej lokalizacji użytkownika;
• dir_action=navigate jest ustawiona, a początek jest pominięty, a obecna lokalizacja użytkownika jest niedostępna

Pamiętaj, że nawigacja nie jest dostępna w niektórych usługach Map Google, takich jak Mapy Google w internecie, ani między wszystkimi miejscami docelowymi. W takich przypadkach ten parametr zostanie zignorowany.

Podsumowanie

Poprawne tworzenie adresów URL Map Google pozwala użytkownikom szybko i skutecznie uzyskiwać potrzebne informacje.

• Zawsze określaj miejsce docelowe i w miarę możliwości używaj identyfikatora miejsca, aby zapewnić dokładność.

• Jeśli celem jest natychmiastowa nawigacja, dodaj parametr dir_action=navigate, aby wywołać nawigację krok po kroku. Nawigacja rozpocznie się od bieżącej lokalizacji użytkownika, jeśli lokalizacja urządzenia jest dostępna i używana jako punkt początkowy (wyraźnie ustawiony lub pominięty).

Wybór odpowiedniego podejścia do aplikacji

Masz 2 podstawowe opcje: możesz skorzystać z przedsformatowanych adresów URL udostępnionych przez interfejs Places API lub ręcznie utworzyć adresy URL Map w aplikacji. Każde podejście ma swoje zalety i wady.

Places API:

• Pola googleMapsUri i googleMapsLinks w odpowiedzi na żądanie Dane miejsca zawierają gotowe do użycia adresy URL. Pozwala to skrócić czas programowania i zminimalizować ryzyko wystąpienia błędów w formatowaniu adresów URL.

• Mniej kontroli nad konfiguracją wskazówek. Aplikacja googleMapsLinks udostępnia podstawowe wskazówki, ale nie obsługuje punktów pośrednich ani zaawansowanych ustawień. Ponadto bezpośrednie wywołanie nawigacji krok po kroku jest stosunkowo mniej intuicyjne.

Adresy URL Map:

• Zapewnia większą elastyczność i kontrolę. Deweloperzy mogą tworzyć adresy URL, aby wyświetlać szczegóły miejsc i konfigurować różne aspekty wskazówek dojazdu, w tym dodawać punkty pośrednie, określać tryby podróży i inicjować nawigację krok po kroku.

• Wymaga dogłębnej znajomości parametrów i struktury adresów URL. Ręczne tworzenie może zwiększać ryzyko wystąpienia błędów, jeśli nie jest wykonywane z należytą starannością.

Ulepszanie adresów URL Map za pomocą parametrów monitora UTM

Aby pomóc Google lepiej zrozumieć, jak deweloperzy integrują adresy URL Map, i zapewnić optymalną skuteczność, zachęcamy do uwzględniania parametrów śledzenia UTM w konstrukcji adresu URL. Dodając parametry utm_source i utm_campaign, udostępniasz cenne dane, które pozwalają nam analizować wzorce użytkowania i ulepszać usługę adresów URL w Mapach.

W przypadku parametru utm_source użyj nazwy swojej aplikacji. Parametr utm_campaign powinien odzwierciedlać zamierzone działanie użytkownika, np. „location_sharing”, „place_details_search” lub „directions_request”.

Adres URL z parametrami monitora UTM może wyglądać tak:

https://www.google.com/maps/search/?api=1&query=Sydney+Opera+House&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE&utm_source=YourAppName&utm_campaign=place_details_search

Konsekwentne stosowanie tych parametrów pomaga nam identyfikować obszary wymagające poprawy, skuteczniej rozwiązywać problemy i w efekcie zapewniać lepsze wrażenia wszystkim użytkownikom.

Następne kroki

Sugerowane dalsze materiały do czytania:

• URL Map
• Identyfikatory miejsc
• Places API – połączenie z Mapami Google
• Routes API

Współtwórcy

Główni autorzy:

Teresa Qin | Inżynier rozwiązań Google Maps Platform