Günümüzde konum bilgisine duyarlı bir dünyada kullanıcılar, yer bilgilerine, yol tariflerine ve navigasyona sorunsuz erişim bekliyor. Kullanıcılar, ister bir mesajlaşma uygulaması, ister yerel bağlam keşif uygulaması, lojistik ve ulaşım platformu, seyahat planlayıcı veya emlak listeleme platformu aracılığıyla olsun, genellikle konum ayrıntılarını hızlıca görüntülemeleri ya da A'dan B'ye en iyi rotayı bulmaları gerekir. Geliştiriciler kendi uygulama içi deneyimlerini oluşturabilir ancak Google Haritalar'ın kapsamlı ve tanıdık arayüzünden yararlanmak daha iyi bir deneyim sunar.
Sorunsuz bir kullanıcı deneyimi için iyi yapılandırılmış bir Google Haritalar URL'si gereklidir. Yanlış URL'ler bu deneyimi tehlikeye atar, kullanıcıları yanlış konuma yönlendirir, belirli ayrıntılar yerine genel bir harita görünümü gösterir ve hatta bozuk bir bağlantıya neden olur. Bu durum, kullanıcıların canını sıkar ve hedeflerine ulaşmalarını engeller. Örneğin, geçerli bir Haritalar URL'si olsa bile belirli bir işletmeyle ilgili ayrıntıları bekleyen bir kullanıcı, bunun yerine alakalı hiçbir bilgi içermeyen genel bir harita görünümüne yönlendirilebilir. Aşağıdaki örneğe bakın:
https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152
Bu Haritalar URL'si, Google Haritalar'ı açmak ve enlem ile boylama dayalı bir konum görüntülemek için geçerlidir. Ancak kullanıcılara belirli bir yerle ilgili ayrıntılar sağlamaz.
Doğru URL'ler aracılığıyla uygulamanızı Google Haritalar ile sorunsuz bir şekilde bağlama
Google Haritalar Platformu (GMP), doğru URL'ler oluşturmak için iki temel yöntem sunar: API anahtarı gerektiren Places API(Yeni) ve ücretsiz olup anahtar gerektirmeyen Haritalar URL'leri. Aşağıdaki çözümler farklı senaryoları ve kullanım alanlarını ele alır:
GMP Places API(Yeni)'nin googleMapsUri veya googleMapsLinks alanını kullanma
GMP Places API(Yeni), belirli bir yer hakkında kapsamlı bir bilgi grubu döndürür. googleMapsUri veya googleMapsLinks alanı (alan maskesinde belirtilerek) istendiğinde API yanıtı bir yer nesnesi içerir.
Bu nesne, Google Haritalar'da ilgili görünümü (ör. yer ayrıntıları görünümü) doğrudan açmak için kullanılabilecek önceden biçimlendirilmiş URL'ler içerir.
Örnek:
Yer Ayrıntıları İsteği
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: YOUR_API_KEY" \ -H "X-Goog-FieldMask: googleMapsUri,googleMapsLinks" \ https://places.googleapis.com/v1/places/ChIJ3S-JXmauEmsRUcIaWtf4MzE
Yer Ayrıntıları Yanıtı:
{
"googleMapsUri": "https://maps.google.com/?cid=3545450935484072529",
"googleMapsLinks": {
"directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!3e0",
"placeUri": "https://maps.google.com/?cid=3545450935484072529",
"writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!12e1",
"reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!9m1!1b1",
"photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!10e5"
}
}Yukarıdaki örnekte ChIJ3S-JXmauEmsRUcIaWtf4MzE, Sidney Opera Binası'nın yer kimliğidir. Yer kimliği, Google Places veritabanında ve Google Haritalar'da bir yeri benzersiz şekilde tanımlayan metin biçiminde bir tanımlayıcıdır.
Yer kimliklerini ücretsiz olarak alma
Yer kimliklerini programatik olarak almak için Places API: Text Search(ID Only) işlevini kullanabilirsiniz. Bu, yer kimliklerini ücretsiz olarak alabileceğiniz bir yöntemdir. Yer Kimliği ve Yer API'si(Yeni) isteği hakkında daha fazla bilgi edinin.
Places API Metin Arama(Yalnızca Kimlik) İsteği:
curl -X POST -d '{"textQuery" : "Sydney Opera House"}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: places.id' \
'https://places.googleapis.com/v1/places:searchText'Places API Metin Arama(Yalnızca Kimlik) Yanıtı:
{
"places": [
{
"id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
}
]
}Kullanıcı haritalarda bir ÖY'yi tıkladığında veya ÖY'ye dokunduğunda da yer kimlikleri alınabilir. Tıklanabilir ÖY simgeleri hakkında daha fazla bilgi edinin(JavaScript, Android, iOS)
Uygulama
Places API'yi kullanırken geliştiriciler, yanıttan googleMapsUri veya googleMapsLinks alanını kolayca çıkarabilir ve uygulamayı yüklememişlerse Google Haritalar uygulamasında ya da bir tarayıcıda ilgili görünümü başlatmak için kullanabilir.
| Özellik | Açıklama |
|---|---|
| directionsUri | Google Haritalar'ı açarak kullanıcının mevcut konumundan bu yere yol tarifini gösterme bağlantısı |
| placeUri | Google Haritalar'ı açarak bu yerin yer ayrıntıları sayfasına gitme bağlantısı |
| writeAReviewUri | Google Haritalar'ı açarak bu yerin yorum yazma sayfasına gitme bağlantısı |
| reviewsUri | Google Haritalar'ı bu yerin yorumlar sayfasına yönlendiren bağlantı |
| photosUri | Google Haritalar'ı açarak bu yerin fotoğraflar sayfasına gitmek için kullanılan bağlantı |
Geliştirici kılavuzuna göz atın ve özelliği hemen deneyin.
Haritalar URL'lerini kullanma
Haritalar URL'lerini kullanarak Google Haritalar'ı başlatmak, arama yapmak, yol tarifi ve navigasyon almak, harita görünümlerini ve panoramik görüntüleri göstermek için evrensel ve platformlar arası bir URL oluşturabilirsiniz. URL söz dizimi, kullanılan platformdan bağımsız olarak aynıdır. Haritalar URL'lerini kullanmak için Google API anahtarına ihtiyacınız yoktur.
Kullanılabilecek harita işlemleri şunlardır:
Arama işlevi, Google Haritalar uygulamasını veya uygulama yüklü değilse belirli bir yer için raptiye gösteren bir tarayıcıyı başlatır ya da genel bir arama yapar ve sonuçları göstermek için bir harita başlatır.
Yol tarifi işlevi, Google Haritalar uygulamasını veya uygulama yüklü değilse bir tarayıcıyı başlatır. Bu uygulama, noktalar arasındaki yol tariflerini gösterir ya da mobil cihazlarda Google Haritalar'da adım adım navigasyonu etkinleştirir.
Street View panorama işlevi, Street View görüntülerini etkileşimli panoramalar olarak göstermek için bir görüntüleyici başlatmanıza olanak tanır.
Daha fazla işlevi ve örneği incelemek için GMP Haritalar URL'leri geliştirici belgelerini ziyaret edin.
Burada, Haritalar URL'lerinin iki temel işlevini ayrıntılı olarak ele alıyoruz:
Google Haritalar'da yer ayrıntılarını gösterme: Bu bölümde, Google Haritalar'da belirli bir konumun ayrıntılarını gösterecek URL'lerin nasıl oluşturulacağı açıklanmaktadır. Ayrıca, yer kimliklerini ve kesin sorguları kullanarak benzersiz olmayan adlara sahip yerlerle nasıl çalışılacağı da ayrıntılı olarak açıklanmaktadır.
Haritalar URL'lerini kullanarak yol tarifi sağlama: Bu bölümde, birden fazla ara nokta içeren yol tarifleri ve adım adım gezinme dahil olmak üzere konumlar arasında yol tarifi sağlayan URL'lerin nasıl oluşturulacağı açıklanmaktadır.
Google Haritalar'da yer ayrıntılarını gösterme
Arama işlevi, yer aramasını tamamlamak için iki parametre alır. Bunlar query(zorunlu) ve query_place_id(isteğe bağlı) parametreleridir.
query parametresi tüm arama istekleri için zorunludur. Yer adı, virgülle ayrılmış enlem/boylam koordinatları veya genel bir arama terimi kabul eder.
Arama URL'sinin yapısı:
https://www.google.com/maps/search/?api=1¶meters
1. senaryo: Benzersiz bir yer adı için yer ayrıntılarını gösterme
https://www.google.com/maps/search/?api=1&query=Sydney%20Opera%20House
Şimdi de benzersiz olmayan bir ada sahip yeri ele alalım. Yalnızca bu benzersiz olmayan adla arama yaptığınızda ne olur? Sonraki senaryoya bakın.
2. senaryo: Tek olmayan bir yer adı için yer arama
https://www.google.com/maps/search/?api=1&query=7-Eleven
Yer adı benzersiz olmadığından bu URL, görünüm alanındaki yakındaki 7-Eleven konumlarının listesini açar. Kullanıcılar daha sonra ayrıntılarını görmek için belirli bir mağazayı seçebilir.
Konum listesini atlayıp doğrudan belirli bir ayrıntılar sayfasına erişmek için daha hassas bir yöntem kullanabilirsiniz. Bir sonraki örneğe bakın.
3. senaryo: Benzersiz olmayan bir yer adı için yer ayrıntılarını gösterme
Yaygın yer adlarıyla ilgili olarak basit bir ad araması genellikle bir konum listesi döndürür. Doğrudan belirli bir ayrıntılar sayfasına bağlantı vermek için aşağıdaki yöntemlerden birini kullanabilirsiniz:
1. yöntem: Yer adı ve adresiyle tam sorgu kullanma
https://www.google.com/maps/search/?api=1&query=7-Eleven%2C37%20Swanston%20St%2C%20Melbourne%20Australia
Bu URL'de query parametresi yer adı, adres olarak biçimlendirilmiştir. Bu, aramayı daraltmaya ve doğrudan istenen konuma bağlantı vermeye yardımcı olur.
2. yöntem: Yer kimliğini kullanma
Yer kimlikleri, Google Places veritabanında ve Google Haritalar'da bir yeri benzersiz şekilde tanımlar.
https://www.google.com/maps/search/?api=1&query=7-Elevan&query_place_id=ChIJGcmcg7ZC1moRAOacd3HoEwM
Burada ChIJGcmcg7ZC1moRAOacd3HoEwM, belirli bir yerin benzersiz yer kimliğidir. query parametresi hâlâ gereklidir ancak yalnızca Google Haritalar yer kimliğini bulamazsa kullanılır.
Senaryo 4: Enlem ve boylam koordinatlarının yanı sıra yer kimliğini kullanarak yer ayrıntılarını gösterme
Yer kimliği kullanıldığında Google Haritalar'da ayrıntılı yer bilgileri gösterilir.
https://www.google.com/maps/search/?api=1&query=-33.8567%2C151.2152&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE
Yer kimliklerini ücretsiz olarak alma
Yer kimliklerini programatik olarak almak için Places API: Text Search(ID Only) işlevini kullanabilirsiniz. Bu yöntem, yer kimliklerini ücretsiz olarak edinmenizi sağlar. Yer Kimliği ve Yer API'si(Yeni) isteği hakkında daha fazla bilgi edinin.
Places API Metin Arama(Yalnızca Kimlik) İsteği:
curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: places.id'
'https://places.googleapis.com/v1/places:searchText'Places API Metin Arama(Yalnızca Kimlik) Yanıtı:
{
"places": [
{
"id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
}
]
}Kullanıcı haritalarda bir ÖY'yi tıkladığında veya ÖY'ye dokunduğunda da yer kimlikleri alınabilir. Tıklanabilir ÖY simgeleri hakkında daha fazla bilgi edinin(JavaScript, Android, iOS)
Sonuç
Doğru yer ayrıntıları sağlamak, olumlu bir deneyim için çok önemlidir. Kullanıcıların doğru yer ayrıntıları sayfasına yönlendirilmesini sağlamak için arama URL'lerini aşağıdaki önerilen biçimlerden birini kullanarak oluşturun:
query=PLACE_NAME, ADDRESSquery=PLACE_NAME&query_place_id=PLACE_ID
Amacınız belirli bir yerin ayrıntılarını göstermekse query parametresinde yalnızca enlem/boylam koordinatlarını kullanmaktan kaçının. query=latitude,longitude, query=PLACE_NAME,latitude,longitude veya query=ADDRESS,latitude,longitude gibi biçimler, her zaman istenen yer ayrıntıları sayfasına yönlendirmez. Bunun yerine, konumun enlemi ve boylamı gösterilir.
Haritalar URL'lerini kullanarak kategorik arama
Kategorik aramada genel bir arama terimi iletirsiniz ve Google Haritalar, belirttiğiniz konumun yakınında ölçütlerinize uyan listelemeler bulmaya çalışır. Konum belirtilmemişse Google Haritalar, geçerli konumunuzun yakınındaki listelemeleri bulmaya çalışır.
1. senaryo: Yakındaki yerleri arama
https://www.google.com/maps/search/?api=1&query=Cafe%20near%20Sydney%20Opera%20House%20that%20are%20open%20now
Haritalar URL'lerini kullanarak yol tarifi sağlama
Yol tarifi işlevi, haritada belirtilen iki veya daha fazla nokta arasındaki yolu, mesafeyi ve seyahat süresini gösterir. Geliştiricilere, sağlanan talimatlar üzerinde daha fazla kontrol olanağı sunar. GMP'nin Haritalar URL'leri Yol Tarifleri dokümanında, özelleştirilmiş yol tarifleri için URL oluşturmayla ilgili ayrıntılı talimatlar yer alır.
Yol tarifi URL'sinin yapısı:
https://www.google.com/maps/dir/?api=1¶meters
1. Senaryo: Kullanıcının mevcut konumundan bir hedefe giden en iyi rotayı bulma
https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving
Bu URL, Google Haritalar'ı açar ve kullanıcının mevcut konumundan araba yol tarifini gösterir.
Bu URL'de origin atlanmıştır. origin atlandığında, varsa cihaz konumu gibi en alakalı başlangıç konumu varsayılan olarak kullanılır.
Hiçbiri yoksa sonuçta elde edilen harita, kullanıcının başlangıç noktasını girmesine olanak tanıyan bir form sağlar.
Başlangıç ve hedef değeri; yer adı, adres veya virgülle ayrılmış enlem/boylam koordinatları olabilir.
travelmode isteğe bağlı bir parametredir. Seyahat yöntemini tanımlar.
Bu parametre şu şekilde ayarlanabilir:
- araba yolculuğu
- yürüyüş
- bisiklet
- iki tekerlekli araç
- toplu taşıma
Seyahat modu belirtilmemişse Google Haritası, belirtilen rota ve/veya kullanıcı tercihlerine en uygun bir veya daha fazla modu gösterir.
Geliştiriciler, origin_place_id parametresini ve
destination_place_id kullanarak yer kimliklerini de belirtebilir. Yer kimliği kullanmak, doğru yere bağlantı vereceğinizin en iyi garantisidir.
Yer kimliklerini ücretsiz olarak alma
Yer kimliklerini programatik olarak almak için Places API: Text Search(ID Only) işlevini kullanabilirsiniz. Bu yöntem, yer kimliklerini ücretsiz olarak edinmenizi sağlar. Yer Kimliği ve Yer API'si(Yeni) isteği hakkında daha fazla bilgi edinin.
Places API Metin Arama(Yalnızca Kimlik) İsteği:
curl -X POST -d '{"textQuery" : "Sydney Opera House"}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: places.id'
'https://places.googleapis.com/v1/places:searchText'Places API Metin Arama(Yalnızca Kimlik) Yanıtı:
{
"places": [
{
"id": "ChIJ3S-JXmauEmsRUcIaWtf4MzE"
}
]
}Kullanıcı haritalarda bir ÖY'yi tıkladığında veya ÖY'ye dokunduğunda da yer kimlikleri alınabilir. Tıklanabilir ÖY simgeleri hakkında daha fazla bilgi edinin(JavaScript, Android, iOS)
Senaryo 3: Adım Adım Navigasyon Sağlama
https://www.google.com/maps/dir/?api=1&destination=Flinders%20Station%20Melbourne&travelmode=driving&dir_action=navigate
URL'de dir_action=navigate değerini ayarlamak, kullanıcının geçerli konumu(cihaz konumu) mevcutsa ve kaynak olarak kullanılıyorsa (açıkça sağlanmış veya kaynak parametresi atlandığında dolaylı olarak kullanılmışsa) Google Haritalar'ı adım adım navigasyon modunda başlatır. Aksi takdirde, rota önizlemesi gösterilir.
dir_action=navigate ayarlandığında ve şu şekilde olduğunda adım adım navigasyon başlatılır:
- Köken belirtilir ve kullanıcının mevcut konumuna yakındır
- Köken belirtilmemiş ve kullanıcının mevcut konumu mevcut
Rota önizlemesi şu durumlarda başlatılır:
dir_action=navigateayarlanmadıdir_action=navigateayarlanmış ve kaynak belirtilmiş ancak kaynak, kullanıcının mevcut konumuna yakın değilsedir_action=navigateayarlandı ve köken atlandı ve kullanıcının geçerli konumu mevcut değil
Navigasyonun Google Haritalar Web gibi tüm Google Haritalar ürünlerinde ve/veya tüm varış noktaları arasında mevcut olmadığını unutmayın. Bu durumlarda bu parametre dikkate alınmayacaktır.
 |
 |
Sonuç
Haritalar URL'lerini doğru şekilde oluşturarak kullanıcıların ihtiyaç duydukları doğru bilgilere hızlı ve verimli bir şekilde ulaşmasını sağlayabilirsiniz.
Hedefi her zaman belirtin ve doğruluğu garanti etmek için mümkün olduğunda yer kimliği kullanın.
Hedef, anında gezinme sağlamaksa adım adım yol tarifini tetiklemek için dir_action=navigate parametresini ekleyin. Cihaz konumu mevcutsa ve başlangıç noktası olarak kullanılıyorsa (açıkça ayarlanmış veya atlanmış) navigasyon kullanıcının mevcut konumundan başlar.
Uygulamanız için doğru yaklaşımı seçme
İki temel seçeneğiniz vardır: Places API tarafından sağlanan önceden biçimlendirilmiş URL'lerden yararlanma veya uygulamanızda Haritalar URL'lerini manuel olarak oluşturma. Her yaklaşımın kendine özgü avantajları ve dezavantajları vardır.
Places API:
Yer Ayrıntıları yanıtındaki
googleMapsUrivegoogleMapsLinksalanları kullanıma hazır URL'ler sağlar. Bu, geliştirme süresini kısaltır ve URL biçimlendirmesindeki hata riskini en aza indirir.Yol tariflerinin yapılandırılması üzerinde daha az kontrol sağlar.
googleMapsLinkstemel yol tarifleri sunsa da ara noktaları veya gelişmiş özelleştirmeyi desteklemez. Ayrıca, adım adım navigasyonu doğrudan tetiklemek de nispeten daha az kolaydır.
Haritalar URL'leri:
Daha fazla esneklik ve kontrol sunar. Geliştiriciler, yer ayrıntılarını göstermek için URL'ler oluşturabilir ve yol tariflerinin çeşitli yönlerini (ör. ara noktalar ekleme, seyahat modlarını belirtme ve adım adım navigasyonu başlatma) yapılandırabilir.
URL parametreleri ve yapısı hakkında daha ayrıntılı bilgi sahibi olmanız gerekir. Dikkatli yapılmadığı takdirde manuel oluşturma, hata olasılığını artırır.
UTM parametreleriyle Haritalar URL'lerini iyileştirme
Google'ın, geliştiricilerin Haritalar URL'lerini nasıl entegre ettiğini daha iyi anlamasına ve optimum performans sağlamasına yardımcı olmak için URL oluşturma sürecinize UTM izleme parametrelerini eklemenizi öneririz. utm_source ve utm_campaign parametrelerini ekleyerek, kullanım kalıplarını analiz etmemize ve Haritalar URL'leri ürününü iyileştirmemize olanak tanıyan değerli veriler sağlarsınız.
utm_source parametresi için uygulamanızın adını kullanın.
utm_campaign parametresi, kullanıcının amaçladığı işlemi (ör. "location_sharing", "place_details_search" veya "directions_request") yansıtmalıdır.
Örneğin, UTM parametreleri içeren bir URL şu şekilde görünebilir:
https://www.google.com/maps/search/?api=1&query=Sydney+Opera+House&query_place_id=ChIJ3S-JXmauEmsRUcIaWtf4MzE&utm_source=YourAppName&utm_campaign=place_details_search
Bu parametreleri tutarlı bir şekilde kullanmak, iyileştirilebilecek alanları belirlememize, sorunları daha etkili bir şekilde gidermemize ve sonuç olarak tüm kullanıcılara daha iyi bir deneyim sunmamıza yardımcı olur.
Sonraki Adımlar
Daha fazla bilgi için önerilen kaynaklar:
Katkıda bulunanlar
Başlıca yazarlar:
Teresa Qin | Google Haritalar Platformu Çözüm Mühendisi