Directions API'ye genel bakış

Directions API, HTTP isteğini kabul eden ve konumlar arasında JSON veya XML biçimli yol tarifleri döndüren bir hizmettir.

Yol Tarifi API'sini neden kullanmalısınız?

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.
  • Metin dizeleri (örneğin "Chicago, IL" veya "Darwin, NT, Australia"), yer kimlikleri ya da enlem/boylam koordinatları dahil olmak üzere başlangıç noktalarını, hedefleri ve ara noktaları birden çok yöntemle belirtin.

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, Directions API üzerinden kullanılabilen kaynaklar döndürdüğü verilerle birlikte özetlenmektedir.

Veri kaynakları Döndürülen veriler İade biçimi
Yol tarifi

Kalkış 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, bacaklara 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.
  • JSON
  • XML

Directions API nasıl kullanılır?

1 Kurulum yapın. Google Cloud projenizi oluşturun bölümüne geçin ve sonraki kurulum talimatlarını tamamlayın.
2 Demoyu deneyin API anahtarınız ve bulut projeniz olduktan sonra, yol tarifi demosunu ücretsiz olarak deneyebilirsiniz. Directions API demosunu inceleyin.
3 İstek oluşturma Örnek istekleri inceleyin ve sunabileceğiniz ulaşım şekilleri, ara noktalar ve rota kısıtlamaları gibi seçenekler hakkında bilgi edinin. Yol tarifi örneklerini inceleyin.
4 Yanıtlarla ilgili temel bilgileri 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:

Java İstemcisi, Python İstemcisi, Go İstemcisi ve Google Haritalar Hizmetleri için Node.js İstemcisi, Apache 2.0 Lisansı kapsamında açık kaynaklı, topluluk tarafından desteklenen istemci kitaplıklarıdır. Bu uygulamaları GitHub'dan indirin. Burada yükleme talimatlarını ve örnek kodu da bulabilirsiniz.

Sırada ne var?