iOS için Google Haritalar URL Şeması

iOS 9 ve sonraki sürümlerin yüklü olduğu cihazlarda, Google Haritalar URL'niz varsa Google Haritalar'ı başlatmak için Geçiş Bağlantıları'nı kullanabilirsiniz.

iOS için Google Haritalar uygulamasını başlatmak, arama yapmak, yol tarifi istekleri almak ve harita görünümlerini görüntülemek için Google Haritalar URL şemasını kullanabilirsiniz. Google Haritalar'ı başlattığınızda paket kimliğiniz otomatik olarak isteğin bir parçası olarak gönderilir.

Google Haritalar URL şemasını kullanmak için Google API anahtarına ihtiyacınız yoktur.

iOS için Google Haritalar, iOS 9 veya sonraki sürümlerin yüklü olduğu cihazlarda Geçiş Bağlantıları'nı destekler.

URL'niz aşağıdaki normal ifadeyle eşleşiyorsa ve cihazda iOS 9 veya sonraki bir sürüm çalışıyorsa doğrudan openURL: yöntemini kullanabilirsiniz.

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

Örneğin,

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"]];

Genel Bakış

URL şeması, bir iOS uygulamasını başka bir iOS uygulamasından veya web uygulamasından başlatmanıza olanak tanır. URL'de, başlatılan uygulamaya iletilen seçenekleri ayarlayabilirsiniz. iOS için Google Haritalar uygulaması aşağıdaki URL şemalarını destekler:

  • comgooglemaps://: Bu şema, iOS için Google Haritalar uygulamasını başlatmanıza ve çeşitli işlemlerden birini gerçekleştirmenize olanak tanır:

    • Belirtilen konumda ve yakınlaştırma seviyesinde bir harita gösterir.
    • Konum veya yer arayıp bunları haritada görüntüleme
    • Bir konumdan diğerine yol tarifi isteyebilirsiniz. Yol tarifleri dört ulaşım modu için döndürülebilir: sürüş, yürüyüş, bisiklet ve toplu taşıma.
    • Uygulamanıza navigasyon ekleyin.

  • comgooglemapsurl://: Bu şema, masaüstü Google Haritalar web sitesinden türetilen bir URL'yi kullanarak iOS için Google Haritalar uygulamasını başlatmanıza olanak tanır. Bu sayede, Google Haritalar web sitesini yüklemek yerine kullanıcılarınıza mobil deneyim sunabilirsiniz.

    • Orijinal URL, maps.google.com veya google.com/maps için olabilir ya da com yerine geçerli herhangi bir üst düzey ülke alan adını kullanabilir. goo.gl/maps yönlendirme URL'lerini de iletebilirsiniz.

iOS için Google Haritalar uygulamasını başlatma ve belirli bir işlevi gerçekleştirme

iOS için Google Haritalar uygulamasını başlatmak ve isteğe bağlı olarak desteklenen işlevlerden birini gerçekleştirmek için aşağıdaki biçimde bir URL şeması kullanın:

comgooglemaps://?parameters

Parametreler, bu belgenin ilerleyen kısımlarında ayrıntılı olarak açıklanmıştır.

Cihazda Google Haritalar uygulamasının kullanılabilirliğini kontrol etme

Bu URL'lerden birini uygulamanızda bir kullanıcıya sunmadan önce uygulamanın yüklü olduğunu doğrulamanız gerekir. Uygulamanız, URL şemasının kullanılabilir olup olmadığını aşağıdaki kodla kontrol edebilir:

Swift

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

Objective-C

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

Örneğin, New York'taki Central Park'ın haritasını görüntülemek için aşağıdaki kodu kullanabilirsiniz:

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://");
}

Harita görüntüleme

Haritayı belirli bir yakınlaştırma seviyesinde ve konumda görüntülemek için URL şemasını kullanın. Ayrıca, haritanızın üzerine başka görünümler yerleştirebilir veya Street View görüntülerini gösterebilirsiniz.

Parametreler

Aşağıdaki parametrelerin tümü isteğe bağlıdır. Hiçbir parametre ayarlanmazsa URL şeması, iOS için Google Haritalar uygulamasını başlatır.

  • center: Bu, harita görüntüleme alanının merkez noktasıdır. latitude,longitude dizesi virgülle ayrılmış olarak biçimlendirilir.
  • mapmode: Gösterilen harita türünü ayarlar. standard veya streetview olarak ayarlanabilir. Belirtilmezse mevcut uygulama ayarları kullanılır.
  • views: Belirli görünümleri açar/kapatır. satellite, traffic veya transit olarak ayarlanabilir. Virgül ayırıcı kullanılarak birden fazla değer ayarlanabilir. Parametre değer belirtilmeden girilirse tüm görünümler temizlenir.
  • zoom: Haritanın yakınlaştırma seviyesini belirtir.

Bu örnek URL, haritayı New York'u merkeze alacak şekilde, 14 yakınlaştırma düzeyinde ve trafik görünümü açık olarak gösterir:

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

New York trafik haritası

Diğer bazı örnekler:

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

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

Arama sorgularını belirli bir görüntü alanı konumunda görüntülemek için bu şemayı kullanın.

Parametreler

Arama, harita görüntülemek için kullanılan parametrelerin yanı sıra q parametresini de destekler.

  • q: Aramanızın sorgu dizesi.

Bu örnek URL, belirtilen konumda "Pizza" araması yapar:

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

Yakındaki Pizza

Diğer örnekler:

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

Yol tarifini göster

İki konum arasında yol tarifi istemek ve görüntülemek için bu şemayı kullanın. Ulaşım modunu da belirtebilirsiniz.

Parametreler

  • saddr: Yol tarifi aramaları için başlangıç noktasını ayarlar. Bu, enlem, boylam veya sorgu biçimli bir adres olabilir. Birden fazla sonuç döndüren bir sorgu dizesiyse ilk sonuç seçilir. Değer boş bırakılırsa kullanıcının mevcut konumu kullanılır.
  • daddr: Yol tarifi aramaları için bitiş noktasını ayarlar. saddr ile aynı biçime ve davranışa sahiptir.
  • directionsmode: Ulaşım yöntemi. Şu değerlere ayarlanabilir: driving, transit, bicycling veya walking.

Örnek URL, Google NYC ile JFK Havaalanı arasındaki toplu taşıma yol tarifini gösterir:

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

Toplu taşımayla yol tarifi

Diğer bazı örnekler:

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

Uygulamanıza gezinme özelliği ekleme

iOS için Google Haritalar uygulamasını yol tarifi isteğiyle başlatmak, kullanıcılarınıza uygulamanızdan adım adım rota erişimi sağlar. comgooglemaps:// URL şemasını kullanabilirsiniz.

iOS için Google Haritalar uygulamasını bir Google Haritalar masaüstü URL'sinden başlatma

Uygulamanızın, web sayfası veya veritabanı gibi önceden mevcut bir Google Haritalar URL'sine erişimi varsa URL'yi iOS için Google Haritalar uygulamasında açmak üzere bu şemayı kullanabilir ve böylece kullanıcılarınıza en iyi mobil deneyimi sunabilirsiniz.

  • http:// veya https:// şemasını comgooglemapsurl:// ile değiştirin.

Desteklenen Google Haritalar URL biçimleri

comgooglemapsurl:// şeması, bu normal ifadeyle eşleşen URL'leri destekler. Burada {TLD}, geçerli herhangi bir üst düzey ülke alan adını ifade eder. Anlaşılırlık için satır sonları eklenmiştir:

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

Google Haritalar uygulamasının kullanılabilirliğini kontrol etme

Öncelikle iOS için Google Haritalar uygulamasının cihazda mevcut olduğunu ve URL şemasını desteklediğini doğrulayın:

Swift

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

Objective-C

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

Örnekler

Genel Google Haritalar URL'si örneği:

Orijinal Google Haritalar URL'si:

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

URL şemasını kullanma:

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

Genel bir Google Haritalar URL'si örneği:

Orijinal Google Haritalar URL'si:

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

URL şemasını kullanma:

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