Genellikle, kullanıcı bir önemli yere (ÖY) giderken, aslında otopark veya erişim noktası gibi yakındaki bir yere gitmesi gerekir. Havaalanına veya alışveriş merkezine gitmesi gereken bir sürücü düşünün. Sürücü, havaalanına giderken havaalanı kompleksinin merkezi yerine bir terminale veya bırakma noktasına ulaşmaya çalışıyor. Benzer şekilde, alışveriş merkezinin yanında yer alan park yeri, arabası olan bir kullanıcı için çok daha iyi bir seçenek olabilir. Bu durumda, sürücüye rehberlik etmek için bir uygulama veya hizmet geliştirirken öncelikle gidecekleri konumu bulun ve ardından sürücüye o konumun yakınındaki isteğe bağlı hedefleri sunun. Bu yaklaşım, Google Haritalar Platformu tarafından sağlanan konum verilerinden yararlanan küçük ama akıllıca bir geliştirme çalışmasıyla müşterilerinize daha iyi hizmet sağlamanıza ve müşterilerinizin vaktine değer verdiğinizi göstermenize olanak tanır.
Hedefinizin yanına park edilecek doğru konumu belirlemek için Places API ve Directions API'yi sırayla veya kombinasyon halinde nasıl kullanabileceğinizi göstereceğiz. Bu çözüm, varış noktasına bir kez daha yaklaşırken park yeri bulmak için belirsizliği ve birden fazla etkileşimi ortadan kaldırmayı amaçlar. Bu durumların nasıl ayrıntılı olarak uygulanabileceğine ilişkin iki örneği inceleyelim.
1. örnek: otoparkı olmayan turistik yer
Doğrudan yol kenarına bağlı olmayan bir konum seçelim; böylece bir rotanın ayrı ayrı alınması gerekir. Varış noktası Paris'teki Notre Dame'dir ve başlangıç noktası olarak Gare de l’Est tren istasyonunu (48.87697775149635, 2.359224780467555) kullanalım.
Sürücü, Notre Dame'ın yaklaşık 16 dakika kuzeyinde istasyondan ayrılıyor. Notre Dame, bir adada köprü erişimi olan, birkaç tek yönlü sokaklara sahip ve yakınlarda geniş bir park yeri olmayan ünlü bir turistik yer. Bu nedenle bu, sizin için ilginç bir zorluk olabilir.
Places API isteği
Bu örnek Places API isteği, Notre Dame'ı bulmak için "metin arama" özelliğini kullanmaktadır. Ayrıntılar için geliştirici belgelerine göz atın. Bu örneklerdeki "YOUR_KEY", Google Cloud Console'da etkinleştirilen Google Haritalar Platformu Yerler ve Yol Tarifi API'leri için sahip olduğunuz API anahtarıdır. Daha ayrıntılı bilgi için lütfen Google Haritalar Platformu'nu kullanmaya başlama belgelerine bakın.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=notre_dame&location=48.864716%2C2.349014®ion=fr&key=YOUR_KEY
Yukarıdaki isteğe verilen yanıtta aşağıdaki enlem ve boylam koordinatları sağlanır:
"results" : [ { "formatted_address" : "Notre Dame, Paris", "geometry" : { "location" : { "lat" : 48.8527288, }, ...
Gördüğünüz gibi, koordinatlar Notre Dame'ın yerini almıştır.
|
|
Bir geliştirici veya servis sağlayıcı olarak, sürücüye otomatik olarak "Notre Dame yakınında park yeri mi arıyorsunuz?" sorusunu sormak iyi bir fikirdir. Kullanıcı deneyimi cihaza ve ekrana göre değişir, ancak bu durumda kısa bir süre sonra kaybolan ince bir pop-up metni göz önünde bulundurulmalıdır. Notre Dame yakınında park yeri bulmak için "parking" türü ve yarıçap "300" parametreleri ayarlanmış olarak Places API metin araması yapın. Bu örnek, sonuçları Notre Dame'ın 300 metre içindeki park alanlarına ağırlık verir.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=parking
&location=48.8527288%2C2.3505635®ion=fr&type=parking&radius=300&key=YOUR_KEY
İlk sonuç, 48.850591, 2.3486436 adresindeki “Parking Saemes Maubert-Lagrange”. Bu konumu, Directions API isteği yaptığımız bir sonraki bölümde kullanalım.
Directions API isteği
İstasyondan Notre Dame'ın yakınındaki park alanına giden rotayı bulmak için Directions API isteği yapmanız gerekir. Başlangıç ve hedef parametrelerini ayarlamanız yeterlidir. Diğer seçenekler için geliştirici belgelerine bakın.
https://maps.googleapis.com/maps/api/directions/json?origin=48.8767903,2.3592251&destination=48.850591%2C2.3486436&key=YOUR_KEY
Direction API yanıtı genellikle birden fazla rota önerisi içerir. Her rota birden fazla "bacak"tan oluşur ve rota, seyahat mesafesini ve koordinatlarını gösteren birden çok "adım" içerir. Arabayla ulaşılabilecek nihai koordinatları bulmak için seçtiğiniz rotadaki son ayağın son adımının "end_location" alanını kullanın.
Bu konum ilk tercihiniz olmayabilir, ancak haritaya veya Google Street View'a baktığınızda bu konumun Notre Dame'a çok kısa bir yürüme mesafesinde, yaklaşık 6-7 dakika uzaklıkta olduğunu göreceksiniz.
Otopark alanından Notre Dame'a yürüyüş rotası
Örnek 1
Gördüğünüz gibi, bir araba için park yeri bulmak için sadece birkaç API çağrısı yeterli ve önerinin sürücüye gösterilmesi yeterli. Böylece kullanıcılarınız tek yönlü sokaklarda araba kullanmadıkları veya kalabalık bir turistik yerde arabalarını bırakacak bir yer aramaya çalıştıkları için zamandan tasarruf edebilir. Özet olarak, aşağıdaki API isteklerini gerçekleştirdik:
- Notre Dame koordinatlarını bulmak için Places API isteği
- Bu koordinatlara en fazla 300 metre uzaklıktaki bir park yeri bulmak için yapılan Places API isteği
- Park yerine rota bulmak için Directions API isteği
Örnek 2 - Büyük bir havaalanındaki bir terminale yönlendirme
"types" : [ "airport", "point_of_interest", "establishment" ],
Ancak büyük bir havaalanını ziyaret eden herkes, yanlış yere vardığınızda terminaller arasında transfer yapmanın önemli bir zaman aldığını bilir. Bu durumda, arama sonucu türü "havaalanı" olduğundan, otomatik olarak bir takip sorgusu izleyerek Londra fundalığı havaalanının konumunu (51.47016927594547, -0.45432767852489075) kullanarak "terminal" araması yapmak yararlıdır. Örnekte, 3000 metrelik arama yarıçapı ile ilgili isteğe bağlı sınırlamayı da görebilirsiniz.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=terminal&location=51.47016927594547%2C-0.45432767852489075®ion=gb&key=YOUR_KEY&radius=3000
Yukarıdaki sorgu, terminallerin ve bu terminallerdeki ayrı bırakma noktalarının bir listesini verir. Sonuç listesinde "London Heathrow Havalimanı Terminal 5" ve yer kimliğini bulabiliriz:
"place_id" : "ChIJtQRd6XVxdkgRTUGZtcsoGNc",
"place_id" parametresini kullanarak, Directions API'sine bazı rastgele koordinatlar yerine bir yere ulaşmaya çalıştığımızı bildirebiliriz.
https://maps.googleapis.com/maps/api/directions/json?origin=51.557263604707224,-0.2794575145680608&destination=place_id:ChIJtQRd6XVxdkgRTUGZtcsoGNc&key=YOUR_KEY
Yine önceki örnekte olduğu gibi, JSON yanıtındaki tüm adımları okuyarak yolculuğun son kısmını ve varış konumlarını enlem ve boylam koordinatlarını (51.47079979999999,-0.4896765) bulursunuz.
Örnek 2
Önceki örnekte olduğu gibi, sürücüye daha iyi rehberlik sağlamak için geliştirme çabası çok azdır ve sürücüye kazandırdığı zamanın avantajları kolayca ölçülür. Aşağıdaki talepleri gerçekleştirdik:
- Heathrow havaalanını bulmak için Places API isteği
- Heathrow havaalanı koordinatlarına yakın tüm terminalleri bulmak için yapılan Places API isteği
- Terminal 5'e rota almak için bir Directions API isteği
Sonuç
Gördüğünüz gibi, otomobille seyahat eden müşterilerinize üstün hizmet sağlamak için gereken geliştirme çabası çok küçüktür ve müşterilerinizin ihtiyaçlarını ne düşündüğünüzü kolayca göstermenize olanak tanır.
Geliştirme amaçlı olarak, müşterileriniz için hizmet geliştirmenize yardımcı olacak kitaplıkların ve araçların birçoğunu kullanabilirsiniz. Herkese açık Google Haritalar Platformu için GitHub depomuza göz atın.
Sonraki İşlemler
Baş yazar
Mikko Toivanen | Google Haritalar Platformu Çözüm Mühendisi