Rota doğrulamasını anlama

Bir rota oluşturduktan sonra Roads Selection API 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. Bu işlem genellikle birkaç dakika içinde tamamlanır.

Rotalarınızın doğrulama durumunu API yanıtındaki state alanından izleyebilirsiniz. get uç noktasını kullanarak (Seçilen rotaları alma bölümünde açıklandığı gibi) veya BigQuery'deki routes_status tablosunu inceleyerek bunu 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 ayarlanmamış.
  • STATE_VALIDATING: Rota doğrulanıyor.
  • STATE_RUNNING: Rota, doğrulama sürecini başarıyla tamamladı ve artık etkin. API, bu rota için aktif olarak veri topluyor ve BigQuery'ye, Pub/Sub'a veya her ikisine de düzenli güncellemeler gönderiyor.
  • STATE_DELETING: Rota silinmek üzere işaretlendi ve sistemden kaldırılıyor.
  • STATE_INVALID: Rota, belirli ölçütlere göre doğrulanamadı. 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ı bir 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 sırasında 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'a düzenli olarak gönderilen 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 devam eden trafik değerlendirmelerine tabi olmaya 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ığını gösterir. 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.