Konum bilincine sahip günümüz dünyasında kullanıcılar yer bilgilerine, yol tariflerine ve navigasyona sorunsuz bir şekilde erişmeyi bekliyor. Kullanıcıların, mesajlaşma uygulaması, yerel bağlam keşfi uygulaması, lojistik ve ulaşım platformu, seyahat planlayıcı veya emlak girişi platformu aracılığıyla sık sık konum ayrıntılarını hızlıca görüntülemesi veya A noktasından B noktasına giden en iyi rotayı bulması gerekir. Geliştiriciler kendi uygulama içi deneyimlerini oluşturabilir ancak Google Haritalar'ın kapsamlı ve tanıdık arayüzünden yararlanarak daha üstün bir deneyim sunabilirler.
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 bağlantının bozulmasına neden olur. Bu durum kullanıcıları hayal kırıklığına uğratır ve hedeflerine ulaşmalarını engeller. Örneğin, geçerli bir Haritalar URL'si kullansa bile belirli bir işletmeyle ilgili ayrıntıları bekleyen kullanıcılar alakalı 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 göre bir konumu 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 Yerler API'si(yeni) ve ücretsiz olan ve anahtar gerektirmeyen Haritalar URL'leri. Aşağıdaki çözümler farklı senaryoları ve kullanım alanlarını ele alır:
GMP Places API'nin(Yeni) 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ını isteğinde bulunurken (alan maskesinde belirterek) 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 Rehber veritabanında ve Google Haritalar'da bir yeri benzersiz bir şekilde tanımlayan metin tabanlı bir tanımlayıcıdır.
Yer kimliklerini ücretsiz olarak alma
Yer kimliklerini programatik olarak almak için Places API: Metin Arama(Yalnızca Kimlik) işlevini kullanabilirsiniz. Bu, yer kimlikleri elde etmek için ücretsiz bir yöntemdir. Yer kimliği ve Place API(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"
}
]
}Yer kimlikleri, kullanıcı haritalarda bir ÖY'yi tıkladığında veya bu ÖY'ye dokunduğunda da alınabilir. Tıklanabilir ÖY simgeleriyle ilgili daha fazla bilgi edinin(JavaScript, Android, iOS)
Uygulama
Geliştiriciler, Places API'yi kullanırken yanıttan googleMapsUri veya googleMapsLinks alanını ayıklayıp ilgili görünümü Google Haritalar uygulamasında veya uygulama yüklü değilse bir tarayıcıda başlatmak için kullanabilir.
| Özellik | Açıklama |
|---|---|
| directionsUri | Kullanıcının mevcut konumundan bu yere giden yol tariflerini görüntülemek için Google Haritalar'ı açan bağlantı |
| placeUri | Google Haritalar'ı bu yerin yer ayrıntıları sayfasında açmaya yönelik bağlantı |
| writeAReviewUri | Google Haritalar'ı bu yerin yorum yazma sayfasına açacak bağlantı |
| reviewsUri | Google Haritalar'ı bu yerin yorumlar sayfasına açacak bağlantı |
| photosUri | Google Haritalar'ı bu yerin fotoğraflar sayfasına açacak 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 resimleri görüntülemek için 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ılabilen harita işlemleri şunlardır:
Arama işlevi, Google Haritalar uygulamasını veya uygulama yüklü değilse tarayıcıda belirli bir yerin iğnesini gösteren bir uygulamayı başlatır ya da genel arama yapar ve sonuçları görüntülemek için bir harita başlatır.
Yol tarifi işlevi, bir Google Haritalar uygulaması başlatır veya uygulama yüklü değilse tarayıcıda noktalar arasındaki yol tarifini görüntüler ya da mobil cihazlar için Google Haritalar'da adım adım yol tarifini etkinleştirir.
Street View panorama işlevi, Street View görüntülerini etkileşimli panoramalar olarak görüntülemek için bir görüntüleyici başlatmanıza olanak tanır.
Daha fazla işlev ve örnek keşfetmek için GMP Haritalar URL'leri geliştirici belgelerini ziyaret edin.
Burada, Haritalar URL'lerinin iki temel işlevini inceleyeceğiz:
Google Haritalar'da yer ayrıntılarını görüntüleme: Bu bölümde, Google Haritalar'da belirli bir konumun ayrıntılarını görüntüleyecek 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ışacağınız da ayrıntılı olarak açıklanmaktadır.
Haritalar URL'lerini kullanarak yol tarifi sağlama: Bu bölümde, birden fazla yol noktası ve adım adım yol tarifi içeren yol tarifleri de 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örüntüleme
Arama işlevi, yer aramasını tamamlamak için query(zorunlu) ve query_place_id(isteğe bağlı) olmak üzere iki parametre alır.
query parametresi tüm arama istekleri için zorunludur. Yer adı, virgül ile ayrılmış enlem/boylam koordinatları veya genel bir arama terimi kabul eder.
Arama URL'si yapısı:
https://www.google.com/maps/search/?api=1¶meters
Senaryo 1: Benzersiz bir yer adı için yer ayrıntılarını görüntüleme
https://www.google.com/maps/search/?api=1&query=Sydney%20Opera%20House
Şimdi de benzersiz olmayan bir ada sahip bir yer düşünün. Yalnızca bu benzersiz olmayan adla arama yaptığınızda ne olur? Sonraki senaryoya bakın.
Senaryo 2: Benzersiz olmayan bir yer adı için yerleri arama
https://www.google.com/maps/search/?api=1&query=7-Eleven
Yer adı benzersiz olmadığından bu URL, görüntü alanındaki yakındaki 7-Eleven konumlarının listesini açar. Kullanıcılar, ayrıntılarını görmek istedikleri belirli bir mağazayı seçebilir.
Konum listesinden kaçınmak ve 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.
Senaryo 3: Benzersiz olmayan bir yer adı için yer ayrıntılarını görüntüleme
Yaygın yer adlarıyla çalışırken basit bir ad araması genellikle konumların listesini döndürür. Belirli bir ayrıntılar sayfasına doğrudan bağlantı oluşturmak için aşağıdaki yöntemlerden birini kullanabilirsiniz:
1. yöntem: Yer adı ve adresle 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ı daraltmanıza ve doğrudan istenen konuma bağlantı oluşturmanıza yardımcı olur.
2. yöntem: Yer kimliğini kullanma
Yer kimlikleri, Google Rehber 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 yine gereklidir ancak yalnızca Google Haritalar yer kimliğini bulamadığı durumlarda kullanılır.
Senaryo 4: Enlem ve boylam koordinatlarının yanı sıra yer kimliğini kullanarak yer ayrıntılarını görüntüleme
Yer kimliği, Google Haritalar'da ayrıntılı yer bilgilerinin gösterilmesini sağlar.
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: Metin Arama(Yalnızca Kimlik) işlevini kullanabilirsiniz. Bu, yer kimlikleri elde etmek için ücretsiz bir yöntemdir. Yer Kimliği ve Place API(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"
}
]
}Yer kimlikleri, kullanıcı haritalarda bir ÖY'yi tıkladığında veya bu ÖY'ye dokunduğunda da alınabilir. Tıklanabilir ÖY simgeleriyle ilgili daha fazla bilgi edinin(JavaScript, Android, iOS)
Sonuç
Olumlu bir deneyim için doğru yer ayrıntıları sağlamak ö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örüntülemekse 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, istenen yer ayrıntıları sayfasına her zaman yönlendirmez. Bunun yerine, konumun enlem ve boylamı gösterilir.
Haritalar URL'lerini kullanarak kategorik arama
Kategorik aramada genel bir arama terimi gönderirsiniz ve Google Haritalar, belirttiğiniz konumun yakınında ölçütlerinizle eşleşen girişleri bulmaya çalışır. Belirtilen bir konum yoksa Google Haritalar, geçerli konumunuzun yakınındaki girişleri bulmaya çalışır.
Senaryo 1: Yakındaki yerler araması
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 iki veya daha fazla belirtilen nokta arasındaki yolu, mesafeyi ve seyahat süresini gösterir. Geliştiricilere, sağlanan talimatlar üzerinde daha fazla kontrol sunar. GMP'nin Haritalar URL'leri ve Yol Tarifleri dokümanında, özelleştirilmiş yol tarifleri için URL oluşturmayla ilgili ayrıntılı talimatlar sağlanır.
Yol tarifi URL'si yapısı:
https://www.google.com/maps/dir/?api=1¶meters
Senaryo 1: 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 arabayla yol tarifini gösterir.
Bu URL'de origin atlanmıştır. origin atlanırsa yol varsayılan olarak en alakalı başlangıç konumuna (varsa cihaz konumu gibi) ayarlanır.
Hiçbiri yoksa oluşturulan harita, kullanıcının kaynağı girmesine olanak tanıyan bir form sağlar.
Başlangıç ve varış değerleri bir 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
Herhangi bir ulaşım şekli belirtilmezse Google Haritalar, belirtilen rota ve/veya kullanıcı tercihleriyle en alakalı bir veya daha fazla ulaşım şeklini gösterir.
Geliştiriciler, origin_place_id parametresini ve
destination_place_id değerini kullanarak yer kimliklerini de belirtebilir. Yer kimliği kullanmak, doğru yere bağlantı oluşturacağınızın en iyi garantisidir.
Yer kimliklerini ücretsiz olarak alma
Yer kimliklerini programatik olarak almak için Places API: Metin Arama(Yalnızca Kimlik) işlevini kullanabilirsiniz. Bu, yer kimlikleri elde etmek için ücretsiz bir yöntemdir. Yer Kimliği ve Place API(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"
}
]
}Yer kimlikleri, kullanıcı haritalarda bir ÖY'yi tıkladığında veya bu ÖY'ye dokunduğunda da alınabilir. Tıklanabilir ÖY simgeleriyle ilgili daha fazla bilgi edinin(JavaScript, Android, iOS)
3. Senaryo: 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 ayarlandığında, kullanıcının mevcut konumu(cihaz konumu) kullanılabilir durumdaysa ve başlangıç noktası olarak kullanılıyorsa (başlangıç noktası parametresi atlanmışsa açıkça sağlanır veya dolaylı olarak kullanılır) Google Haritalar adım adım yol tarifi modunda açılır. Aksi takdirde rota önizlemesi gösterilir.
Adım adım navigasyon, dir_action=navigate ayarlandığında ve aşağıdaki durumlarda başlatılır:
- Başlangıç noktası belirtilmiş ve kullanıcının mevcut konumuna yakın
- Kaynak atlanır ve kullanıcının mevcut konumu kullanılabilir
Rota önizlemesi şu durumlarda başlatılır:
dir_action=navigateayarlanmadıdir_action=navigateayarlanmışsa ve kaynak belirtilmişse ve kaynak, kullanıcının mevcut konumuna yakın değilsedir_action=navigateayarlanır ve kaynak atlanırsa ve kullanıcının mevcut konumu kullanılamıyorsa
Navigasyonun Google Haritalar Web gibi tüm Google Haritalar ürünlerinde ve/veya tüm hedefler arasında kullanılamadığını unutmayın. Bu durumlarda bu parametre yoksayılı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.
Doğruluğu garanti etmek için hedefi her zaman belirtin ve mümkün olduğunda yer kimliğini kullanın
Hedef anında gezinme sağlamak olduğunda, adım adım yol tarifini tetiklemek için dir_action=navigate parametresini ekleyin. Cihaz konumu kullanılabilir durumdaysa ve başlangıç noktası olarak kullanılırsa (açıkça ayarlanmış veya atlanmışsa) 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çimlendirmesinde hata riskini en aza indirir.Yönergelerin yapılandırılması üzerinde daha az kontrol sağlar.
googleMapsLinkstemel yol tarifleri sunsa da yol işaretlerini veya gelişmiş özelleştirmeyi desteklemez. Ayrıca, adım adım yol tarifini doğrudan tetiklemek nispeten daha zordur.
Haritalar URL'leri:
Daha fazla esneklik ve kontrol sunar. Geliştiriciler, yer ayrıntılarını görüntülemek ve yol tariflerinin çeşitli yönlerini (ör. yol noktası ekleme, seyahat modlarını belirtme ve adım adım yol tarifi başlatma) yapılandırmak için URL'ler oluşturabilir.
URL parametreleri ve yapısı hakkında daha ayrıntılı bilgi sahibi olmanız gerekir. Manuel yapılandırma, dikkatli yapılmadığı takdirde hata olasılığını artırır.
Haritalar URL'lerini UTM parametreleriyle iyileştirme
Google'ın, geliştiricilerin Haritalar URL'lerini nasıl entegre ettiğini daha iyi anlamasına yardımcı olmak ve optimum performansı sağlamak için URL oluşturma işleminize UTM izleme parametreleri 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 gerçekleştirmek istediği işlemi yansıtmalıdır (ör. "location_sharing", "place_details_search" veya "directions_request").
Ö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ştirme alanlarını 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
Önerilen daha fazla okuma:
Katkıda bulunanlar
Başlıca yazarlar:
Teresa Qin | Google Haritalar Platformu Çözümleri Mühendisi