W dzisiejszym świecie, w którym lokalizacja jest ważna, użytkownicy oczekują bezproblemowego 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 kontekstu lokalnego, platformy logistycznej i transportowej, narzędzia do planowania podróży czy platformy z ofertami nieruchomości, 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 znanego interfejsu Map Google zapewnia lepsze wrażenia.
Dobrze skonstruowany adres URL Map Google jest niezbędny do zapewnienia użytkownikom bezproblemowej obsługi. Nieprawidłowe adresy URL pogarszają wrażenia użytkowników, kierując ich do niewłaściwej lokalizacji, wyświetlając ogólny widok mapy zamiast szczegółowych informacji, a nawet powodując uszkodzenie linku. Frustruje to użytkowników i uniemożliwia im osiągnięcie celu. Na przykład nawet w przypadku prawidłowego adresu URL Map Google użytkownik oczekujący szczegółowych informacji o konkretnej firmie może zamiast tego trafić na ogólny widok mapy bez odpowiednich informacji. Zobacz przykład poniżej:
https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152
Ten adres URL Map Google jest prawidłowy i umożliwia otwarcie Map Google oraz wyświetlenie lokalizacji na podstawie szerokości i długości geograficznej. Nie zawiera jednak szczegółowych informacji o konkretnym miejscu.
Bezproblemowe łączenie aplikacji z Mapami Google za pomocą prawidłowych adresów URL
Google Maps Platform (GMP) oferuje 2 główne metody tworzenia prawidłowych adresów URL: Places API(nowość), które 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:
Używanie pola googleMapsUri lub googleMapsLinks w Places API(nowość) GMP
Interfejs API Miejsc GMP(nowość) zwraca pełny zestaw informacji o konkretnym miejscu. Gdy poprosisz o pole 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 otwarcia
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 powyższym przykładzie to identyfikator miejsca Sydney
Opera House w powyższym przykładzie. Identyfikator miejsca to tekstowy identyfikator, który
jednoznacznie identyfikuje miejsce w bazie danych Miejsc Google i na Mapach Google.
Pobieranie identyfikatorów miejsc bez opłat
Aby programowo pobierać identyfikatory miejsc, możesz użyć funkcji Places API: Wyszukaj tekst(tylko identyfikator). Jest to bezpłatna metoda uzyskiwania identyfikatorów miejsc. Więcej informacji o identyfikatorze miejsca i żądaniu Places API(nowość)
Places API – Wyszukaj tekst(tylko identyfikator) – żądanie:
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 – Wyszukaj tekst(tylko identyfikator) – odpowiedź:
{
"places": [
{
"id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
}
]
}Identyfikatory miejsc można też pobierać, gdy użytkownik kliknie lub dotknie punktu POI na mapie. Więcej informacji o ikonach POI, które można kliknąć(JavaScript, Android, iOS)
Implementacja
Gdy deweloperzy korzystają z Places API, 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 zdjęć tego miejsca |
Zapoznaj się z przewodnikiem dla deweloperów i wypróbuj tę funkcję już dziś.
Korzystanie z adresów URL Map Google
Za pomocą adresów URL Map Google możesz tworzyć uniwersalne adresy URL działające na różnych platformach, które umożliwiają uruchamianie Map Google oraz wyszukiwanie, uzyskiwanie wskazówek dojazdu i nawigacji oraz wyświetlanie widoków map i zdjęć panoramicznych. Składnia adresu URL jest taka sama niezależnie od używanej platformy w użyciu. 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, i wyświetla pinezkę w konkretnym miejscu albo przeprowadza ogólne wyszukiwanie i uruchamia mapę, aby wyświetlić wyniki.
Funkcja wskazówek dojazdu uruchamia aplikację Mapy Google lub przeglądarkę, jeśli aplikacja nie jest zainstalowana, i wyświetla wskazówki dojazdu między punktami lub włącza nawigację zakręt po zakręcie 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 najważniejsze funkcje adresów URL Map Google:
Wyświetlanie szczegółów miejsca w Mapach Google: w tej sekcji wyjaśniamy, jak tworzyć adresy URL, które będą wyświetlać szczegóły konkretnej lokalizacji w Mapach Google. Opisujemy też, jak pracować z miejscami o nieunikalnych nazwach za pomocą identyfikatorów miejsc i precyzyjnych zapytań.
Wskazówki dojazdu za pomocą adresów URL Map Google: w tej sekcji wyjaśniamy, jak tworzyć adresy URL, które zawierają wskazówki dojazdu między lokalizacjami, w tym wskazówki dojazdu z wieloma punktami pośrednimi i nawigacją zakręt po zakręcie.
Wyświetlanie szczegółów miejsca w Mapach Google
Funkcja wyszukiwania przyjmuje 2 parametry, które umożliwiają wyszukiwanie miejsc:
są query(wymagany) i query_place_id(opcjonalny).
Parametr query jest wymagany w przypadku wszystkich żądań wyszukiwania. Może to być nazwa miejsca
, współrzędne geograficzne rozdzielone przecinkami lub ogólne wyszukiwane hasło.
Struktura adresu URL wyszukiwania:
https://www.google.com/maps/search/?api=1¶meters
Scenariusz 1. Wyświetlanie szczegółów miejsca o unikalnej nazwie
https://www.google.com/maps/search/?api=1&query=Sydney%20Opera%20House
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 nieunikalnej 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 widocznym obszarze. Użytkownicy mogą następnie wybrać konkretny sklep, aby wyświetlić jego szczegóły.
Aby uniknąć wyświetlania listy lokalizacji i bezpośrednio przejść do konkretnej strony z informacjami, możesz użyć bardziej precyzyjnej metody. Zobacz następny przykład.
Scenariusz 3. Wyświetlanie szczegółów miejsca o nieunikalnej nazwie
W przypadku popularnych nazw miejsc proste wyszukiwanie według nazwy często zwraca listę lokalizacji. Aby bezpośrednio połączyć się z konkretną stroną z informacjami, możesz użyć jednej z tych metod:
Metoda 1. Używanie precyzyjnego zapytania z nazwą miejsca i adresem
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. Pomaga to
zawęzić wyszukiwanie i bezpośrednio połączyć się z odpowiednią lokalizacją.
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 Google
Maps 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 wyświetlą 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 bez opłat
Aby programowo pobierać identyfikatory miejsc, możesz użyć funkcji Places API: Wyszukaj tekst(tylko identyfikator). Jest to bezpłatna metoda uzyskiwania identyfikatorów miejsc. Więcej informacji o identyfikatorze miejsca i żądaniu Places API(nowość)
Places API – Wyszukaj tekst(tylko identyfikator) – żądanie:
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 – Wyszukaj tekst(tylko identyfikator) – odpowiedź:
{
"places": [
{
"id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
}
]
}Identyfikatory miejsc można też pobierać, gdy użytkownik kliknie lub dotknie punktu POI na mapie. Więcej informacji o ikonach POI, które można kliknąć(JavaScript, Android, iOS)
Podsumowanie
Podawanie dokładnych informacji o miejscu ma kluczowe znaczenie dla zapewnienia użytkownikom pozytywnych wrażeń. Aby mieć pewność, że użytkownicy trafią na właściwą stronę z informacjami o miejscu, twórz adresy URL wyszukiwania w jednym z tych zalecanych formatów:
query=PLACE_NAME, ADDRESSquery=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, gdy
Twoim celem jest wyświetlenie szczegółów konkretnego miejsca. Formaty takie jak
query=latitude,longitude, query=PLACE_NAME,latitude,longitude,
lub query=ADDRESS,latitude,longitude nie zawsze prowadzą do
żądanej strony z informacjami o miejscu. Zamiast tego wyświetlą szerokość i długość geograficzną
lokalizacji.
Wyszukiwanie według kategorii za pomocą adresów URL Map Google
W przypadku wyszukiwania według kategorii przekazujesz ogólne wyszukiwane hasło, a Mapy Google próbują znaleźć informacje pasujące do Twoich kryteriów w pobliżu określonej lokalizacji. Jeśli nie podasz lokalizacji, Mapy Google spróbują znaleźć informacje 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
Wskazówki dojazdu za pomocą adresów URL Map Google
Funkcja wskazówek dojazdu wyświetla trasę między co najmniej 2 określonymi punktami na mapie, a także odległość i czas podróży. Daje deweloperom większą kontrolę nad podanymi wskazówkami dojazdu. Szczegółowe instrukcje tworzenia adresów URL do niestandardowych wskazówek dojazdu znajdziesz w dokumentacji GMP's Maps URLs Directions dotyczącej adresów URL Map Google.
Struktura adresu URL wskazówek dojazdu:
https://www.google.com/maps/dir/?api=1¶meters
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 parametr origin. Gdy parametr origin jest pominięty, trasa domyślnie prowadzi
z najbardziej odpowiedniej lokalizacji początkowej, np. lokalizacji urządzenia, jeśli jest dostępna.
Jeśli nie jest dostępna, na wyświetlonej mapie pojawi się formularz, w którym użytkownik może wpisać lokalizację początkową.
Wartość lokalizacji początkowej i docelowej może być nazwą miejsca, adresem lub
współrzędnymi geograficznymi rozdzielonymi przecinkami.
travelmode to parametr opcjonalny. Określa on sposób podróżowania.
Ten parametr można ustawić jako:
- samochodem
- pieszo
- trasy rowerowe
- motocykl
- transport publiczny
Jeśli nie podasz parametru travelmode, Mapy Google wyświetlą co najmniej 1 najbardziej odpowiedni sposób podróżowania dla określonej 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 połączysz się z właściwym miejscem.
Pobieranie identyfikatorów miejsc bez opłat
Aby programowo pobierać identyfikatory miejsc, możesz użyć funkcji Places API: Wyszukaj tekst(tylko identyfikator). Jest to bezpłatna metoda uzyskiwania identyfikatorów miejsc. Więcej informacji o identyfikatorze miejsca i żądaniu Places API(nowość)
Places API – Wyszukaj tekst(tylko identyfikator) – żądanie:
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 – Wyszukaj tekst(tylko identyfikator) – odpowiedź:
{
"places": [
{
"id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
}
]
}Identyfikatory miejsc można też pobierać, gdy użytkownik kliknie lub dotknie punktu POI na mapie. Więcej informacji o ikonach POI, które można kliknąć(JavaScript, Android, iOS)
Scenariusz 3. Nawigacja zakręt po zakręcie
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 zakręt po zakręcie, jeśli bieżąca lokalizacja użytkownika(lokalizacja urządzenia) jest dostępna i
używana jako lokalizacja początkowa (podana bezpośrednio lub używana pośrednio, gdy parametr origin
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:
- określona jest lokalizacja początkowa, która znajduje się blisko bieżącej lokalizacji użytkownika;
- lokalizacja początkowa jest pominięta, a bieżąca lokalizacja użytkownika jest dostępna.
Podgląd trasy jest uruchamiany, gdy:
- parametr
dir_action=navigatenie jest ustawiony; dir_action=navigatejest ustawiony, a lokalizacja początkowa jest określona i nie znajduje się blisko bieżącej lokalizacji użytkownika;dir_action=navigatejest ustawiony, a lokalizacja początkowa jest pominięta, 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 internecie, ani między wszystkimi miejscami docelowymi. W takich przypadkach ten parametr zostanie zignorowany.
 |
 |
Podsumowanie
Prawidłowe tworzenie adresów URL Map Google pozwala zapewnić użytkownikom szybki i skuteczny dostęp do potrzebnych informacji.
Zawsze określaj miejsce docelowe i, jeśli to możliwe, używaj identyfikatora miejsca, aby zagwarantować dokładność.
Jeśli chcesz zapewnić natychmiastową nawigację, dodaj parametr dir_action=navigate aby uruchomić nawigację zakręt po zakręcie. Nawigacja rozpocznie się od bieżącej lokalizacji użytkownika, jeśli lokalizacja urządzenia jest dostępna i używana jako lokalizacja początkowa (ustawiona bezpośrednio lub pominięta).
Wybieranie odpowiedniego podejścia do aplikacji
Masz 2 główne opcje: korzystanie z wstępnie sformatowanych adresów URL udostępnianych przez Places API lub ręczne tworzenie adresów URL Map Google w aplikacji. Każde podejście ma swoje zalety i wady.
Places API:
Pola
googleMapsUriigoogleMapsLinksw odpowiedzi z informacjami o miejscu 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. Pole
googleMapsLinksoferuje podstawowe wskazówki dojazdu, ale nie obsługuje punktów pośrednich ani zaawansowanego dostosowywania. Ponadto stosunkowo trudniej jest bezpośrednio uruchomić nawigację zakręt po zakręcie.
Adresy URL Map Google:
Zapewniają większą elastyczność i kontrolę. Deweloperzy mogą tworzyć adresy URL, które wyświetlają szczegóły miejsca i konfigurują różne aspekty wskazówek dojazdu, w tym dodawanie punktów pośrednich, określanie sposobów podróżowania i uruchamianie nawigacji zakręt po zakręcie.
Wymagają lepszego zrozumienia parametrów i struktury adresów URL. Ręczne tworzenie zwiększa ryzyko błędów, jeśli nie zostanie wykonane starannie.
Ulepszanie adresów URL Map Google za pomocą parametrów monitora UTM
Aby pomóc Google lepiej zrozumieć, jak deweloperzy integrują adresy URL Map Google, i
zapewnić optymalną wydajność, zachęcamy do dodawania parametrów monitora UTM
do tworzonych adresów URL. Dodając parametry utm_source i utm_campaign,
udostępniasz cenne dane, które pozwalają nam analizować wzorce użytkowania i ulepszać
adresy 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”.
Na przykład 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 używanie tych parametrów pomaga nam identyfikować obszary wymagające ulepszeń, skuteczniej rozwiązywać problemy i ostatecznie zapewniać lepsze wrażenia wszystkim użytkownikom.
Następne kroki
Sugerowane dalsze lektury:
Współtwórcy
Główni autorzy:
Teresa Qin | Inżynier ds. rozwiązań Google Maps Platform