Routes API'ye Genel Bakış

Routes API, HTTPS isteğini kabul eden ve iki konum arasındaki ideal rotayı veya mesafeler ile seyahat rotasını döndürür farklı kalkış ve varış noktaları arasındaki rota matrisini görebilirsiniz.

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

Routes API ile doğru rotalar ve seyahat bilgileri alabilirsiniz ulaşım bilgilerini, güncel trafik ve yol koşullarını ve rotayı kullanarak tercihler:

  • 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 gibi güvenlik endişeleri bölgeler

  • İsteğe bağlı özelliklerle yönlendirme ihtiyaçlarınız genelinde gecikme, kalite ve maliyeti dengeleyin süre, mesafe ve yakıt gibi ücretli geçişler ve yolculuk meta verileri gibi özellikler verimlilik

Ayrıca görev dağıtımı zamanlaması için en verimli rotaları belirleyebilirsiniz. yön:

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

  • Paketlerin nihai teslimata kadar gönderileceği en iyi depoyu belirlemek hedef

Routes API ile neler yapabilirsiniz?

Routes API ile iki temel yönlendirme kategorisi kullanabilirsiniz bilgi:

  • 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 şu konumlar arasında hesaplama yapabilirsiniz:

  • Farklı seyahat yolları için yol tarifi alın ve bir veya daha fazla hedefler:

    • Toplu taşıma, araba, iki tekerlekli araçlar dahil olmak üzere ulaşım şekilleri bisiklet sürmeyi deneyebilirsiniz.

    • En verimli şekilde işlem yapmak üzere optimize edebileceğiniz bir dizi ara nokta götürebilir.

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

    • Metin dizeleri. Örneğin: "Chicago, IL", "Darwin, NT, Australia", "Talatpaşa Bulvarı No:222, İstanbul" veya "İstanbul Manzara, Kaliforniya"

    • 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:

  • Yalnızca ihtiyacınız olan verileri istemek için gecikmenizi ve kalitenizi kontrol edin Gereksiz işlem süresini ve daha yüksek orandan kaçınmanıza yardımcı olan bir alan maskesi faturalandırma ücretlerini isteyin. Ayrıntılar için bkz. İade edilecek bilgileri seçin.

Olası rotaların matrisini alma

Routes API Compute Route Matrix yöntemi, birden fazla başlangıç ve bitiş arasındaki önerilen rotalara ilişkin bilgi matrisi mesafe ve tahmini varış süreleri de dahil olmak üzere noktaları belirleyip ve varış noktalarınıza göre en iyi kalkış ve varış noktaları işleyeceğiz. 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 verileri sayesinde, en verimli rotayı belirleyebilirsiniz. birden fazla olası kalkış noktası ve hava yolu olmak üzere hedefler.

Matrisin tamamı tamamlanmadan önce yanıtın öğelerini akış olarak yayınlayabilirsiniz. ve yanıt gecikmesini azaltır.

Sunucu tarafı istek başına birden fazla kaynak ve hedef belirtebilirsiniz: kalkış sayısı çarpı hedef sayısı ile en fazla 625.

Routes API'nin işleyiş şekli

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

ComputeRoutes

Routes API ComputeRoutes yöntemi, aşağıdakileri içeren bir HTTP POST isteğini kabul eder: istek ayrıntılarını içeren bir JSON istek gövdesi. Kaynak, hangi alanların döndürüleceğini belirtmek için hedef, TravelMode ve alan maskesi ekleyin.

Ö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 önceden oluşturduğunuz alanları istendi.

ComputeRouteMatrix

Routes API ComputeRouteMatrix, aşağıdakileri içeren bir HTTP POST isteğini kabul eder: istek ayrıntılarını içeren bir JSON istek gövdesi. En az bir tane zorunludur başlangıç noktası, iki veya daha fazla hedef, TravelMode ve alan maskesi kullanarak hangi döndürülecek şekilde ayarlayın.

Ö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 kombinasyonları için olası rotaları içerir ve varış ara noktalarını gösterir.

Kaynaklar

Aşağıdaki tabloda, Routes API'yi döndürdüğü verilerle birlikte.

Veri kaynakları Döndürülen veriler İade biçimi
ComputeRoutes Bir rota için alternatif rotalar içeren rotaları, bacakları ve adımları döndürür (istenmesi durumunda) JSON
ComputeRouteMatrix Bir kalkış ara noktasından bir hedefe giden rota dizisini döndürür tıklayın.

Routes API'yi kullanma

1 Kurulumu yapın Google Cloud projenizi oluşturma ile başlayın ve aşağıdaki 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 konusuna bakın ve Rota matrisi yanıtını inceleyin.

Kullanılabilir istemci kitaplıkları

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

Sırada ne var?