Distance Matrix API (Eski), her bir çift arasındaki önerilen rotaya göre başlangıç ve varış noktaları matrisi için seyahat mesafesini ve süresini döndüren bir web hizmetidir. Seyahat modunu (sürüş, yürüme, bisiklet, toplu taşıma), toplu taşıma modlarını, birimleri ve trafiğe dayalı süreler için kalkış saatini ayarlayabilirsiniz. JSON veya XML döndürür.
Distance Matrix API: Temel bilgiler
- Ürün: Distance Matrix API
- Diğer adları: Distance Matrix API (Eski), Distance Matrix (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ış: Distance Matrix API'ye genel bakış
Distance Matrix API: Ne zaman kullanılır?
Distance Matrix API'yi şu durumlarda kullanın:
- Distance Matrix API'nin (eski) etkin olduğu ve
/maps/api/distancematrixyöntemini çağıran mevcut bir projeyi yönetiyorsunuz. - Bir sunucudan birden fazla başlangıç noktası ile birden fazla hedef arasındaki seyahat mesafesini ve süresini öğrenmeniz gerekir.
departure_timeve isteğe bağlı olaraktraffic_modelkullanarak sürüş için trafikteki süreleri öğrenmeniz gerekir.
Distance Matrix API'yi şu durumlarda kullanmayın:
- Yeni bir Google Cloud projesi başlatıyorsunuz. Ekim 2026'dan itibaren Distance Matrix API (Eski) yeni projeler için etkinleştirilemeyecek. Bunun yerine Routes API'yi kullanın.
- Yeni özelliklere veya akış yanıtları içeren en fazla 625 öğelik bir rota matrisine (
computeRouteMatrix) ihtiyacınız varsa Routes API'yi kullanın. - Yalnızca mesafe ve süre değerleri değil, noktalar arasında adımlar ve çoklu çizgiler içeren tam bir rotaya ihtiyacınız vardır. Bunun yerine Routes API'yi kullanın.
Distance Matrix API: kurulum
- Etkinleştirilecek hizmet:
distance-matrix-backend.googleapis.com - Kimlik doğrulama: API anahtarı
- Başlayın: Distance Matrix API'yi ayarlama
- Referans: Distance Matrix API referansı
- Fiyatlandırma: Distance Matrix API kullanımı ve faturalandırması
- Politikalar: Distance Matrix API politikaları
- Sürüm notları: Distance Matrix API sürüm notları
Distance Matrix API: Sık yapılan hatalar
- Sorun: Her sunucu tarafı isteği 100 öğe (başlangıç noktaları × varış noktaları) ve 25 başlangıç noktası veya 25 varış noktası ile sınırlıdır. Daha büyük istekler
MAX_ELEMENTS_EXCEEDEDveyaMAX_DIMENSIONS_EXCEEDEDdöndürür. Düzeltme: Matrisi en fazla 100 öğe ve 25 başlangıç noktası veya hedef içeren isteklere bölün. /maps/documentation/distance-matrix/usage-and-billing#usage-limits adresini inceleyin. - Sorun:
departure_timedeğerini belirtmezseniz rota ve süre, zamandan bağımsız ortalama trafiğe göre belirlenir veduration_in_trafficdöndürülmez. Sonuçlar zaman içinde değişiklik gösterebilir. Düzeltme: Trafiğe duyarlı süreler elde etmek içindeparture_timedeğerininowveyamode=drivingile gelecekteki bir zamana ayarlayın. Trafik isteklerinin daha yüksek bir ücretle faturalandırıldığını unutmayın. /maps/documentation/distance-matrix/distance-matrix adresini inceleyin. - Sorun:
unitsparametresi yalnızca mesafe alanlarındaki metni değiştirir. Mesafe değeri her zaman metre cinsindendir. Düzeltme:distance.valueifadesini metre olarak okuyun veya görüntülemek içindistance.textifadesini kullanın. /maps/documentation/distance-matrix/distance-matrix adresini inceleyin. - Sorun: Distance Matrix API'yi (Eski) etkinleştirilmediği bir projeden çağırmak,
statusiçindeREQUEST_DENIEDveLegacyApiNotActivatedMapErrorbağlantısı içeren birerror_messagedöndürür. Yapay zeka asistanları genellikle varsayılan olarak eski API kodu oluşturur. Düzeltme: Routes API'ye geçiş yapıncomputeRouteMatrix(X-Goog-FieldMasküstbilgisiyle). Eski API'yi form aracılığıyla yalnızca kısa vadeli bir önlem olarak etkinleştirin. /maps/legacy#LegacyApiNotActivatedMapError sayfasına bakın.