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 tanımlayıcınız, isteğin bir parçası olarak otomatik şekilde 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 kullanmayı düşünebilirsiniz.

(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. Başlatılan uygulamaya iletilen URL'de seçenekler 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 başka bir konuma yol tarifi isteyin. Yol tarifleri dört ulaşım modu için döndürülebilir: arabayla, yürüyerek, bisikletle ve toplu taşımayla.
    • Uygulamanıza gezinme özelliği ekleyin.

  • comgooglemapsurl:// - Bu şema, masaüstü Google Haritalar web sitesinden türetilen bir URL 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 ya da com yerine geçerli bir üst düzey ülke alan adı kullanılarak oluşturulabilir. 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

Uygulamanızda bu URL'lerden birini kullanıcıya sunmadan önce uygulamanın yüklü olduğunu doğrulamanız gerekir. Uygulamanız, aşağıdaki kodu kullanarak URL şemasının kullanılabilir olup olmadığını 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östermek 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ü alanı odak noktasıdır. Virgülle ayrılmış latitude,longitude dizesi olarak biçimlendirilir.
  • mapmode: Gösterilen harita türünü ayarlar. Şu şekilde ayarlanabilir: standard veya streetview. 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 olmadan belirtilirse tüm görünümler temizlenir.
  • zoom: Haritanın yakınlaştırma seviyesini belirtir.

Bu örnek URL, trafik görünümü açıkken 14. yakınlaştırma düzeyinde New York'u merkezine alan haritayı 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ı belirtilen bir görünüm alanı konumunda göstermek 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 konumun çevresinde "Pizza" araması yapar:

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

Yakındaki Pizza

Diğer bazı ö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örüntüleme

İki konum arasındaki yol tariflerini istemek ve göstermek 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 varış noktasını ayarlar. saddr ile aynı biçime ve davranışa sahiptir.
  • directionsmode: Ulaşım şekli. Şu değerlere ayarlanabilir: driving, transit, bicycling veya walking.

Örnek URL, Google NYC ile JFK Havaalanı arasındaki toplu taşıma yol tariflerini 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

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

Google Haritalar masaüstü URL'sinden iOS için Google Haritalar uygulamasını 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 bir üst düzey ülke alanını ifade eder. Yani:

(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 bir 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