Giriş
Haritalar URL'lerini kullanarak Google Haritalar'ı başlatmak ve aramalar yapmak, yol tarifleri ve navigasyon bilgileri almak, harita görünümlerini ve panoramik resimleri görüntülemek için evrensel bir platformlar arası URL oluşturabilirsiniz. URL söz dizimi, kullanılan platformdan bağımsız olarak aynı kalır.
Haritalar URL'lerini kullanmak için Google API anahtarına ihtiyacınız yoktur.
Platformlar arası evrensel söz dizimi
Bir Android uygulamasının, iOS uygulamasının veya web sitesinin geliştiricisi olarak, ortak bir URL oluşturabilirsiniz. Bu araç, harita açıldığında kullanılan platform ne olursa olsun Google Haritalar'ı açar ve istenen işlemi gerçekleştirir.
- Android cihazda:
- Android için Google Haritalar uygulaması yüklü ve etkinse URL, Haritalar uygulamasında Google Haritalar'ı başlatır ve istenen işlemi gerçekleştirir.
- Google Haritalar uygulaması yüklü değilse veya devre dışı bırakılırsa URL, Google Haritalar'ı bir tarayıcıda başlatır ve istenen işlemi gerçekleştirir.
- iOS cihazlarda:
- iOS için Google Haritalar uygulaması yüklüyse URL, Haritalar uygulamasında Google Haritalar'ı başlatır ve istenen işlemi gerçekleştirir.
- Google Haritalar uygulaması yüklü değilse URL, bir tarayıcıda Google Haritalar'ı başlatır ve istenen işlemi gerçekleştirir.
- Başka bir cihazda URL, Google Haritalar'ı bir tarayıcıda başlatır ve istenen işlemi gerçekleştirir.
Google Haritalar'ı uygulamanızdan veya web sitenizden başlatmak için platformlar arası bir URL kullanmanız önerilir. Bu evrensel URL'ler, kullanılan platform ne olursa olsun harita isteklerinin daha kapsamlı bir şekilde işlenmesine olanak tanır. Yalnızca mobil platformda işlevsel olabilecek özellikler (örneğin, adım adım gezinme) için Android veya iOS'te platforma özel bir seçenek kullanmayı tercih edebilirsiniz. Aşağıdaki dokümanları inceleyin:
- Android için Google Haritalar Amaçları: Özellikle Android için Google Haritalar uygulamasını kullanıma sunma
- iOS için Google Haritalar URL Şeması: iOS için Google Haritalar uygulamasını kullanıma sunmak
Google Haritalar'ı başlatma ve belirli bir işlemi gerçekleştirme
Google Haritalar'ı başlatmak ve isteğe bağlı olarak desteklenen işlevlerden birini gerçekleştirmek için, istenen işleme bağlı olarak aşağıdaki formlardan birinin URL şemasını kullanın:
- Arama - Belirli bir yerin raptiyesini görüntüleyen bir Google Haritası başlatın veya sonuçları göstermek için genel bir arama yapın ve bir harita başlatın:
https://www.google.com/maps/search/?api=1¶meters
- Yol tarifi
— Yol tarifi isteyin ve sonuçları kullanarak Google Haritalar'ı başlatın:
https://www.google.com/maps/dir/?api=1¶meters
- Harita görüntüleme
— İşaretçi veya yol tarifi olmaksızın Google Haritalar'ı başlatın:
https://www.google.com/maps/@?api=1&map_action=map¶meters
- Street View panoraması gösterin
- Etkileşimli panoramik resim başlatın:
https://www.google.com/maps/@?api=1&map_action=pano¶meters
Önemli: api=1
parametresi, bu URL'nin hangi Haritalar URL'leri için tasarlandığını tanımlar. Bu parametre her istekte gereklidir. Geçerli tek değer 1'dir. URL'de api=1
ibaresi yoksa tüm parametreler yoksayılır ve kullanılan platforma (ör. https://www.google.com/maps) bağlı olarak varsayılan Google Haritalar uygulaması tarayıcıda veya Google Haritalar mobil uygulamasında başlatılır.
Geçerli URL'ler oluşturma
URL'leri doğru şekilde kodlamanız gerekir.
Örneğin, bazı parametreler ayırıcı olarak dikey çizgi karakteri (|
) kullanır. Bu karakteri nihai URL'de %7C
olarak kodlamanız gerekir. Diğer parametreler, enlem/boylam koordinatları veya Şehir, Eyalet gibi
virgülle ayrılmış değerler kullanır. Virgülü %2C
olarak kodlamanız gerekir. Alanları %20
ile kodlayın veya artı işaretiyle (+
) değiştirin.
Ayrıca URL'ler, her istek için 2.048 karakterle sınırlıdır. URL'lerinizi oluştururken bu sınıra dikkat edin.
Haritadaki işlemler
Kullanılabilen harita işlemleri şunlardır: arama, yol tarifi, harita görüntüleme ve Street View panoraması görüntüleme. İşlemi, zorunlu ve isteğe bağlı parametrelerle birlikte istek URL'sinde belirtirsiniz. URL'lerde olduğu gibi, parametreleri "ve" (&
) karakterini kullanarak ayırırsınız. Her işlem için parametre listesi ve olası değerleri Arama Parametreleri bölümünde belirtilir.
Arama
Arama işlemi, görünür harita bölgesinde yapılan aramanın sonuçlarını görüntüler. Belirli bir yeri ararken, görüntülenen harita belirtilen konuma bir raptiye yerleştirir ve mevcut yer ayrıntılarını gösterir.
Arama URL'sini oluşturma
https://www.google.com/maps/search/?api=1¶meters
Parametreler
query
(gerekli): Haritada vurgulanacak yerleri tanımlar. Tüm arama istekleri için sorgu parametresi gereklidir.- Konumları bir yer adı, adres veya virgülle ayrılmış enlem/boylam koordinatları olarak belirtin. Dizeler URL olarak kodlanmış olmalıdır. Bu nedenle, "Belediye Binası, New York, NY" gibi bir adres
City+Hall%2C+New+York%2C+NY
biçimine dönüştürülmelidir. - Genel arama terimlerini
grocery+stores
veyarestaurants+in+seattle+wa
gibi URL kodlamalı bir dize olarak belirtin.
- Konumları bir yer adı, adres veya virgülle ayrılmış enlem/boylam koordinatları olarak belirtin. Dizeler URL olarak kodlanmış olmalıdır. Bu nedenle, "Belediye Binası, New York, NY" gibi bir adres
query_place_id
(isteğe bağlı): Yer kimliği, bir yeri benzersiz şekilde tanımlayan metin tanımlayıcısıdır.search
işlemi içinquery
belirtmeniz gerekir, ancakquery_place_id
de belirtebilirsiniz. İki parametreyi de belirtirsenizquery
yalnızca Google Haritalar, yer kimliğini bulamazsa kullanılır. Belirli bir işletmeye mutlaka bağlantı oluşturmaya çalışıyorsanız yer kimliği, doğru yere bağlantı vereceğinizin en iyi garantisidir. Enlem/boylam koordinatlarını kullanarak belirli bir konumu sorgularkenquery_place_id
göndermeniz de önerilir.
Arama örnekleri
Konum arama
Konum aramasında bir yer adı, adres veya virgülle ayrılmış enlem/boylam koordinatları kullanarak belirli bir konumu ararsınız ve sonuçta bu harita üzerinde bir raptiye görüntülenir. Bu üç örnek, farklı konum değerleri kullanılarak aynı konum olan CenturyLink Field (Seattle, WA'daki spor stadyumu) için yapılan aramaları göstermektedir.
1. Örnek: "CenturyLink Field" yer adını aramak şu haritada sonuçlanacaktır:
https://www.google.com/maps/search/?api=1&query=centurylink+field
2. Örnek: Yer kimliğini ve enlem/boylam koordinatlarını kullanarak CenturyLink Field araması aşağıdaki haritada görüntülenir:
3. Örnek: Yalnızca enlem/boylam koordinatlarını kullanarak CenturyLink Alanı için arama yapıldığında aşağıdaki harita gösterilir. Haritada bir raptiyenin bulunduğuna, ancak haritada veya yan panelde ek yer bilgisi sağlanmadığına dikkat edin:
https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393
Kategorik arama
Kategorik aramada, genel bir arama terimi geçersiniz ve Google Haritalar, belirttiğiniz konumun yakınındaki ölçütlerinizle eşleşen girişleri bulmaya çalışır.
Konum belirtilmemişse Google Haritalar mevcut konumunuzun yakınındaki girişleri bulmaya çalışır. Kategorik bir arama için konum bilgisi sağlamayı tercih ederseniz konumu, genel arama dizesine (örneğin, pizza+seattle+wa
) ekleyin.
Bu örnekte, İstanbul'daki pizza restoranları için yapılan bir arama aşağıdaki haritada gösterilir:
https://www.google.com/maps/search/?api=1&query=pizza+seattle+wa
Yol tarifi
Yol tarifi işlemi, haritada belirtilen iki veya daha fazla nokta arasındaki yolun yanı sıra mesafe ve seyahat süresini gösterir.
Yol Tarifi URL'sini Oluşturma
https://www.google.com/maps/dir/?api=1¶meters
Parametreler
origin
: Yol tariflerinin gösterileceği başlangıç noktasını tanımlar. Varsa varsayılan olarak en alakalı başlangıç konumunu (cihaz konumu gibi) ayarlar. Yoksa, sonuçta gösterilen harita, kullanıcının kaynağa erişmesine izin vermek için boş bir form sağlayabilir. Değer bir yer adı, adres veya virgülle ayrılmış enlem/boylam koordinatları olabilir. Bir dize URL olarak kodlanmalıdır. Bu nedenle, "Belediye Binası, New York, NY" gibi bir adresCity+Hall%2C+New+York%2C+NY
olarak dönüştürülmelidir.Not: URL'nizde
origin_place_id
belirtmediğiniz sürece bu parametre isteğe bağlıdır.origin_place_id
belirtmeyi seçerseniz URL'yeorigin
de eklemeniz gerekir.origin_place_id
(isteğe bağlı): Yer kimliği, bir yeri benzersiz şekilde tanımlayan metin tanımlayıcısıdır. Bir işletmeyi kesin olarak belirtmeye çalışıyorsanız doğru yere bağlantı oluşturmanız için en iyi garanti, yer kimliği kullanmaktır. Bu parametreyi kullanan URL'lerorigin
içermelidir.destination
: Yol tariflerinin uç noktasını tanımlar. Yoksa, kullanıcının haritaya hedefe girmesine olanak tanımak için boş bir form sağlayabilir. Değer bir yer adı, adres veya virgülle ayrılmış enlem/boylam koordinatları olabilir. Bir dize URL olarak kodlanmalıdır. Bu nedenle, "Belediye Binası, New York, NY" gibi bir adresCity+Hall%2C+New+York%2C+NY
olarak dönüştürülmelidir.Not: URL'nizde
destination_place_id
belirtmediğiniz sürece bu parametre isteğe bağlıdır.destination_place_id
belirtmeyi seçerseniz URL'yedestination
de eklemeniz gerekir.destination_place_id
(isteğe bağlı): Yer kimliği, bir yeri benzersiz şekilde tanımlayan metin tanımlayıcısıdır. Bir işletmeyi kesin olarak belirtmeye çalışıyorsanız doğru yere bağlantı oluşturmanız için en iyi garanti, yer kimliği kullanmaktır. Bu parametreyi kullanan URL'ler de birdestination
içermelidir.travelmode
(isteğe bağlı): Seyahat yöntemini tanımlar. Sunulan seçenekler şunlardır:driving
,walking
(kullanılabiliyorsa yaya yollarını ve kaldırımları tercih eder),bicycling
(bisiklet yolları ve tercih edilen sokaklar için bulunduğu yerlerde) veyatransit
.travelmode
özelliği belirtilmezse Google Haritalar, belirtilen rota ve/veya kullanıcı tercihleri için en alakalı modlardan birini veya daha fazlasını gösterir.dir_action=navigate
(isteğe bağlı): Kaynağın kullanılabilir olup olmamasına bağlı olarak adım adım navigasyonu veya belirtilen hedefe rota önizlemesini başlatır. Kullanıcı bir kaynak belirtiyorsa ve kaynak, kullanıcının mevcut konumuna yakın değilse veya cihazın mevcut konumu kullanılamıyorsa harita bir rota önizlemesi başlatır. Kullanıcı bir kaynak belirtmezse (bu durumda kaynak varsayılan olarak mevcut cihaz konumuna ayarlanır) veya kaynak, kullanıcının geçerli konumuna yakınsa harita adım adım navigasyonu başlatır. Navigasyonun tüm Google Haritalar ürünlerinde ve/veya tüm hedefler arasında kullanılamadığını unutmayın. Bu gibi durumlarda bu parametre yok sayılır.waypoints
: Yol tarifleriniorigin
iledestination
arasında yönlendirmek için bir veya daha fazla aracı yer belirtir. Yerleri ayırmak için dikey çizgi karakteri (|
) kullanılarak birden çok ara nokta belirtilebilir (örneğin,Berlin,Germany|Paris,France
). İzin verilen ara nokta sayısı, bağlantının açıldığı platforma göre değişir. Mobil tarayıcılarda en fazla üç ara nokta desteklenir ve aksi halde en fazla dokuz ara nokta desteklenir. Referans noktaları, haritada URL'de listelendikleri sırayla gösterilir. Her ara nokta bir yer adı, adres veya virgülle ayrılmış enlem/boylam koordinatları olabilir. Dizeler URL olarak kodlanmalıdır. Bu nedenle, "Berlin,Almanya|Paris,Fransa" gibi referans noktalarıBerlin%2CGermany%7CParis%2CFrance
biçimine dönüştürülmelidir.Notlar:
- Referans noktaları tüm Google Haritalar ürünlerinde desteklenmez; bu durumlarda bu parametre yok sayılır.
- URL'nizde
waypoint_place_ids
belirtmediğiniz sürece bu parametre isteğe bağlıdır.waypoint_place_ids
belirtmeyi seçerseniz URL'ye dewaypoints
eklemeniz gerekir.
waypoint_place_ids
(isteğe bağlı): Yer kimliği, bir yeri benzersiz şekilde tanımlayan metin tanımlayıcısıdır.Waypoint_place_ids
,waypoints
listesiyle eşleşen yer kimlikleri listesi sağlamanıza olanak tanır. Yer kimlikleri, ara noktalarla aynı sırayla listelenmeli ve "|
" dikey çizgi karakteriyle ( URL kodlamalı%7C
olarak) ayrılmalıdır. Belirli işletmeleri kesin olarak belirtmeye çalışıyorsanız yer kimlikleri, doğru yerlere bağlantı kurmanızın en iyi garantisidir. Bu parametreyi kullanan URL'lerwaypoints
içermelidir.
Yol tarifi örnekleri
Aşağıdaki URL, yol tarifi modunda bir harita açar ve kullanıcının kalkış noktası ile varış noktasına girebileceği bir form sağlar.
https://www.google.com/maps/dir/?api=1
Aşağıdaki örnekte, Seattle, WA'da bulunan Space Needle'dan Pike Place Market'a bisikletle yol tarifi içeren bir harita sunulmuştur.
Aşağıdaki örnekte, Avustralya'nın Sidney şehrindeki Google'dan Queen Victoria Building'e yaya yol tarifi içeren bir harita kullanıma sunulmuştur.
Harita görüntüleme
Harita işlemi, hiçbir işaretçi veya yol tarifi içermeyen bir harita döndürür.
Harita URL'sini oluşturma
https://www.google.com/maps/@?api=1&map_action=map¶meters
Parametreler
map_action=map
(gerekli): Gösterilecek harita görünümünün türünü belirtir. Haritalar ve Street View aynı uç noktayı paylaşır. Bir haritanın gösterildiğinden emin olmak içinmap_action
,map
olarak belirtilmelidir.center
(isteğe bağlı): Harita penceresinin merkezini tanımlar ve enlem/boylam koordinatlarını virgülle ayrılmış değerler olarak kabul eder (örneğin,-33.8569,151.2152
).zoom
(isteğe bağlı): Haritanın ilk yakınlaştırma düzeyini ayarlar. Kabul edilen değerler 0 (tüm dünya) ile 21 (bağımsız binalar) arasında değişen tam sayılardır. Üst sınır, seçilen konumda kullanılabilen harita verilerine bağlı olarak değişebilir. Varsayılan değer 15'tir.basemap
(isteğe bağlı): Gösterilecek harita türünü tanımlar. Değerroadmap
(varsayılan),satellite
veyaterrain
olabilir.layer
(isteğe bağlı): Varsa, harita üzerinde görüntülenecek ek bir katmanı tanımlar. Değer şunlardan biri olabilir:none
(varsayılan),transit
,traffic
veyabicycling
.
Harita örnekleri
Bu örnek URL, kullanıcının geçerli konumuna göre varsayılan bir Google Haritası açar.
https://www.google.com/maps/@?api=1&map_action=map
Aşağıdaki örnekte Katoomba, NSW, Avustralya merkezli (-33.712206,150.311941
) ve isteğe bağlı zoom
ile basemap
parametrelerini ayarlayan bir harita görüntülenmektedir.
Street View panoraması görüntüleme
Pano işlemi, Street View görüntülerini etkileşimli panoramalar olarak görüntülemek için bir görüntüleyen başlatmanızı sağlar. Her Street View panoraması, tek bir konumdan tam 360 derece görünüm sağlar. Resimler, 360 derece yatay görünüm (tam sarmalama) ve 180 derece dikey görünüm (düzden sağa) içerir. Pano işlemi, ortaya çıkan panoramayı ortasında kamera bulunan bir küre olarak oluşturan bir görüntüleyici başlatır. Kamerayı, yakınlaştırmayı ve yönü kontrol etmek için değiştirebilirsiniz.
Google Street View, kapsama alanı boyunca belirli yerlerden panoramik manzaralar sunar. Kullanıcılar tarafından eklenen Photo Sphere ve Street View özel koleksiyonları da mevcuttur.
Street View URL'sini Oluşturma
https://www.google.com/maps/@?api=1&map_action=pano¶meters
Parametreler
map_action=pano
(zorunlu): Gösterilecek görünüm türünü belirtir. Haritalar ve Street View aynı uç noktayı paylaşır. Bir panoramanın gösterilebilmesi içinaction
,pano
olarak belirtilmelidir.
Aşağıdaki URL parametrelerinden biri de gereklidir:
viewpoint
: Görüntüleyen, virgülle ayrılmış enlem/boylam koordinatları (örneğin, 46.414382,10.013988) olarak,viewpoint
konumuna en yakın fotoğrafı gösterir. Street View görüntüleri düzenli olarak yenilendiğinden ve fotoğraflar her seferinde biraz farklı konumlardan çekilebildiğinden, görüntüler güncellenirken konumunuz farklı bir panoramik olarak algılanabilir.pano
: Görüntülenecek spesifik panorama kimliği. Birpano
belirtirsenizviewpoint
değerini de belirtebilirsiniz.viewpoint
öğesi yalnızca Google Haritalar, panoramik kimliği bulamazsa kullanılır.pano
belirtilir ancak bulunamazsa veviewpoint
belirtilmezse DEĞİL ise panoramik resim gösterilmez. Bunun yerine, Google Haritalar varsayılan modda açılır ve kullanıcının geçerli konumunu gösteren bir harita gösterir.
Aşağıdaki URL parametreleri isteğe bağlıdır:
heading
: Kameranın pusula yönünü kuzeyden saat yönünde gösterir. Kabul edilen değerler -180 ile 360 derece arasındadır. Atlanırsa, sorgunun görüntülenme noktasına (belirtilmişse) ve resmin gerçek konumuna göre varsayılan bir başlık seçilir.pitch
: Kameranın yukarı veya aşağı açısını belirtir. Ses perspektifi -90 ile 90 derece arasında belirtilir. Pozitif değerler kamera açısını yukarı, negatif değerler de kamerayı aşağı doğru çeker. Varsayılan 0 değeri, kameranın görüntü çekildiğindeki konumuna göre ayarlanır. Bu nedenle 0 satış konuşması her zaman değil, genellikle yatay olur. Örneğin, bir tepede çekilen resimde, yatay olmayan varsayılan bir perde gösteriliyor.fov
: Resmin yatay görüş alanını belirler. Görüş alanı, 10 - 100 aralığında derece olarak ifade edilir. Varsayılan olarak 90 değerine ayarlanır. Sabit boyutlu bir görüntü alanıyla ilgili olarak, görüntüleme alanı yakınlaştırma düzeyi olarak kabul edilir ve küçük sayılar daha yüksek bir yakınlaştırma düzeyini belirtir.
Street View örnekleri
İlk iki örnekte Eyfel Kulesi'nin panoramik fotoğrafı gösterilmektedir. Birinci örnek, konum için yalnızca bir viewpoint
kullanır ve isteğe bağlı heading
, pitch
ve fov
parametrelerini ayarlar. Karşılaştırma amacıyla ikinci örnek bir pano
kimliğinin yanı sıra ilk örnekte ayarlanan parametreleri kullanır. Üçüncü örnekte bir iç mekan panoramik resim gösteriliyor.
1. Örnek: Konumu belirtmek için yalnızca viewpoint
kullanılır.
2. Örnek: viewpoint
konumunun yanı sıra pano
kimliği de kullanılır.
pano
kimliği, viewpoint
kategorisine göre önceliklidir.
Bu örnekte, panorama kimliği bulunduğu için viewpoint
yoksayılır. pano
kimliği için görüntülenen panorama resminin, yalnızca viewpoint
kullanılarak bulunan görselden biraz farklı ve daha yeni olduğunu unutmayın.
3. Örnek: Birleşik Krallık, Londra'daki Sarastro restoranının içine ait panoramik bir kimlikle birlikte panoramik görüntüler.
https://www.google.com/maps/@?api=1&map_action=pano&pano=4U-oRQCNsC6u7r8gp02sLA
Panorama kimliği bulma
Belirli bir panorama resminin kimliğini bulmak için kullanabileceğiniz birden fazla yöntem vardır.
- JavaScript için StreetViewPanorama sınıfını kullanın.
- Android için, herkese açık sınıfı StreetViewPanoramaLocation kullanın.
- iOS için GMSPanorama sınıfını kullanın.
- Ayrıca Google Street View Image API'yi kullanarak meta veri isteğinde bulunabilirsiniz. Resim meta veri istekleri, panorama kimliği dahil olmak üzere Street View panoramaları hakkında veri sağlar.
Diğer örnekler
Referans noktalarının kullanıldığı yol tarifi örnekleri
Aşağıdaki yol tarifi örnekleri Google Haritalar'ı kullanıma sunmakta ve Paris, Fransa'dan Cherbourg, Fransa'ya aşağıdaki arabayla yol tarifini görüntülemektedir:
Şehir, Ülke | Yer Adı | Yer Kimliği |
---|---|---|
1. Versailles, Fransa | Versay Sarayı | ChIJdUyx15R95kcRj85ZX8H8OAU |
2. Chartres, Fransa | Chartres Katedrali | ChIJKzGHdEgM5EcR_OBTT3nQoEA |
3. Le Mans, Fransa | Le Mans Aziz Julian Katedrali | ChIJG2LvQNCI4kcRKXNoAsPi1Mc |
4. Caen, Fransa | Caen Kalesi | ChIJ06tnGbxCCkgRsfNjEQMwUsc |
Örnek URL'lerde referans noktaları farklı şekillerde tanımlanır. Böylece, elde edilen haritalarda referans noktaların görüntülenmesine ilişkin farklılıklar karşılaştırılabilir.
1. Örnek: Şehir, Ülke olarak tanımlanan referans noktaları:
2. Örnek: Belirli yer adları olarak tanımlanan referans noktaları:
3. Örnek: Referans noktası, Şehir, Ülke olarak tanımlanır ve
her bir referans noktasındaki belirli bir kuruluş için waypoint_place_ids
sağlar:
4. Örnek: Referans noktalarını Şehir, Ülke olarak tanımlar ancak referans noktaları önceki örneklere kıyasla farklı bir sırayla listeler. Haritada, ara noktaları URL'de listelendikleri sırayla gösterir.
Harita örnekleri
Belirtilen basemap
(uydu) ve layer
(toplu taşıma) ile bir harita görüntüler.
Street View örnekleri
pano
kimliği olarak bir FIFE resim anahtarını kullanarak Street View panoraması görüntüler. pano
kimliğinin başında F: simgesi olduğunu unutmayın.