Routes API'ye Genel Bakış

Routes API, HTTPS isteğini kabul eden ve iki konum arasındaki ideal rotayı ya da farklı kaynak ve hedef konumlar arasındaki rota matrisi için mesafeleri ve seyahat sürelerini döndüren bir hizmettir.

Routes API'yi kullanmanın avantajları

Routes API ile toplu taşıma ayrıntılarını, güncel trafik ve yol koşullarını ve rota tercihlerini kullanarak doğru rotalar ve gezi bilgileri edinebilirsiniz:

  • Farklı ulaşım modlarının türü ve özellikleri

  • Bir aracın hangi yöne gittiği

  • Araç alma veya bırakma için yolun kenarı

  • Trafik koşulları ve kapalı yollar

  • Tehlikeli bölgelerden kaçınmak veya güvenli teslim alma alanları sağlamak gibi güvenlikle ilgili endişeler

  • Geçiş ücretleri ve zaman, mesafe gibi gezi meta verileri ve yakıt verimliliği gibi isteğe bağlı özelliklerle rota oluşturma ihtiyaçlarınız arasında gecikme, kalite ve maliyet dengesini sağlayın

Ayrıca, sevk planlaması için en verimli rotaları da belirleyebilirsiniz. Örneğin:

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

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

Routes API ile neler yapabilirsiniz?

Routes API ile iki temel yönlendirme bilgileri kategorisi edinebilirsiniz:

  • Tek veya birden fazla varış noktasına bir konumdan giden rotalar

  • Birçok başlangıç ve bitiş konumu arasındaki olası rotaların matrisi.

Tek veya birden çok hedef için rota alma

Routes API Compute Routes yöntemiyle konumlar arasındaki mesafeleri hesaplayabilirsiniz:

  • Farklı seyahat yöntemleri için yol tarifi alın ve tek veya birden fazla hedef için:

    • Toplu taşıma, araba, iki tekerlekli araçlar, yaya veya bisiklet gibi ulaşım yöntemleri.

    • Seyahat etmek için en verimli rota sırasını belirlemek üzere optimize edebileceğiniz bir dizi yol noktası.

  • Başlangıç noktalarını, varış noktalarını ve yol noktalarını belirtmenin birden fazla yolu:

    • Metin dizeleri. Örneğin: "Chicago, IL", "Darwin, NT, Avustralya", "1800 Amphitheatre Parkway, Mountain View, CA 94043" veya "CWF6+FWX Mountain View, California"

    • Yer kimlikleri

    • Enlem ve boylam koordinatları (isteğe bağlı olarak araç yönüyle birlikte)

  • İhtiyaçlarınıza ve hedeflerinize göre rota seçeneklerinizde ince ayarlamalar yapın:

  • Alan maskesi kullanarak yalnızca ihtiyacınız olan verileri isteyerek gecikmenizi ve kalitenizi kontrol edin. Bu sayede gereksiz işlem süresinden ve daha yüksek istek faturalandırma ücretlerinden kaçınabilirsiniz. Ayrıntılar için İade edilecek bilgileri seçme başlıklı makaleyi inceleyin.

Olası rotaların matrisini alma

Routes API Compute Route Matrix yöntemi, işletme ihtiyaçlarınıza göre en iyi başlangıç ve varış noktalarını seçmenize yardımcı olmak için birden fazla başlangıç ve bitiş noktası arasındaki önerilen rotalar için mesafe ve tahmini varış süreleri dahil olmak üzere bir bilgi matrisi sağlar. Aşağıdaki mesafe verilerini isteyebilirsiniz:

  • Seçilen ulaşım şekli için mesafe

  • Mesafe (kilometre veya mil)

  • Trafikte tahmini seyahat süresi

Mesafe verileri sayesinde yolcular, kargolar veya çalışanlar için birden fazla olası başlangıç ve varış noktası arasında en verimli rotayı belirleyebilirsiniz.

Matrisin tamamı hesaplanmadan önce yanıtın öğelerini aktararak yanıt gecikmesini azaltabilirsiniz.

Sunucu tarafı istek başına birden fazla kaynak ve hedef belirtebilirsiniz. Bu sayı, kaynak sayısı ile hedef sayısının çarpımı olup en fazla 625 olabilir.

Rotalar API'sinin işleyiş şekli

Rotalar API'sinin iki yöntemi vardır: ComputeRoutes ve ComputeRouteMatrix.

ComputeRoutes

Routes API ComputeRoutes yöntemi, istek ayrıntılarını içeren bir JSON istek gövdesi içeren bir HTTP POST isteğini kabul eder. Döndürülecek alanların belirtilmesi için bir kaynak, hedef, seyahat modu ve alan maskesi gereklidir.

Örnek

curl -X POST -d '{
    "origin": {
      "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
    },
    "destination": {
      "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
    },
  "travelMode": "DRIVE"
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
  -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
  'https://routes.googleapis.com/directions/v2:computeRoutes'

Ardından hizmet, istenen rotayı hesaplar ve istediğiniz alanları döndürür.

ComputeRouteMatrix

Rotalar API'si ComputeRouteMatrix, 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 hedef, 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 aracılığıyla kullanılabilen kaynaklar ve döndürdüğü veriler özetlenmiştir.

Veri kaynakları Döndürülen veriler Dönüş biçimi
ComputeRoutes İstenirse alternatif rotalarla birlikte bir rotanın rotalarını, aşamalarını ve adımlarını döndürür. JSON
ComputeRouteMatrix Bir başlangıç yol işaretinden bir varış yol işaretine giden rota dizisi döndürür.

Routes API'yi kullanma

1 Kurulum Google Cloud projenizi oluşturma ile başlayın ve sonraki kurulum talimatlarını uygulayın.
2 Rota hesaplama ve yanıtı inceleme Daha fazla bilgi için Rota alma ve Rota yanıtlarını inceleme başlıklı makaleleri 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ı

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

Sırada ne var?