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. İşlem genellikle birkaç dakika içinde tamamlanır.

API yanıtındaki state alanını kullanarak rotalarınızın doğrulama durumunu izleyebilirsiniz. Bunu, Seçilen 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 faaliyet 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 şu anda etkin. API, bu rota için etkin bir şekilde 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ğuyla ilgili ayrıntıları içeren 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 gösterir.

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

  • VALIDATION_ERROR_UNSPECIFIED: Bu rotanın doğrulama hatası ayarlanmadı.
  • VALIDATION_ERROR_ROUTE_OUTSIDE_JURISDICTION: Rota, projenizin yetkili yargı alanının dışında.
  • VALIDATION_ERROR_LOW_ROAD_USAGE: Rotada yol kullanımı düşük. Bu nedenle, anlamlı bir analiz için yeterli trafik verisi toplanamıyor. Düşük yol kullanımı 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ı bölümünde daha fazla bilgi edinin.

Düşük yol kullanımı olan rota

API, tutarlı 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 şunları bekleyebilirsiniz:

  • BigQuery'de veri yayınlama devam eder: Bir rota, düşük yol kullanımı nedeniyle STATE_INVALID olarak sınıflandırılsa bile API, ilgili rota için mevcut verileri işlemeye ve BigQuery'de yayınlamaya devam eder.
  • Pub/Sub güncellemeleri durur: Rotanın state değeri STATE_INVALID olarak değişirse Pub/Sub'a yönelik periyodik gerçek zamanlı 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 bir uyarı yayınlar.
    • Düşük trafik art arda 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 get uç noktası üzerinden (Seçilen rotaları alma bölümünde açıklandığı gibi) veya BigQuery'deki routes_status tablosunu inceleyerek izleyebilirsiniz.

Geçersiz rotalarla ilgili sorunları giderme

Rotanız state STATE_INVALID ise aldığınız validationError değerine 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 yetkilendirilen coğrafi alanın dışına çıktığını gösterir. Bu sorunu düzeltmek için mevcut rotayı silip yeniden oluşturun. Tüm noktaların (başlangıç, varış ve ara noktalar) yetkili projenizin yetki 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ığı anlamına gelir. Bu sorunu düzeltmek için mevcut rotayı silip yeniden oluşturun. Veri toplama için yol kullanımının veya "yoğunluğun" daha fazla olduğu bir alan seçin. Rotanızda bu hata varsa rotanın durumu, Düşük yol kullanımı rotası bölümünde açıklandığı gibi trafik zaman içinde artarsa tekrar STATE_RUNNING olarak değişebilir.