Directions API (Eski), arabayla, yürüyerek, bisikletle ve toplu taşımayla yapılan yolculuklar için konumlar arasındaki yol tariflerini (ara noktalar içeren çok parçalı rotalar dahil) hesaplayan ve rotaları, ayakları ve adımları JSON veya XML biçiminde döndüren bir web hizmetidir. Eski durumundadır: Ekim 2026 itibarıyla yeni Google Cloud projeleri için etkinleştirilemez. Routes API'ye geçiş yapın.
Directions API: Temel bilgiler
- Ürün: Directions API
- Diğer adları: Directions API (Eski)
- Kategori: Rotalar
- Platform: Web hizmeti (REST)
- Çalıştığı yer: Sunucu (arka uç kodu)
- Lansman aşaması: GA
- Yaşam döngüsü: Eski
- Yerine geçen API: Routes API
- Genel bakış: Directions API'ye genel bakış
- Kullanılabildiği bölgeler: Dünya geneli. Kapsam, bölgeye ve seyahat moduna göre değişir (toplu taşıma, toplu taşıma sağlayıcılarından alınan verilere bağlıdır). (kapsam ayrıntıları)
Directions API: Ne zaman kullanılır?
Directions API'yi şu durumlarda kullanın:
- Directions API'nin (eski) etkin olduğu ve
maps/api/directionsçağrısı yapan mevcut bir Google Cloud projeniz var. - Mevcut bir projede JSON veya XML biçiminde arabayla, yürüyerek, bisikletle ya da toplu taşımayla (yalnızca toplu taşıma dışı modlar için yol noktaları) yol tarifi almak için sunucu tarafı yol tariflerine ihtiyacınız vardır.
Directions API'yi şu durumlarda kullanmayın:
- Yeni bir Google Cloud projesi başlatıyorsunuz. Ekim 2026'dan itibaren Directions API (Eski) yeni projeler için etkinleştirilemeyecek. Bunun yerine Routes API'yi kullanın.
- Yeni yönlendirme özelliklerine ve daha iyi performansa ihtiyacınız varsa Bunun yerine Routes API'yi kullanın.
- Tek bir istekte birçok başlangıç ve hedef noktası için seyahat sürelerine ve mesafelerine ihtiyacınız varsa. Bunun yerine Routes API'yi kullanın.
Directions API: kurulum
- Etkinleştirilecek hizmet:
directions-backend.googleapis.com - Kimlik doğrulama: API anahtarı
- Başlayın: Directions API'yi ayarlama
- Referans: Directions API referansı
- Fiyatlandırma: Directions API kullanımı ve faturalandırması
- Politikalar: Directions API politikaları
- Sürüm notları: Directions API sürüm notları
Directions API: Sık yapılan yanlışlar
- Sorun: Eski API'nin etkinleştirilmediği bir projeden Directions API'ye (eski) gönderilen istekler
LegacyApiNotActivatedMapErrorhatasıyla başarısız oluyor. Düzeltme: Uygulamanın sahibi sizseniz Routes API'ye geçiş yapın. Geçiş yaparken veya uygulama güncellemesini beklerken kısa vadeli bir çözüm olarak, eski API etkinleştirme formunu doldurarak eski API'yi etkinleştirebilirsiniz. /maps/legacy sayfasına bakın. - Sorun: Ara noktalarda
via:önekini kullanmak, bu noktaları katı geçiş noktaları haline getirir. Bu da ciddi sapmalara veyaZERO_RESULTSdurumuna neden olabilir. Düzeltme: Kesin bir geçiş noktası gerekmiyorsa mola noktaları (via:ön eki olmadan) kullanın. /maps/documentation/directions/get-directions sayfasına bakın. - Sorun: 11 ila 25 yol noktası,
optimize:true, trafiğe duyarlı süreler (duration_in_traffic) veyaside_of_roadya daheadingkonum değiştiricileri içeren istekler, daha yüksek ücretli Directions Advanced (Pro) SKU'su üzerinden faturalandırılır. Düzeltme: Bu özellikleri yalnızca ihtiyacınız olduğunda kullanın. Essentials SKU'sunda kalmak için ara noktaları 10 veya daha az sayıda tutun veoptimize:true,departure_time(sürüş için),side_of_roadveheadingparametrelerini çıkarın. /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku adresini inceleyin. - Sorun: Sürüş için
departure_timegeçmişte olamaz (istekINVALID_REQUESTile başarısız olur).departure_timeolmadan rota ve süre, zamandan bağımsız ortalama trafiği kullanır veduration_in_trafficdöndürülmez. Düzeltme:duration_in_trafficelde etmek içindeparture_timedeğerininowveyamode=drivingile gelecekteki bir zamana ayarlayın.duration_in_trafficdöndüren istekler, Directions Advanced (Pro) SKU'su üzerinden faturalandırılır. /maps/documentation/directions/get-directions sayfasına bakın.