Directions API'yi kullanma
Directions API ile toplu taşıma, araba, yürüyüş veya bisiklet gibi çeşitli ulaşım modları için yol tarifi alabilirsiniz.
Directions API ile neler yapabilirsiniz?
Directions API ile konumlar arasındaki yol tariflerini aşağıdaki ayrıntıları da içerecek şekilde hesaplayabilirsiniz:
- Toplu taşıma, araba, yaya veya bisiklet gibi çeşitli ulaşım yöntemleri için yol tarifleri.
- Bir dizi yol noktası kullanan çok parçalı yol tarifleri.
- Başlangıç noktalarını, varış noktalarını ve yol noktalarını metin dizeleri (ör. "Chicago, IL" veya "Darwin, NT, Avustralya"), yer kimlikleri ya da enlem/boylam koordinatları dahil olmak üzere birden çok şekilde belirtebilirsiniz.
Directions API'nin işleyiş şekli
Directions API, yol tariflerini hesaplarken en verimli rotaları döndürür. Ürün, en verimli rotayı belirlerken aşağıdaki seyahat öğelerini dikkate alır:
- Seyahat süresi (birincil)
- Mesafe
- Dönüş sayısı
Aşağıdaki örnek istek, Toronto, Ontario'dan Montreal, Quebec'e giden sürüş talimatlarını JSON biçiminde döndürür:
https://maps.googleapis.com/maps/api/directions/json ?destination=Montreal &origin=Toronto &key=YOUR_API_KEY
Kaynaklar
Aşağıdaki tabloda, Dönüşümler API'si aracılığıyla kullanılabilen kaynaklar ve döndürdüğü veriler özetlenmiştir.
Veri kaynakları | Döndürülen veriler | Dönüş biçimi |
---|---|---|
Yol tarifi
Başlangıç ve varış noktalarını yer kimlikleri, adresler veya enlem/boylam koordinatları biçiminde sağlayın. Ayrıntılar için gerekli parametrelere bakın. |
Rotalara, aşamalara ve adımlara ayrılmış ayrıntılı yol tarifleri. Ayrıntılar için Yol tarifi yanıtları bölümüne bakın. |
|
Directions API'yi kullanma
1 | Kurulum yapın. | Google Cloud projenizi oluşturma ile başlayın ve sonraki kurulum talimatlarını uygulayın. |
2 | Demoyu deneyin | API anahtarınız ve bulut projeniz olduğunda, yol tarifi demosunu ücretsiz olarak deneyebilirsiniz. Directions API demosunu inceleyin. |
3 | İstek oluşturma | Örnek isteklere göz atın ve seyahat modları, yol işaretleri ve rota kısıtlamaları gibi sağlayabileceğiniz seçenekler hakkında bilgi edinin. Yol tarifi örneklerini inceleyin. |
4 | Yanıtların temel özelliklerini anlama | Uygulamanızda yol tarifi verilerini kullanmaya hazırlanmak için veri yanıtlarını keşfedin. Ayrıntılar için Yol tarifi yanıtları bölümüne bakın. |
5 | Yön verilerini kendi uygulamanıza ekleyin. | Seyahat mesafesini ve süresini hesaplamak için bu verileri kullanabilirsiniz. |
Kullanılabilir istemci kitaplıkları
Aşağıdaki istemci kitaplıklarından birini kullanarak bu API'yi istediğiniz dilde çağırın:
- Google Haritalar Hizmetleri için Java istemcisi
- Google Haritalar Hizmetleri için Python istemcisi
- Google Haritalar Hizmetleri için Go Client
- Google Haritalar Hizmetleri için Node.js istemcisi
Google Haritalar Hizmetleri için Java İstemcisi, Python İstemcisi, Go İstemcisi ve Node.js İstemcisi, Apache 2.0 Lisansı kapsamında açık kaynaklı olan, topluluk tarafından desteklenen istemci kitaplıklarıdır. Bunları GitHub'dan indirebilirsiniz. GitHub'da kurulum talimatlarını ve örnek kodu da bulabilirsiniz.
Sırada ne var?
- Directions API'yi kullanmaya başlama: Başlayın başlıklı makaleyi inceleyin.
- Yol tarifi isteği göndermeye başlama: Yol tarifi alma bölümüne gidin.
- En iyi uygulamaları takip edin: Web hizmetiyle ilgili en iyi uygulamalar başlıklı makaleyi inceleyin.