Hesaplama Rota Matrisine Genel Bakış

Rota Matrisi Hesapla, Routes API hizmetinde bir HTTPS isteğini kabul eden ve farklı başlangıç ve varış konumları arasındaki rota matrisi için mesafeleri ve seyahat sürelerini döndüren bir yöntemdir. 625'e kadar rota öğesi için birden fazla hedefin seyahat sürelerini ve mesafelerini hesaplayın.

Arabayla Yol Tarifi mi Arıyorsunuz? Rota yol tarifleriyle ilgileniyorsanız Compute Rotalarına Genel Bakış başlıklı makaleyi inceleyin.

Taşıma işlemi mi yapıyorsunuz? Distance Matrix API'den (eski) geçiş yapıyorsanız Rotalar API'ye neden geçiş yapmalısınız? başlıklı makaleden itibaren geçiş talimatlarını inceleyin.

Compute Route Matrix'i neden kullanmalısınız?

Hesaplama Rota Matrisi ile, sevkiyat planlaması için en verimli rotaları belirleyebilirsiniz. Örneğin:

  • Bir dizi paketi almak için bir grup işçiyi en iyi şekilde atama

  • Paketlerin son varış noktasına gönderileceği en iyi depoyu belirleme

Hesaplanmış rota matrisi ile neler yapabilirsiniz?

Hesapla Rota Matrisi ile birçok başlangıç ve bitiş konumu arasında olası rotaların matrisini alabilirsiniz. Sunucu tarafı istek başına birden fazla kaynak ve hedef belirtebilirsiniz. Bu durumda, kaynak sayısı ile hedef sayısının çarpımı 625'i aşmamalıdır. Matrisin tamamı hesaplanmadan önce yanıtın öğelerini aktararak yanıt gecikmesini azaltabilirsiniz.

Yolcuları, kargoları veya çalışanları birden fazla başlangıç ve varış noktası arasında yönlendirmenin en verimli yolunu belirlemek için aşağıdaki rota verilerini isteyebilirsiniz:

  • Seçilen seyahat şekli için kilometre veya mil cinsinden mesafe

  • Trafikte tahmini seyahat süresi

Rota matrisini hesaplama işlevinin işleyiş şekli

ComputeRouteMatrix yöntemi, istek ayrıntılarını içeren bir JSON istek gövdesi içeren bir HTTP POST isteğini kabul eder. En az bir başlangıç noktası, iki veya daha fazla varış noktası, seyahat modu ve döndürülecek alanları belirtmek için bir alan maskesi gereklidir.

Örnek

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.403184,
            "longitude": -122.097371
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.383047,
            "longitude": -122.044651
          }
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

Yanıt, tüm kaynak ve hedef yol noktalarının kombinasyonu için olası rotaları içerir.

Kaynaklar

Aşağıdaki tabloda, Routes API Compute Route Matrix yöntemi aracılığıyla kullanılabilen kaynaklar ve döndürdüğü veriler özetlenmiştir.

Veri kaynakları Döndürülen veriler Dönüş biçimi
ComputeRouteMatrix Bir başlangıç yol işaretinden bir varış yol işaretine giden rota dizisi döndürür. JSON

Compute Route Matrix'i kullanma

1 Kurulum Google Cloud projenizi oluşturma ile başlayın ve sonraki kurulum talimatlarını tamamlayın.
2 Routes API'nin nasıl faturalandırdığını anlama Bilgi için Kullanım ve faturalandırma başlıklı makaleyi inceleyin.
3 Rota matrisini hesaplama ve yanıtı inceleme Daha fazla bilgi için Rota matrisi alma ve Rota matrisi yanıtını inceleme başlıklı makaleleri inceleyin.

Kullanılabilir istemci kitaplıkları

Compute Route Matrix için kullanılabilen istemci kitaplıklarının listesi İstemci kitaplıkları bölümünde verilmiştir.

Sırada ne var?