Schemat adresu URL w Mapach Google na iOS

Na urządzeniach z systemem iOS 9 lub nowszym możesz używać uniwersalnych linków, aby uruchamiać Mapy Google, gdy masz adres URL Map Google.

Możesz użyć schematu URI adresu URL Map Google, aby uruchomić aplikację Mapy Google na iOS i przeprowadzać wyszukiwania, uzyskiwać zapytania o trasę dojazdu i wyświetlać widoki mapy. Gdy uruchamiasz Mapy Google, identyfikator pakietu jest automatycznie wysyłany w ramach żądania.

Aby używać schematu URI adresu URL Map Google, nie potrzebujesz klucza interfejsu API Google.

Mapy Google na iOS obsługują uniwersalne linki na urządzeniach z systemem iOS 9 lub nowszym.

Jeśli Twój adres URL pasuje do podanego niżej wyrażenia regularnego, a urządzenie ma system iOS 9 lub nowszy, rozważ użycie bezpośrednio metody openURL:.

(http(s?)://)?
((maps\.google\.{TLD}/)|
 ((www\.)?google\.{TLD}/maps/)|
 (goo.gl/maps/))
.*

Na przykład

Swift

UIApplication.shared.openURL(URL(string:"https://www.google.com/maps/@42.585444,13.007813,6z")!)

Objective-C

[[UIApplication sharedApplication] openURL:
   [NSURL URLWithString:@"https://www.google.com/maps/@42.585444,13.007813,6z"]];

Przegląd

Schemat URI adresu URL umożliwia uruchamianie aplikacji na iOS z poziomu innej aplikacji na iOS lub aplikacji internetowej. W adresie URL możesz ustawić opcje, które są przekazywane do uruchomionej aplikacji. Aplikacja Mapy Google na iOS obsługuje te schematy adresów URL:

  • comgooglemaps:// – ten schemat umożliwia uruchomienie aplikacji Mapy Google na iOS i wykonanie jednego z kilku działań:

    • Wyświetl mapę w określonej lokalizacji i na określonym poziomie powiększenia.
    • wyszukiwać lokalizacje lub miejsca i wyświetlać je na mapie;
    • poprosić o wskazówki dojazdu z jednego miejsca do drugiego, Wskazówki dojazdu mogą być zwracane w przypadku 4 środków transportu: samochodu, pieszo, roweru i transportu publicznego.
    • Dodaj nawigację do aplikacji.

  • comgooglemapsurl:// – ten schemat umożliwia uruchamianie aplikacji Mapy Google na iOS za pomocą adresu URL pochodzącego z witryny Map Google na komputery. Oznacza to, że możesz zapewnić użytkownikom wygodę korzystania z urządzeń mobilnych zamiast wczytywania witryny Map Google.

    • Pierwotny adres URL może dotyczyć domeny maps.google.com lub google.com/maps albo dowolnej prawidłowej domeny krajowej najwyższego poziomu zamiast com. Możesz też przekazać adresy URL przekierowania goo.gl/maps.

Uruchamianie aplikacji Mapy Google na iOS i wykonywanie określonej funkcji

Aby uruchomić aplikację Mapy Google na iOS i opcjonalnie wykonać jedną z obsługiwanych funkcji, użyj schematu URI adresu URL w tym formacie:

comgooglemaps://?parameters

Parametry są szczegółowo opisane w dalszej części tego dokumentu.

Sprawdzanie dostępności aplikacji Mapy Google na urządzeniu

Zanim wyświetlisz użytkownikowi jeden z tych adresów URL w aplikacji, sprawdź, czy aplikacja jest zainstalowana. Aplikacja może sprawdzić, czy schemat adresu URL jest dostępny, za pomocą tego kodu:

Swift

UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)

Objective-C

[[UIApplication sharedApplication] canOpenURL:
    [NSURL URLWithString:@"comgooglemaps://"]];

Aby na przykład wyświetlić mapę Central Parku w Nowym Jorku, możesz użyć tego kodu:

Swift

if (UIApplication.shared.canOpenURL(URL(string:"comgooglemaps://")!)) {
  UIApplication.shared.openURL(URL(string:
    "comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic")!)
} else {
  print("Can't use comgooglemaps://");
}

Objective-C

if ([[UIApplication sharedApplication] canOpenURL:
     [NSURL URLWithString:@"comgooglemaps://"]]) {
  [[UIApplication sharedApplication] openURL:
   [NSURL URLWithString:@"comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic"]];
} else {
  NSLog(@"Can't use comgooglemaps://");
}

Wyświetlanie mapy

Użyj schematu URI adresu URL, aby wyświetlić mapę na określonym poziomie powiększenia i w określonej lokalizacji. Możesz też nakładać na mapę inne widoki lub wyświetlać zdjęcia Street View.

Parametry

Wszystkie parametry podane poniżej są opcjonalne. Jeśli nie ustawisz żadnych parametrów, schemat URI adresu URL uruchomi aplikację Mapy Google na iOS.

  • center: to jest punkt środkowy widocznego obszaru mapy. Sformatowany jako ciąg znaków latitude,longitude rozdzielonych przecinkami.
  • mapmode: ustawia rodzaj wyświetlanej mapy. Możliwe wartości: standard lub streetview. Jeśli nie zostanie określony, użyte zostaną bieżące ustawienia aplikacji.
  • views: włącza lub wyłącza określone widoki. Możliwe ustawienia: satellite, traffic lub transit. Możesz ustawić wiele wartości, rozdzielając je przecinkami. Jeśli parametr jest określony bez wartości, spowoduje to wyczyszczenie wszystkich widoków.
  • zoom: określa poziom powiększenia mapy.

Ten przykładowy adres URL wyświetla mapę wyśrodkowaną na Nowym Jorku w powiększeniu 14 z włączonym widokiem natężenia ruchu:

comgooglemaps://?center=40.765819,-73.975866&zoom=14&views=traffic

Mapa ruchu w Nowym Jorku

Inne przykłady:

comgooglemaps://?center=37.788463,-122.392545&zoom=12

comgooglemaps://?center=46.414382,10.013988&mapmode=streetview

Użyj tego schematu, aby wyświetlać zapytania w określonej lokalizacji widocznego obszaru.

Parametry

Oprócz parametrów używanych do wyświetlania mapy wyszukiwarka obsługuje parametr q.

  • q: ciąg zapytania do wyszukiwania.

Ten przykładowy adres URL wyszukuje „pizzę” w określonej lokalizacji:

comgooglemaps://?q=Pizza&center=37.759748,-122.427135

Pizza w pobliżu

Inne przykłady:

comgooglemaps://?q=Steamers+Lane+Santa+Cruz,+CA&center=37.782652,-122.410126&views=satellite,traffic&zoom=15

comgooglemaps://?q=Google+Japan,+Minato,+Tokyo,+Japan&center=35.660888,139.73073&zoom=15&views=transit

Wyświetlanie wskazówek dojazdu

Użyj tego schematu, aby poprosić o wskazówki dojazdu między 2 lokalizacjami i je wyświetlić. Możesz też określić środek transportu.

Parametry

  • saddr: ustawia punkt początkowy wyszukiwania wskazówek dojazdu. Może to być szerokość i długość geograficzna lub adres w formacie zapytania. Jeśli jest to ciąg zapytania, który zwraca więcej niż 1 wynik, zostanie wybrany pierwszy wynik. Jeśli wartość pozostanie pusta, zostanie użyta bieżąca lokalizacja użytkownika.
  • daddr: ustawia punkt końcowy wyszukiwania wskazówek dojazdu. Ma taki sam format i działanie jak saddr.
  • directionsmode: środek transportu. Możliwe wartości: driving, transit, bicycling lub walking.

Przykładowy adres URL wyświetla wskazówki dojazdu transportem publicznym między biurem Google w Nowym Jorku a lotniskiem JFK:

comgooglemaps://?saddr=Google+Inc,+8th+Avenue,+New+York,+NY&daddr=John+F.+Kennedy+International+Airport,+Van+Wyck+Expressway,+Jamaica,+New+York&directionsmode=transit

Transport publiczny

Inne przykłady:

comgooglemaps://?saddr=Google,+1600+Amphitheatre+Parkway,+Mountain+View,+CA+94043&daddr=Google+Inc,+345+Spear+Street,+San+Francisco,+CA&center=37.422185,-122.083898&zoom=10

comgooglemaps://?saddr=2025+Garcia+Ave,+Mountain+View,+CA,+USA&daddr=Google,+1600+Amphitheatre+Parkway,+Mountain+View,+CA,+United+States&center=37.423725,-122.0877&directionsmode=walking&zoom=17

Dodawanie nawigacji do aplikacji

Uruchomienie aplikacji Mapy Google na iOS z prośbą o wskazówki dojazdu daje użytkownikom dostęp do szczegółowej nawigacji z poziomu Twojej aplikacji. Możesz użyć schematu URI adresu URL comgooglemaps://.

Uruchamianie aplikacji Mapy Google na iOS z poziomu adresu URL Map Google na komputerze

Jeśli Twoja aplikacja ma dostęp do istniejącego adresu URL Map Google, np. na stronie internetowej lub w bazie danych, możesz użyć tego schematu, aby otworzyć adres URL w aplikacji Mapy Google na iOS, co zapewni użytkownikom najlepsze wrażenia na urządzeniach mobilnych.

  • Zastąp schemat http:// lub https:// schematem comgooglemapsurl://.

Obsługiwane formaty adresów URL Map Google

Schemat comgooglemapsurl:// obsługuje adresy URL, które pasują do tego wyrażenia regularnego, gdzie {TLD} odnosi się do dowolnej prawidłowej domeny krajowej najwyższego poziomu. Dla przejrzystości dodaliśmy podziały wierszy:

(http(s?)://)?
((maps\.google\.{TLD}/)|
 ((www\.)?google\.{TLD}/maps/)|
 (goo.gl/maps/))
.*

Sprawdzanie dostępności aplikacji Mapy Google

Najpierw sprawdź, czy aplikacja Mapy Google na iOS jest dostępna na urządzeniu i obsługuje schemat URI adresu URL:

Swift

UIApplication.shared.canOpenURL(URL(string:"comgooglemapsurl://")!)

Objective-C

[[UIApplication sharedApplication] canOpenURL:
   [NSURL URLWithString:@"comgooglemapsurl://"]];

Przykłady

Przykład ogólnego adresu URL Map Google:

Pierwotny URL w Mapach Google:

https://www.google.com/maps/preview/@42.585444,13.007813,6z

Używanie schematu URI adresu URL:

comgooglemapsurl://www.google.com/maps/preview/@42.585444,13.007813,6z

Przykład ogólnego adresu URL Map Google:

Pierwotny URL w Mapach Google:

https://maps.google.com/?q=@37.3161,-122.1836

Używanie schematu URI adresu URL:

comgooglemapsurl://maps.google.com/?q=@37.3161,-122.1836