Directions API'ye genel bakış

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

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.
  • JSON
  • XML

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 İ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?