Routes API'ye Genel Bakış

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

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 olanakları

  • Bir aracın gittiği yön

  • Alma veya bırakma için yol kenarı

  • Trafik koşulları ve kapalı yollar

  • Tehlikeli alanlardan kaçınmak veya güvenli alma alanları sağlamak gibi güvenlikle ilgili kaygılar

  • Ücretli geçişler ve süre ve mesafe gibi seyahat meta verileri ve yakıt verimliliği gibi isteğe bağlı özellikler gibi isteğe bağlı özelliklerle rota 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 en iyi nasıl atanır?

  • Paketlerin nihai varış noktasına gönderileceği en iyi depoyu belirlemek

Routes API ile neler yapabilirsiniz?

Routes API ile iki birincil 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 bir matrisi.

Bir veya daha fazla hedef için rota alma

Routes API Compute Routes yöntemini kullanarak şu konumlar arasında hesaplama yapabilirsiniz:

  • Farklı seyahat yolları ve tek veya 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 şekilleri.

    • Yolculuk yaparken en verimli sıralamayı elde etmek için optimize edebileceğiniz bir dizi referans noktası.

  • Kalkış noktalarını, hedefleri ve ara noktaları belirtmek için kullanabileceğiniz birden fazla yöntem:

    • 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 edebilirsiniz. Böylece, gereksiz işleme süresinden ve yüksek istek faturalandırma ücretlerinden kaçınmış olursunuz. Ayrıntılar için Döndürülecek bilgileri seçme bölümüne bakın.

Olası rotaların matrisini alma

Routes API Compute Route Matrix yöntemi, iş ihtiyaçlarınıza göre en iyi başlangıç ve varış noktalarını seçmenize yardımcı olmak amacıyla, 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 tür mesafe verilerini isteyebilirsiniz:

  • Seçili 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 fazla başlangıç noktası ve hedef arasında yönlendirmenin en verimli yolunu belirleyebilirsiniz.

Matrisin tamamı hesaplanmadan önce yanıtın öğelerini akışla alabilir, böylece yanıt gecikmesini azaltabilirsiniz.

Sunucu tarafı isteği başına birden fazla kaynak ve hedef belirtebilirsiniz. Kaynak sayısı çarpı hedef sayısı ile en fazla 625 olabilir.

Routes API'nin işleyiş şekli

Routes API'nin 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ö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 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'

Hizmet, daha sonra istenen rotayı hesaplar ve istekte bulunduğunuz 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 başlangıç ve hedef ara noktalarının kombinasyonu için olası rotaları içerir.

Kaynaklar

Aşağıdaki tabloda, Rotalar API'si aracılığıyla kullanılabilen kaynaklar, döndürdüğü verilerle birlikte özetlenmiştir.

Veri kaynakları Döndürülen veriler Dönüş biçimi
ComputeRoutes İstenirse alternatif rotalarla birlikte rotanın rotalarını, bacaklarını ve adımlarını döndürür. JSON
ComputeRouteMatrix Bir başlangıç 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 ile başlayın ve aşağıdaki kurulum talimatlarını tamamlayın.
2 Bir rota hesaplama ve yanıtı inceleme 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 hesaplama ve yanıtı inceleme Daha fazla bilgi için Rota matrisi alma ve Rota matrisi yanıtını inceleme sayfalarına göz atın.

Kullanılabilir istemci kitaplıkları

Routes API'de kullanılabilen istemci kitaplıklarının listesini İstemci kitaplıkları bölümünde bulabilirsiniz.

Sırada ne var?