Rota doğrulamasını anlama

Bir rota oluşturduktan sonra, Yol Seçimi API'si bir doğrulama işlemi gerçekleştirir. Bu doğrulama, rotanın Yol Yönetimi Analizleri'nde veri toplama ve güncelleme için uygun olmasını sağlar. İşlem genellikle birkaç dakika içinde tamamlanır.

Rotalarınızın doğrulama durumunu API yanıtındaki state alanından izleyebilirsiniz. Bunu, Seçili rotaları alma bölümünde açıklandığı gibi get uç noktasını kullanarak veya BigQuery'deki routes_status tablosunu inceleyerek kontrol edebilirsiniz.

Rota durumları

SelectedRoute kaynağındaki state alanı, kaynağın mevcut doğrulama ve operasyonel durumunu gösterir. state alanı aşağıdaki değerleri içerebilir:

  • STATE_UNSPECIFIED: Bu rotanın doğrulama durumu ayarlanmadı.
  • STATE_VALIDATING: Rota doğrulanıyor.
  • STATE_RUNNING: Rota doğrulamayı başarıyla geçti ve artık etkin. API, etkin bir şekilde veri toplar ve bu rota için BigQuery'ye, Pub/Sub'a veya her ikisine de düzenli güncellemeler gönderir.
  • STATE_DELETING: Rota silinmek üzere işaretlendi ve sistemden kaldırılıyor.
  • STATE_INVALID: Rota belirli ölçütlere göre doğrulamada başarısız oldu. Bir rota STATE_INVALID durumundaysa yanıtta, doğrulamanın neden başarısız olduğuna dair ayrıntıların yer aldığı bir validationError alanı bulunur.

Doğrulamayla ilgili hatalar

Bir SelectedRoute kaynağının state değeri STATE_INVALID olduğunda, API yanıtı bir validationError alanı içerir. Bu alan, doğrulama hatasının belirli bir nedenini sağlar.

validationError alanı aşağıdaki değerleri içerebilir:

  • VALIDATION_ERROR_UNSPECIFIED: Bu rotanın doğrulama hatası ayarlanmamış.
  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: Rota, projenizin yetkili yargı alanının dışında.
  • VALIDATION_ERROR_LOW_ROAD_USAGE: Rota, düşük yol kullanımına sahip. Bu nedenle, anlamlı analiz için yeterli trafik verisi toplanamıyor. Yol kullanımının düşük olması nedeniyle geçersiz olarak sınıflandırılan bir rota, trafik hacmi önceden belirlenmiş bir eşiğin üzerine çıkarsa tekrar geçerli hale gelebilir. Daha fazla bilgi için Low road usage route (Düşük yol kullanımı rotası) başlıklı makaleyi inceleyin.

Düşük yol kullanımı rotası

API, tutarlı bir analiz için yeterli trafik verisi olmadığını belirlerse rotalar VALIDATION_ERROR_LOW_ROAD_USAGE ile işaretlenebilir. Bu durum, ilk doğrulama veya devam eden değerlendirmeler sırasında gerçekleşebilir.

Yol kullanımının düşük olduğu rotalarda beklenenler:

  • BigQuery'ye veri yayınlama devam eder: Bir rota, yol kullanımının düşük olması nedeniyle STATE_INVALID olarak sınıflandırılsa bile API, bu rotayla ilgili mevcut verileri işlemeye ve BigQuery'de yayınlamaya devam eder.
  • Pub/Sub güncellemeleri durdurulur: Rotanın state değeri STATE_INVALID olarak değişirse Pub/Sub'da düzenli olarak yapılan anlık güncellemeler durdurulur.
  • Üç aylık değerlendirmeler: API, trafik hacmi için tüm etkin rotaların üç aylık değerlendirmelerini yapar.
    • Değerlendirme sırasında düşük trafik tespit edilirse API, SelectedRoute kaynağında uyarı verir.
    • Düşük trafik dört çeyrek boyunca devam ederse rotanın state değeri STATE_INVALID olarak değişir ve Pub/Sub güncellemeleri durdurulur.
  • Yeniden doğrulama mümkündür: Bir rota STATE_INVALID olsa bile trafik değerlendirmeleri devam eder. Sonraki değerlendirmelerde, trafik hacmi önceden belirlenmiş bir eşiğin üzerine çıkarsa rota geçerli (STATE_RUNNING) olarak yeniden sınıflandırılabilir.
  • İzleme durumu: Bir rotanın doğrulama durumunu, Seçili Rotaları Alma bölümünde açıklandığı gibi get uç noktası üzerinden veya BigQuery'deki routes_status tablosunu inceleyerek izleyebilirsiniz.

Geçersiz rotalarla ilgili sorunları giderme

Rotanız state ise STATE_INVALID, aldığınız validationError ile ilgili olarak aşağıdaki sorun giderme yönergelerini uygulayın:

  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: Bu hata, tanımlanan rotanın projeniz için yetkilendirilmiş coğrafi alanın dışına çıktığını gösterir. Bu sorunu düzeltmek için mevcut rotayı silin ve rotayı yeniden oluşturun. Tüm noktalarının (başlangıç, hedef ve tüm ara noktalar) yetkili projenizin yargı alanı içinde olduğundan emin olun.

  • VALIDATION_ERROR_LOW_ROAD_USAGE: Bu hata, seçilen rotada anlamlı analiz ve güncellemeler için yeterli yol kullanımı verisi olmadığı anlamına gelir. Bu sorunu düzeltmek için mevcut rotayı silin ve veri toplama amacıyla yol kullanımının veya "yoğunluğunun" daha yüksek olduğu bir alanı seçerek rotayı yeniden oluşturun. Rotanızda bu hata varsa Düşük yol kullanımı rotası bölümünde açıklandığı gibi, trafik zaman içinde artarsa rotanın durumu STATE_RUNNING olarak değişebilir.