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.

Directions API'yi neden kullanmalısınız?

Directions API'yi kullanarak toplu taşıma, araba, yaya veya bisiklet gibi çeşitli ulaşım modları için yol tarifleri alabilirsiniz.

Directions API ile neler yapabilirsiniz?

Directions API'yi kullanarak konumlar arasındaki yol tariflerini aşağıdaki bilgiler dahil olmak üzere hesaplayabilirsiniz:

  • Toplu taşıma, araba, yaya veya bisiklet dahil olmak üzere çeşitli ulaşım modları için yol tarifleri.
  • Bir dizi ara nokta kullanan çok parçalı yol tarifleri.
  • Başlangıç noktalarını, hedefleri ve ara noktaları metin dizeleri (örneğin, "Chicago, IL" veya "Darwin, NT, Australia"), yer kimlikleri veya enlem/boylam koordinatları da dahil olmak üzere birden çok şekilde belirtin.

Directions API'nin işleyiş şekli

Directions API, yol tarifini 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 arabayla yol tariflerini 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 aracılığıyla kullanılabilen kaynaklar, döndürdüğü verilerle birlikte ö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, bacaklara ve adımlara bölünmüş ayrıntılı yol tarifleri. Ayrıntılı bilgi için Yol tarifi yanıtları sayfasına bakın.
  • JSON
  • XML

Directions API'yi kullanma

1 Hazırlanın. Google Cloud projenizi oluşturma ile başlayın ve aşağıdaki kurulum talimatlarını tamamlayın.
2 Demoyu deneyin API anahtarınız ve bulut projeniz olduğunda yol tarifi demosunu ücretsiz olarak deneyebilirsiniz. Directions API demosuna göz atın.
3 Talep oluşturun Örnek isteklere bakın ve mevcut ulaşım seçenekleri (ör. ulaşım şekilleri, ara noktalar ve rota kısıtlamaları) hakkında bilgi edinin. Yol tarifi örnekleri bölümüne bakın.
4 Yanıtlarla ilgili temel bilgileri anlama Uygulamanız için yol tarifi verilerini kullanmaya hazırlanmak amacıyla veri yanıtlarını inceleyin. Ayrıntılar için Yol tarifi yanıtları bölümüne bakın.
5 Yol tarifi verilerini kendi uygulamanıza ekleyin. Bu verileri, seyahat mesafesini ve süresini hesaplamak için kullanabilirsiniz.

Kullanılabilir istemci kitaplıkları

Aşağıdaki istemci kitaplıklarından biri aracılığıyla 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ı altında açık kaynaklı, topluluk tarafından desteklenen istemci kitaplıklarıdır. Bunları, kurulum talimatlarını ve örnek kodu da bulabileceğiniz GitHub'dan indirin.

Sırada ne var?