Bu dokümanın daha yeni bir sürümü var. Bu sürümde, yeni Yerler API'si ve Rotalar API'sinin nasıl kullanılacağına dair örnekler yer alıyor.
Genellikle kullanıcılar bir ilgi çekici noktaya (POI) giderken aslında bir otopark veya erişim noktası gibi yakındaki bir konuma gitmek için navigasyona ihtiyaç duyarlar. Havaalanına veya alışveriş merkezine gitmesi gereken bir sürücüyü düşünün. Sürücü, havaalanına giderken havaalanı kompleksinin merkezine değil, terminale veya bırakma noktasına ulaşmaya çalışıyor. Benzer şekilde, alışveriş merkezinin yanındaki bir otopark, arabası olan bir kullanıcı için çok daha iyi bir seçenek olabilir. Bu durumda, sürücüye yol gösterecek bir uygulama veya hizmet geliştirirken önce sürücünün gideceği konumu bulun, ardından sürücüye bu konumun yakınında isteğe bağlı hedefler sunun. Bu yaklaşım, Google Haritalar Platformu tarafından sağlanan konum verilerinden yararlanan küçük ancak akıllı bir geliştirme çalışmasıyla müşterilerinize daha iyi hizmet sunmanıza ve onların zamanına değer verdiğinizi göstermenize olanak tanır.
Sürücüyü arabayla bir konuma yönlendirirken kullanılan sistemlerin basitleştirilmiş görünümü

Hedefinize yakın park etmek için doğru konumu belirlemek üzere Places API ve Directions API'yi sırayla veya birlikte nasıl kullanabileceğinizi göstereceğiz. Bu çözüm, sürüş sırasında varış noktasına yaklaştığınızda park yeri bulmak için belirsizliği ve birden fazla etkileşimi ortadan kaldırmayı amaçlar. Bu kullanım alanlarının nasıl uygulanabileceğine dair iki örneği ayrıntılı olarak inceleyelim.
1. örnek: Otoparkı olmayan bir turistik yer
Yol kenarına doğrudan bağlı olmayan bir konum seçelim. Böylece rota ayrı olarak alınmalıdır. Hedef olarak Paris'teki Notre Dame'ı, başlangıç noktası olarak da Gare de l’Est tren istasyonunu (48.87697775149635, 2.3592247806755564) kullanalım.

Sürücü, Notre Dame'ın yaklaşık 16 dakika kuzeyinde istasyondan ayrılıyor. Notre Dame, köprüyle erişilebilen bir adada yer alan ünlü bir turistik cazibe merkezidir. Yakınında tek yönlü bazı sokaklar ve büyük bir otopark bulunmadığından bu, ilginç bir zorluk olacaktır.
Places API isteği
Bu örnek Places API isteğinde Notre Dame'ı bulmak için "metin arama" kullanılmaktadır. Ayrıntılar için geliştirici belgelerine bakın. Bu örneklerdeki "YOUR_KEY", Google Cloud Console'da etkinleştirilen Google Haritalar Platformu Yerler ve Rota API'leri için sahip olduğunuz API anahtarıdır. Daha ayrıntılı açıklama için lütfen Google Haritalar Platformu'nu kullanmaya başlama ile ilgili belgelere 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ı yer alıyor:
"results" : [ { "formatted_address" : "Notre Dame, Paris", "geometry" : { "location" : { "lat" : 48.8527288, }, ...
Gördüğünüz gibi, koordinatlar gerçekten Notre Dame'ı gösteriyor.
![]() |
![]() |
Geliştirici veya servis sağlayıcı olarak, sürücüye "Notre Dame yakınında park yeri mi arıyorsunuz?" şeklinde otomatik olarak istem göndermeniz iyi bir fikir olabilir. Kullanıcı deneyimi cihaza ve ekrana göre değişir ancak kısa süre sonra kaybolan küçük bir pop-up metin bu durumda dikkate alınabilir. Notre Dame yakınında park yeri bulmak için türü "parking" ve yarıçapı "300" parametreleri ayarlanmış bir Places API metin araması yapın. Bu örnek, sonuçları Notre Dame'dan 300 metre uzaklıktaki otopark alanlarına göre şekillendirir.
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 konumundaki "Parking Saemes Maubert-Lagrange"dir. Yol Tarifi API'si isteği yaptığımız sonraki bölümde bu konumu kullanalım.
Directions API isteği
İstasyondan Notre Dame'a yakın bir park alanına giden rotayı bulmak için Directions API isteği göndermeniz gerekir. Yalnızca kaynak ve hedef parametrelerini ayarlayın. 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 "etaptan" oluşur. Bu etaplar da seyahat mesafesini ve koordinatlarını gösteren birden fazla "adımı" içerir. Arabayla ulaşılabilen son 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 gibi görünmeyebilir ancak haritaya veya Google Sokak Görünümü'ne baktığınızda bu konumun Notre Dame'a çok kısa bir yürüme mesafesinde (yaklaşık 6-7 dakika) olduğunu göreceksiniz.

Otoparktan Notre Dame'a giden yürüyüş yolu
1. örnek için özet
Gördüğünüz gibi, araba için park alanı bulmak yalnızca birkaç API çağrısı ve sürücüye öneriyi göstermeyi gerektirir. Bu sayede kullanıcılarınız tek yönlü caddelerde dolaşmak veya kalabalık bir turistik yerde arabayı bırakacak yer aramak zorunda kalmaz ve zaman kazanır. Özet olarak, aşağıdaki API isteklerini yaptık:
- Notre Dame'ın koordinatlarını bulmak için bir Places API isteği
- Bu koordinatların 300 metre yarıçapındaki bir park alanını bulmak için Places API isteği
- Park alanına giden bir rota bulmak için Directions API isteği
2. örnek: Büyük bir havalimanında terminale yönlendirme

"types" : [ "airport", "point_of_interest", "establishment" ],
Ancak herhangi bir büyük havaalanını ziyaret eden herkes, yanlış yere varırsanız terminaller arasında geçiş yapmanın önemli ölçüde zaman aldığını bilir. Bu durumda, arama sonucunun türü "havaalanı" olduğundan, Londra Heathrow Havaalanı'nın konumunu (51.47016927594547, -0.45432767852489075) kullanarak "terminal" araması yapmak için sorguyu otomatik olarak takip etmek faydalıdır. Örnekte, 3.000 metrelik arama yarıçapı sınırlaması da isteğe bağlı olarak gösterilmektedir.
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 bireysel teslimat noktalarının listesini verir. Sonuç listesinde "London Heathrow Airport Terminal 5" ve yer kimliğini bulabiliriz:
"place_id" : "ChIJtQRd6XVxdkgRTUGZtcsoGNc",
"place_id" parametresini kullanarak Directions API'ye rastgele koordinatlar yerine bir yere ulaşmaya çalıştığımızı söyleyebiliriz.
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 son konumların enlem ve boylam koordinatlarını (51.47079979999999,-0.4896765) bulabilirsiniz.

2. örnek için özet
Önceki örnekte olduğu gibi, sürücüye daha iyi yol tarifi sağlamak için gereken geliştirme çabası çok azdır ve sürücünün zamandan kazandığı faydalar kolayca ölçülebilir. Aşağıdaki istekleri gerçekleştirdik:
- Heathrow Havalimanı'nı bulmak için Places API isteği
- Heathrow Havalimanı koordinatlarına yakın tüm terminalleri bulmak için Places API isteği
- 5. terminale giden bir rota almak için Directions API isteği
Sonuç
Gördüğünüz gibi, arabayla seyahat eden müşterilerinize birinci sınıf hizmet sunmak için gereken geliştirme çabası oldukça küçüktür ve müşterilerinizin ihtiyaçları hakkında nasıl düşündüğünüzü kolayca göstermenizi sağlar.
Geliştirme amacıyla, müşterileriniz için hizmetler oluşturmanıza yardımcı olacak birçok kitaplık ve araçtan yararlanabilirsiniz. Herkese açık Google Haritalar Platformu GitHub depomuza göz atın.
Sonraki İşlemler
Asıl yazar
Mikko Toivanen | Google Haritalar Platformu Çözüm Mühendisi