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ü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, 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 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ın 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, 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

    • İ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 İade edilecek bilgileri seçme başlıklı makaleyi inceleyin.

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 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: 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, istek ayrıntılarını içeren bir JSON istek gövdesi içeren bir HTTP POST isteğini kabul eder. 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 istediğiniz alanları döndürür.

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 üzerinden kullanılabilen kaynaklar ve döndürdüğü veriler özetlenmiştir.

Veri kaynakları Döndürülen veriler İade 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 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 başlıklı makaleleri inceleyin.
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 başlıklı makaleleri 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?