Directions API'ye (eski) genel bakış

Avrupa Ekonomik Alanı (AEA) geliştiricileri

Directions API (Eski), bir 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 ile toplu taşıma, araba, yaya 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 hesaplayabilir ve aşağıdaki ayrıntıları görebilirsiniz:

  • Toplu taşıma, araba, yaya veya bisiklet gibi çeşitli ulaşım yöntemleri için yol tarifleri
  • Bir dizi ara nokta kullanarak çok parçalı yol tarifleri.
  • Başlangıç noktalarını, varış noktalarını ve ara noktaları metin dizeleri (örneğin, "Chicago, IL" veya "Darwin, NT, Avustralya"), yer kimlikleri ya da enlem/boylam koordinatları gibi çeşitli şekillerde belirtebilirsiniz.

Directions API'nin işleyiş şekli

Yol Tarifi API'si, 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 JSON biçiminde sürüş yol tarifleri 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 ve döndürdüğü veriler özetlenmektedir.

Veri kaynakları Döndürülen veriler Dönüş biçimi
Yol tarifi

Yer kimlikleri, adresler veya enlem/boylam koordinatları biçiminde tedarik kaynakları ve hedefleri. Ayrıntılar için gerekli parametreler konusuna bakın.

Rotalara, ayaklara 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 Ayarları yapın. Google Cloud projenizi oluşturma ile başlayın ve kurulum talimatlarını uygulayın.
2 Demoyu deneyin API anahtarınız ve denemek istediğiniz bir bulut projeniz olduğunda yol tarifi demosunu ücretsiz olarak deneyebilirsiniz. Directions API demosu başlıklı makaleyi inceleyin.
3 İstek oluşturma Örnek isteklere göz atın ve seyahat modları, ara noktalar ve rota kısıtlamaları gibi sağlayabileceğiniz mevcut seçenekler hakkında bilgi edinin. Yol tarifi örneklerine bakın.
4 Yanıtlarla ilgili temel bilgileri öğrenme 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 Yön verilerini kendi uygulamanıza dahil edin. Bu verileri kullanarak seyahat mesafesini ve süresini hesaplayabilirsiniz.

Kullanılabilen istemci kitaplıkları

Bu API'yi aşağıdaki istemci kitaplıklarından birini kullanarak tercih ettiğ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ı olarak sunulan ve topluluk tarafından desteklenen istemci kitaplıklarıdır. Bu kitaplıkları GitHub'dan indirebilirsiniz. GitHub'da kurulum talimatlarını ve örnek kodu da bulabilirsiniz.

Sırada ne var?