Rota doğrulamasını anlama

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ı üzerinden izleyebilirsiniz. Bu durumu, get uç noktasını kullanarak (Seçili rotaları alma bölümünde açıklandığı gibi) veya BigQuery'deki routes_status tablosunu inceleyerek kontrol edebilirsiniz.

Rota durumları

Bir 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, aktif olarak 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ğ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 olduğundan 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. Düşük yol kullanımı rotası başlıklı makalede daha fazla bilgi edinin.

Düşük yol kullanımına sahip rota

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, yolun az kullanılması 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 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'e göre 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. Rotanın tüm noktalarının (başlangıç, hedef ve tüm ara noktalar) yetkili projenizin yargı alanında 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.