Krótkie omówienie adresów URL Map Google

Adresy URL Map umożliwiają tworzenie uniwersalnych, na wielu platformach adresów URL, które uruchamiają Mapy Google w celu wyszukiwania, uzyskiwania wskazówek dojazdu i nawigacji, wyświetlania widoków mapy, tworzenia podręcznej listy miejsc lub wyświetlania panoram Street View. Składnia adresu URL jest taka sama na każdej platformie i nie jest wymagany klucz interfejsu API.

URL-e Map Google: najważniejsze informacje

  • Usługa: URL-e Map Google
  • Inna nazwa: adresy URL Map Google
  • Kategoria: Mapy
  • Platforma: schemat URI adresu URL
  • Etap uruchomienia: GA
  • Cykl życia: aktywny
  • Omówienie: omówienie adresów URL Map

Adresy URL Map: kiedy ich używać

Adresów URL Map Google używaj, gdy:

  • Aby wyszukać miejsce lub wyświetlić wyniki wyszukiwania, potrzebujesz linku z aplikacji na Androida, aplikacji na iOS lub witryny, który otwiera Mapy Google.
  • Musisz otworzyć Mapy Google ze wskazówkami dojazdu między punktami, opcjonalnie z punktami pośrednimi, środkiem transportu lub szczegółową nawigacją.
  • Musisz otworzyć Mapy Google w widoku mapy, krótkiej listy miejsc lub panoramy Street View bez użycia klucza interfejsu API.
  • Potrzebujesz jednej składni adresu URL, która działa tak samo na Androidzie, iOS i w przeglądarkach na komputerach.

Nie używaj adresów URL Map, gdy:

  • Masz już dostęp do informacji o miejscu i chcesz uzyskać wstępnie sformatowane linki do Map Google dotyczące danego miejsca (pola googleMapsUri lub googleMapsLinks). Zamiast tego użyj Places API (nowość).
  • Podczas uruchamiania aplikacji Mapy Google potrzebujesz funkcji dostępnych tylko na urządzeniach mobilnych. Użyj intencji Map Google na Androida lub schematu URI adresu URL Map Google na iOS.

URL-e Map Google: konfiguracja

  • Atrybucja wykorzystania: dodaj do adresów URL Map opcjonalne parametry zapytania utm_source (nazwa aplikacji) i utm_campaign (zamierzone działanie użytkownika, np. place_details_search).
  • Pierwsze kroki: skonfiguruj adresy URL Map

URL-e Map Google: typowe błędy

  • Problem: adres URL wyszukiwania zawierający tylko szerokość i długość geograficzną w parametrze query wyświetla pinezkę, ale nie pokazuje informacji o miejscu na mapie ani w panelu bocznym. Rozwiązanie: użyj query=PLACE_NAME,ADDRESS lub dodaj query_place_id obok query, aby wyświetlić szczegóły konkretnego miejsca. Zobacz /maps/documentation/urls/get-started.
  • Problem: parametry identyfikatora miejsca (query_place_id, origin_place_id, destination_place_id, waypoint_place_ids) nie działają same. Rozwiązanie: gdy przekazujesz parametr identyfikatora miejsca, zawsze dołączaj pasujący parametr podstawowy (query, origin, destination lub waypoints). Zobacz /maps/documentation/urls/get-started.
  • Problem: parametr waypoints jest ignorowany w usługach Map Google, które nie obsługują punktów pośrednich i mają limity liczby zależne od platformy, a parametr dir_action=navigate jest ignorowany, gdy nawigacja jest niedostępna. Rozwiązanie: używaj maksymalnie 3 punktów pośrednich w przypadku linków, które otwierają się w przeglądarkach mobilnych (w przeciwnym razie 9), i nie polegaj na tym, że parametry waypoints lub dir_action=navigate będą działać w każdej usłudze lub na każdej trasie w Mapach Google. Zobacz /maps/documentation/urls/get-started#directions-action.
  • Problem: Mapy i Street View korzystają z tego samego punktu końcowego @, więc adres URL mapy bez odpowiedniego działania może nie wyświetlać mapy. Rozwiązanie: ustaw map_action=map dla widoków mapy i map_action=pano dla panoram Street View. Zobacz /maps/documentation/urls/get-started.
  • Problem: jeśli w adresie URL Map brakuje parametru api=1, wszystkie parametry są ignorowane i Mapy Google otwierają się w widoku domyślnym. Rozwiązanie: dodaj api=1 do każdego adresu URL Map (1 to jedyna prawidłowa wartość). Zobacz /maps/documentation/urls/get-started#forming-the-url.