Routes API'ye Genel Bakış

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

Routes API'yi neden kullanmalısınız?

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

  • Farklı ulaşım modlarının türleri ve yetenekleri

  • Bir aracın gittiği yön

  • Araçtan alma veya bırakma için yol kenarı

  • Trafik koşulları ve kapalı yollar

  • Tehlikeli alanlardan kaçınmak veya güvenli teslim alma alanları sunmak gibi güvenlikle ilgili endişeler

  • Ücretli geçişler ve seyahat meta verileri (ör. süre ve mesafe ve yakıt verimliliği) gibi isteğe bağlı özelliklerle rota izleme ihtiyaçlarınız genelinde gecikme, kalite ve maliyeti dengeleyin

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

  • Bir dizi paketi teslim alacak bir çalışan grubu atamanın en iyi yolu

  • Paketlerin varış yerine gönderileceği en iyi depoyu belirlemek

Routes API ile neler yapabilirsiniz?

Routes API'yi kullanarak iki temel yönlendirme bilgisi kategorisi alabilirsiniz:

  • Bir konumdan bir veya daha fazla hedefe giden rotalar

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

Bir veya daha fazla hedef için rotalar alma

Routes API Compute Routes yöntemini kullanarak konumlar arasındaki hesaplamaları yapabilirsiniz:

  • Farklı seyahat yolları ve tek ya da birden fazla varış noktası için yol tarifi alın:

    • Toplu taşıma, araba, iki tekerlekli araçlar, yaya veya bisiklet dahil olmak üzere ulaşım türleri.

    • Bunları kullanarak seyahat ederken izlenecek en verimli sıralama için optimize edebileceğiniz bir dizi ara nokta.

  • Kalkış noktalarını, hedefleri ve ara noktaları belirtmenin birden çok yolu:

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

    • Yer kimlikleri

    • İsteğe bağlı olarak araç yönüyle birlikte enlem ve boylam koordinatları

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

  • Alan maskesi kullanarak yalnızca ihtiyacınız olan verileri isteyerek gecikmenizi ve kalitenizi kontrol edin. Böylece, gereksiz işleme süresinden ve yüksek faturalandırma ücretlerinden kaçınabilirsiniz. Ayrıntılar için İade edilecek bilgileri seçme bölümüne bakın.

Olası rotaların matrisini alma

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

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

  • Kilometre veya mil cinsinden mesafe

  • Trafikteki tahmini seyahat süresi

Mesafe verilerini kullanarak, yolcuları, sevkiyatları veya çalışanları olası birden çok kalkış ve varış noktası arasında yönlendirmenin en verimli yolunu belirleyebilirsiniz.

Matrisin tamamı hesaplanmadan önce yanıtın öğelerini akışla alarak yanıt gecikmesini azaltabilirsiniz.

Sunucu tarafı isteği başına birden fazla kaynak ve hedef belirtebilirsiniz. Kaynak sayısı çarpı 625'i aşmayan hedef sayısı.

Routes API'nin işleyiş şekli

Routes API'nin iki yöntemi vardır: ComputeRoute ve ComputeRouteMatrix.

ComputeRoute

Routes API ComputeRoute yöntemi, istek ayrıntılarını içeren JSON istek gövdesine sahip HTTP POST isteğini kabul eder. Hangi alanların döndürüleceğini belirtmek için başlangıç noktası, hedef, TravelMode ve alan maskesi zorunludur.

Ö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'

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

ComputeRouteMatrix

Routes API ComputeRouteMatrix, istek ayrıntılarını içeren bir JSON istek gövdesine sahip HTTP POST isteğini kabul eder. Hangi alanların döndürüleceğini belirtmek için en az bir kaynak, iki veya daha fazla hedef, TravelMode ve bir alan maskesi gerekir.

Ö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 kalkış ve hedef ara noktalarının kombinasyonu için olası rotaları içerir.

Kaynaklar

Aşağıdaki tabloda, Routes API aracılığıyla kullanılabilen kaynaklar, döndürdüğü verilerle birlikte özetlenmektedir.

Veri kaynakları Döndürülen veriler İade biçimi
ComputeRoute İstenirse bir rotanın rotaları, bacaklarını ve adımlarını alternatif rotalarla döndürür. JSON
ComputeRouteMatrix Bir başlangıç noktası ara noktasından bir hedef ara noktaya kadar bir rota dizisi döndürür.

Routes API'yi kullanma

1 Hazırlanın Google Cloud projenizi oluşturma işlemiyle başlayın ve aşağıdaki kurulum talimatlarını tamamlayın.
2 Bir rota hesaplayın ve yanıtı inceleyin Daha fazla bilgi için Rota alma ve Rota yanıtlarını inceleme başlıklı makalelere göz atın.
3 Rotaların matrisini hesaplayın ve yanıtı inceleyin Daha fazla bilgi için Rota matrisi alma ve Rota matrisi yanıtını inceleme bölümlerine bakın.

Kullanılabilir istemci kitaplıkları

Routes API'de kullanılabilen istemci kitaplıklarının listesi için İstemci kitaplıkları bölümünü inceleyin.

Sırada ne var?