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, w którym lokalizacja jest ważna, 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 lokalnych kontekstów, platformy logistycznej i transportowej, planera podróży czy platformy z ofertami nieruchomości, użytkownicy często muszą szybko wyświetlić szczegóły lokalizacji lub znaleźć najlepszą trasę z punktu A do punktu B. Deweloperzy mogą tworzyć własne funkcje w aplikacji, ale korzystanie z kompleksowego i znajomego interfejsu Map Google zapewnia lepsze wrażenia.

Dobrze skonstruowany adres URL Map Google jest niezbędny, aby zapewnić użytkownikom wygodę. Nieprawidłowe adresy URL pogarszają komfort użytkowników, ponieważ kierują ich do niewłaściwej lokalizacji, wyświetlają ogólny widok mapy zamiast szczegółowych informacji, a nawet powodują, że link jest nieaktywny. Frustruje to użytkowników i uniemożliwia im osiągnięcie celu. Na przykład nawet w przypadku prawidłowego adresu URL Map użytkownik, który oczekuje szczegółowych informacji o konkretnej firmie, może zamiast tego trafić na ogólny widok mapy bez istotnych informacji. Zobacz przykład poniżej: 

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

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

Wyszukiwanie tylko za pomocą szerokości i długości geograficznej
Wyszukiwanie tylko za pomocą szerokości i długości geograficznej

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

Otwieranie strony Szczegóły miejsca w Mapach Google
Adres URL Map z unikalną nazwą miejsca kieruje użytkowników na stronę z informacjami o tym miejscu w Mapach Google

Platforma Google Maps (GMP) oferuje dwie podstawowe metody konstruowania dokładnych adresów URL: Places API(nowość), która wymaga klucza API, oraz adresy URL Map, które są bezpłatne i nie wymagają klucza. Poniższe rozwiązania odnoszą się do różnych scenariuszy i przypadków użycia:

GMP Places API(nowe) zwraca kompleksowy zestaw informacji o określonym miejscu. Podczas żądania pola googleMapsUri lub googleMapsLinks (poprzez określenie go w masce pola) odpowiedź API obejmuje obiekt miejsca. Ten obiekt zawiera wstępnie sformatowane adresy URL, których można użyć do bezpośredniego otwierania w Mapach Google odpowiedniego widoku, np. widoku szczegółów miejsca.

Przykład:

Prośba o szczegóły miejsca

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ź z informacjami o miejscu:

{
    "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 powyższym przykładzie to identyfikator miejsca, w którym znajduje się Opera w Sydney. Identyfikator miejsca to identyfikator tekstowy, który jednoznacznie identyfikuje miejsce w bazie danych Google Places i na Mapach Google.

Pobieranie identyfikatorów miejsc bez opłat

Aby programowo pobrać identyfikatory miejsc, możesz skorzystać z funkcji Places API: wyszukiwanie tekstowe(tylko identyfikator). Jest to bezpłatna metoda uzyskiwania identyfikatorów miejsc. Dowiedz się więcej o Identyfikatorze miejsca i żądaniu API miejsca(nowość).

Żądanie Places API – Wyszukaj tekst(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'

Odpowiedź interfejsu Places API – Wyszukaj tekst(tylko identyfikator):

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

Identyfikatory miejsc można też pobierać, gdy użytkownik kliknie lub dotknie punktu POI na mapach. Więcej informacji o ikonach klikalnych punktów POI znajdziesz w dokumentacji(JavaScript, Android, iOS).

Implementacja

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

Funkcja Opis
directionsUri Link do otwierania Map Google w celu wyświetlania wskazówek dojazdu z bieżącej lokalizacji użytkownika do tego miejsca
placeUri Link do otwierania Map Google na stronie z informacjami o tym miejscu
writeAReviewUri Link do otwierania Map Google na stronie pisania opinii o tym miejscu
reviewsUri Link do otwierania Map Google na stronie opinii o tym miejscu
photosUri Link do otwierania Map Google na stronie ze zdjęciami tego miejsca

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 działające na różnych platformach, które umożliwiają uruchamianie Map Google, wyszukiwanie, wyznaczanie tras i nawigację oraz wyświetlanie widoków mapy i zdjęć panoramicznych. Składnia adresu URL jest taka sama niezależnie od używanej platformy. Aby korzystać z adresów URL Map Google, nie potrzebujesz klucza interfejsu API Google.

Dostępne działania na mapie:

  • Funkcja wyszukiwania uruchamia aplikację Mapy Google lub przeglądarkę, jeśli aplikacja nie jest zainstalowana. Wyświetla ona pinezkę w określonym miejscu lub przeprowadza ogólne wyszukiwanie i uruchamia mapę, aby wyświetlić wyniki.

  • Funkcja Trasa uruchamia aplikację Mapy Google lub przeglądarkę, jeśli aplikacja nie jest zainstalowana. Wyświetla ona trasę między punktami lub umożliwia nawigację krok po kroku w Mapach Google na urządzeniach mobilnych.

  • Funkcja panoramy Street View umożliwia uruchomienie przeglądarki, która wyświetla zdjęcia Street View jako interaktywne panoramy.

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

Poniżej omawiamy 2 kluczowe funkcje adresów URL Map:

  • Wyświetlanie szczegółów miejsca w Mapach Google: w tej sekcji znajdziesz informacje o tym, jak tworzyć adresy URL, które będą wyświetlać szczegóły konkretnej lokalizacji w Mapach Google. Wyjaśniono w nim też, jak pracować z miejscami o nieunikalnych nazwach, używając identyfikatorów miejsc i precyzyjnych zapytań.

  • Wyznaczanie trasy za pomocą adresów URL Map: w tej sekcji dowiesz się, jak tworzyć adresy URL, które wyznaczają trasę między lokalizacjami, w tym trasę z wieloma punktami pośrednimi i szczegółową nawigacją.

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

Funkcja wyszukiwania przyjmuje 2 parametry, które są potrzebne do wyszukania miejsc: query(wymagany) i query_place_id(opcjonalny).

Parametr query jest wymagany w przypadku wszystkich żądań wyszukiwania. Akceptuje nazwę miejsca, rozdzielone przecinkami współrzędne geograficzne lub ogólne wyszukiwane hasło.

Struktura adresu URL wyszukiwania: 

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

Scenariusz 1. Wyświetlanie szczegółowych informacji o miejscu o unikalnej nazwie 

https://www.google.com/maps/search/?api=1&query=Sydney%20Opera%20House
 W tym przykładzie podana jest tylko nazwa miejsca. Ten adres URL otwiera stronę ze szczegółowymi informacjami o operze w Sydney.

Otwieranie strony Szczegóły miejsca w Mapach Google
Wyszukiwanie nazwy miejsca i wyświetlanie szczegółowych informacji o nim

Teraz rozważmy miejsce o nieunikalnej nazwie. Co się stanie, gdy wyszukasz tylko tę niepowtarzalną nazwę? Zobacz następny scenariusz.

Scenariusz 2. Wyszukiwanie miejsc o niepowtarzalnej nazwie 

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

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

Otwieranie strony listy miejsc w Mapach Google
Strona listy miejsc do wyszukiwania nieunikalnej nazwy

Aby uniknąć wyświetlania listy lokalizacji i bezpośrednio przejść do strony z informacjami, możesz użyć bardziej precyzyjnej metody. Zobacz następny przykład.

Sytuacja 3. Wyświetlanie szczegółowych informacji o miejscu o nieunikalnej nazwie

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

Metoda 1. Używanie precyzyjnego 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 jest sformatowany jako nazwa miejsca, adres. Ułatwia to zawężenie wyszukiwania i bezpośrednie przejście do wybranej lokalizacji.

Metoda 2. Używanie 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 będzie używany tylko wtedy, gdy Mapy Google nie będą mogły znaleźć identyfikatora miejsca.

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

Użycie identyfikatora miejsca gwarantuje, ż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
Strona szczegółów miejsca z użyciem współrzędnych geograficznych oraz identyfikatora miejsca
Strona szczegółów miejsca z użyciem szerokości i długości geograficznej oraz identyfikatora miejsca

Pobieranie identyfikatorów miejsc bez opłat

Aby programowo pobierać identyfikatory miejsc, możesz użyć funkcji Places API: Wyszukaj tekst(tylko identyfikatory). Jest to bezpłatna metoda uzyskiwania identyfikatorów miejsc. Dowiedz się więcej o identyfikatorze miejsca i żądaniu interfejsu Places API(nowego).

Żądanie Places API – Wyszukaj tekst(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'

Odpowiedź interfejsu Places API – Wyszukaj tekst(tylko identyfikator): 

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

Identyfikatory miejsc można też pobierać, gdy użytkownik kliknie lub dotknie punktu POI na mapach. Więcej informacji o ikonach klikalnych punktów POI znajdziesz w dokumentacji(JavaScript, Android, iOS).

Podsumowanie

Podawanie dokładnych informacji o miejscu jest kluczowe dla zapewnienia pozytywnych wrażeń. Aby użytkownicy trafiali na właściwą stronę szczegółów miejsca, utwó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 w parametrze query tylko współrzędnych geograficznych. Formaty takie jak query=latitude,longitude, query=PLACE_NAME,latitude,longitude czy query=ADDRESS,latitude,longitude nie zawsze prowadzą do strony z informacjami o miejscu. Zamiast tego wyświetli szerokość i długość geograficzną lokalizacji.

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

W wyszukiwaniu według kategorii przekazujesz ogólne hasło, a Mapy Google próbują znaleźć wizytówki, które pasują do Twoich kryteriów w pobliżu określonej lokalizacji. Jeśli nie podasz lokalizacji, Mapy Google spróbują znaleźć informacje o firmach 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
Wyszukiwanie kategorii – miejsca w pobliżu
Wyszukiwanie według kategorii – pobliskie miejsca

Wyświetlanie wskazówek dojazdu za pomocą adresów URL Map

Funkcja Wskazówki dojazdu wyświetla ścieżkę między co najmniej 2 określonymi punktami na mapie, a także odległość i czas podróży. Zapewnia deweloperom większą kontrolę nad podawanymi wskazówkami. Dokumentacja Adresy URL Map Google w GMP zawiera szczegółowe instrukcje tworzenia adresów URL z dostosowanymi wskazówkami dojazdu.

Struktura adresu URL z wskazówkami dojazdu: 

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

Scenariusz 1. Znajdowanie najlepszej trasy z 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 bieżącej lokalizacji użytkownika.

W tym adresie URL pominięto znak origin. Jeśli parametr origin zostanie pominięty, ścieżka domyślnie będzie prowadzić do najbardziej odpowiedniej lokalizacji początkowej, np. lokalizacji urządzenia, jeśli jest dostępna. Jeśli nie, mapa zawiera formularz, w którym użytkownik może wpisać miejsce pochodzenia. Wartość pochodzenia i miejsca docelowego może być nazwą miejsca, adresem lub współrzędnymi szerokości i długości geograficznej rozdzielonymi przecinkami.

travelmode to parametr opcjonalny. Określa on środek transportu. Ten parametr może mieć wartość:

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

Jeśli nie określono środka transportu, w Mapach Google wyświetli się co najmniej 1 najbardziej odpowiedni środek transportu dla określonej trasy lub preferencji użytkownika.

Deweloperzy mogą też określać identyfikatory miejsc za pomocą parametrów 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 bez opłat

Aby programowo pobierać identyfikatory miejsc, możesz użyć funkcji Places API: Wyszukaj tekst(tylko identyfikatory). Jest to bezpłatna metoda uzyskiwania identyfikatorów miejsc. Dowiedz się więcej o identyfikatorze miejsca i żądaniu interfejsu Places API(nowego).

Żądanie Places API – Wyszukaj tekst(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'

Odpowiedź interfejsu Places API – Wyszukaj tekst(tylko identyfikator): 

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

Identyfikatory miejsc można też pobierać, gdy użytkownik kliknie lub dotknie punktu POI na mapach. Więcej informacji o ikonach klikalnych punktów POI znajdziesz w dokumentacji(JavaScript, Android, iOS).

Wskazówki dojazdu z obecnej lokalizacji użytkownika
Trasa z bieżącej lokalizacji użytkownika

Scenariusz 3. Zapewnianie 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 spowoduje uruchomienie Map Google w trybie nawigacji krok po kroku, jeśli bieżąca lokalizacja użytkownika(lokalizacja urządzenia) jest dostępna i używana jako punkt początkowy (podany bezpośrednio lub używany pośrednio, gdy parametr punktu początkowego jest pominięty). W przeciwnym razie wyświetli się podgląd trasy.

Nawigacja zakręt po zakręcie jest uruchamiana, gdy ustawiony jest parametr dir_action=navigate i:

  • miejsce docelowe jest określone i znajduje się w pobliżu bieżącej lokalizacji użytkownika;
  • Początek jest pomijany, a bieżąca lokalizacja użytkownika jest dostępna.

Podgląd trasy uruchamia się, gdy:

  • dir_action=navigate nie jest ustawiona
  • dir_action=navigate jest ustawiona i określono miejsce pochodzenia, a miejsce pochodzenia nie jest blisko bieżącej lokalizacji użytkownika.
  • dir_action=navigate jest ustawiona, a pochodzenie jest pominięte, a bieżąca lokalizacja użytkownika jest niedostępna.

Pamiętaj, że nawigacja nie jest dostępna we wszystkich usługach Map Google, np. w Mapach Google w przeglądarce, ani nie działa w przypadku wszystkich miejsc docelowych. W takich przypadkach ten parametr będzie ignorowany.

Nawigacja zakręt po zakręcie Podgląd trasy
Nawigacja krok po kroku
Podgląd trasy

Podsumowanie

Prawidłowo konstruując adresy URL Map Google, możesz mieć pewność, że użytkownicy szybko i skutecznie uzyskają potrzebne informacje.

  • Zawsze określaj miejsce docelowe i zawsze używaj identyfikatora miejsca, gdy jest to możliwe, aby zagwarantować dokładność

  • Jeśli chcesz zapewnić natychmiastową nawigację, dodaj parametr dir_action=navigate, aby włączyć szczegółowe wskazówki. Nawigacja rozpocznie się od bieżącej lokalizacji użytkownika, jeśli lokalizacja urządzenia jest dostępna i używana jako punkt początkowy (ustawiony jawnie lub pominięty).

Wybór odpowiedniego podejścia do aplikacji

Masz 2 główne opcje: korzystanie z wstępnie sformatowanych adresów URL udostępnianych przez interfejs Places API lub ręczne tworzenie adresów URL Map w aplikacji. Każde podejście ma swoje zalety i wady.

Places API:

  • Pola googleMapsUri i googleMapsLinks w odpowiedzi Place Details zawierają gotowe do użycia adresy URL. Skraca to czas programowania i minimalizuje ryzyko błędów w formatowaniu adresów URL.

  • Zapewnia mniejszą kontrolę nad konfiguracją wskazówek dojazdu. googleMapsLinks oferuje podstawowe wskazówki, ale nie obsługuje punktów pośrednich ani zaawansowanego dostosowywania. Poza tym bezpośrednie włączenie nawigacji krok po kroku jest stosunkowo mniej proste.

Adresy URL Map Google:

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

  • Wymaga to lepszego zrozumienia parametrów i struktury adresu URL. Ręczne tworzenie zwiększa ryzyko błędów, jeśli nie jest wykonywane z należytą starannością.

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

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

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

Przykładowy 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 zapewniać wszystkim użytkownikom lepsze wrażenia.

Następne kroki

Sugerowane dalsze lektury:

Współtwórcy

Główni autorzy:

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