Routes API'ye Genel Bakış

Routes API, HTTPS isteğini kabul eden ve iki konum arasındaki ideal rotayı ya da farklı kalkış ve varış konumları arasındaki rota matrisi için mesafe 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 rotalar ve yolculuk bilgileri alabilirsiniz:

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

  • Aracın gittiği yön

  • Teslim alma veya bırakma için yol kenarı

  • Trafik koşulları ve kapalı yollar

  • Tehlikeli alanlardan kaçınma veya güvenli teslim alma alanları sunma gibi güvenlik endişeleri

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

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

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

  • Paketlerin nihai hedefine gönderileceği en iyi depoyu belirlemek

Routes API ile neler yapabilirsiniz?

Routes API ile iki temel yönlendirme bilgisi kategorisi alabilirsiniz:

  • Bir konumdan bir veya daha çok hedefe giden rotalar

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

Bir veya daha fazla hedef için rota bulma

Routes API Compute Routes yöntemiyle konumlar arasında hesaplama yapabilirsiniz:

  • Farklı seyahat yolları için yol tarifi ve bir veya daha fazla varış noktası için:

    • Toplu taşıma, araba, iki tekerlekli araçlar, yürüyüş veya bisiklet gibi ulaşım şekilleri.

    • En verimli şekilde seyahat etme sırası için optimize edebileceğiniz bir dizi ara nokta.

  • Kalkış noktalarını, hedefleri ve ara noktaları belirtmek için kullanılan birden çok yöntem:

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

    • Yer kimlikleri

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

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

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

Olası rotaların matrisini alma

Routes API Compute Route Matrix yöntemi, iş ihtiyaçlarınıza göre en iyi kalkış 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 bir bilgi matrisi sağlar. Aşağıdaki tür mesafe verileri isteyebilirsiniz:

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

  • Kilometre veya mil cinsinden mesafe

  • Trafikte tahmini seyahat süresi

Mesafe verileriyle, yolcuları, gönderileri veya çalışanları birden fazla olası kalkış ve varış noktası arasında yönlendirmenin en verimli yolunu belirleyebilirsiniz.

Matrisin tamamı hesaplanmadan önce yanıtın öğelerini akış olarak yayınlayabilirsiniz. Böylece yanıt gecikmesini azaltabilirsiniz.

Sunucu tarafı istek başına birden fazla kaynak ve hedef belirtebilirsiniz. Bunun için kaynak sayısı çarpı hedef sayısı 625'e kadar çıkabilir.

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. Döndürülecek alanları belirtmek için kalkış, 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'

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 JSON istek içeriğine sahip bir HTTP POST isteğini kabul eder. Döndürülecek alanları belirtmek için en az bir kaynak, iki veya daha fazla hedef, TravelMode ve 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 varış ara noktalarının kombinasyonu için olası rotaları içerir.

Kaynaklar

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

Veri kaynakları Döndürülen veriler İade biçimi
ComputeRoutes İstenirse alternatif rotalarla birlikte bir rotanın rotaları, ayaklarını ve adımlarını döndürür. JSON
ComputeRouteMatrix Bir kalkış ara noktasından bir hedef ara noktasına giden rota dizisini döndürür.

Routes API'yi kullanma

1 Kurulumu yapın Google Cloud projenizi oluşturun bölümünü inceleyin ve sonraki kurulum talimatlarını tamamlayın.
2 Rota hesaplayın ve yanıtı inceleyin Daha fazla bilgi için Rota alma ve Rota yanıtlarını inceleme konularına bakın.
3 Rotaların matrisini hesaplayın ve yanıtı gözden geçirin Daha fazla bilgi için Rota matrisi alma ve Rota matrisi yanıtını inceleme konularına bakın.

Kullanılabilir istemci kitaplıkları

Routes API'de kullanılabilen istemci kitaplıklarının listesi için İstemci kitaplıkları sayfasını inceleyin.

Sırada ne var?