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 miejsc, 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 zawiera jednak 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

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

Interfejs GMP Places API(nowy) zwraca obszerny zestaw informacji o konkretnym miejscu. Gdy zażądasz pola googleMapsUri lub googleMapsLinks (określając je w masce pola), odpowiedź interfejsu API będzie zawierać obiekt miejsca. Ten obiekt zawiera wstępnie sformatowane adresy URL, których można użyć do bezpośredniego otwierania odpowiedniego widoku, np. widoku szczegółów miejsca, w Mapach Google.

Przykład:

Żądanie informacji 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ź 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 przykładzie powyżej to identyfikator miejsca 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 bez opłat

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

Żądanie wyszukiwania tekstowego w Places API(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 Text Search(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 tych artykułach: JavaScript, Android, iOS.

Implementacja

Podczas korzystania z interfejsu Places API deweloperzy mogą po prostu wyodrębnić z odpowiedzi pole googleMapsUri lub googleMapsLinks 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 strony z informacjami o tym miejscu w Mapach Google
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, wieloplatformowe adresy URL, które umożliwiają uruchamianie Map Google i przeprowadzanie wyszukiwań, wyznaczanie tras i korzystanie z nawigacji oraz wyświetlanie widoków map 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), w której wyświetlany jest pinezka w określonym miejscu lub przeprowadzane jest ogólne wyszukiwanie, a następnie uruchamiana jest mapa z wynikami.

  • Funkcja Trasa uruchamia aplikację Mapy Google lub przeglądarkę (jeśli aplikacja nie jest zainstalowana), w której wyświetlane są wskazówki dojazdu między punktami lub włączana jest nawigacja 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śnia 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ą wymagane do przeprowadzenia wyszukiwania 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ę nieunikalną nazwę? Zobacz następny scenariusz.

Scenariusz 2. Wyszukiwanie miejsc o niepowtarzalnej nazwie 

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

Nazwa miejsca nie jest unikalna, więc 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: Text Search(ID Only). Jest to bezpłatna metoda uzyskiwania identyfikatorów miejsc. Dowiedz się więcej o identyfikatorze miejsca i żądaniu interfejsu Places API(nowego).

Żądanie wyszukiwania tekstowego w Places API(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 Text Search(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 tych artykułach: JavaScript, Android, iOS.

Podsumowanie

Podanie dokładnych informacji o miejscu jest kluczowe dla zapewnienia pozytywnych wrażeń. Aby użytkownicy trafiali na odpowiednią 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 kategorii – miejsca w pobliżu

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 GMP's Maps URLs Directions 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 docelowe. Wartość pochodzenia i miejsca docelowego może być nazwą miejsca, adresem lub współrzędnymi szerokości i długości geograficznej rozdzielonymi przecinkami.

Parametr travelmode jest opcjonalny. Określa on sposób podróżowania. Ten parametr może mieć wartość:

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

Jeśli nie określono trybu podróży, w Mapach Google wyświetlany jest co najmniej 1 najbardziej odpowiedni tryb dla danej 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 bez opłat

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

Żądanie wyszukiwania tekstowego w Places API(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 Text Search(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 tych artykułach: 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 dostępna jest bieżąca lokalizacja użytkownika(lokalizacja urządzenia) i jest ona 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 parametr dir_action=navigate jest ustawiony 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 jest uruchamiany, gdy:

  • dir_action=navigate nie jest ustawiona
  • dir_action=navigate jest ustawiona i określono miejsce pochodzenia, a miejsce pochodzenia nie znajduje się w pobliżu 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 podawaj miejsce docelowe i w miarę możliwości używaj identyfikatora miejsca, aby mieć pewność, że dane są dokładne.

  • 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 stosunkowo trudniej jest bezpośrednio włączyć nawigację krok po kroku.

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