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 aşağıdaki ayrıntılar dahil olmak üzere konumlar arasındaki yol tariflerini hesaplayabilirsiniz:

  • Toplu taşıma, araba, yürüyüş veya bisiklet dahil çeşitli ulaşım modları için yol tarifi.
  • Bir dizi ara nokta kullanarak birden fazla parça içeren yol tarifleri.
  • Metin dizeleri (örneğin "Chicago, IL" veya "Darwin, NT, Australia"), yer kimlikleri veya enlem/boylam koordinatları gibi 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 unsurlarını 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 ü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 Kurulumu tamamlayı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 olduğunda yol tarifi demosunu ücretsiz olarak deneyebilirsiniz. Directions API demosuna bakın.
3 Talep 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 örnekleri bölümüne bakın.
4 Yanıtlarla ilgili temel bilgileri anlama Uygulamanızda yol tarifi verilerini kullanmaya hazırlanmak için 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:

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?