Birikmiş yol verileri

Birikmiş yol verileri, seçtiğiniz rotalar için zaman içinde oluşturabileceğiniz verileri ifade eder. Roads Selection API ile bir rota oluşturduğunuzda veri almaya başlarsınız. Bu veriler daha sonra ayrıntılı analiz, stratejik planlama ve rotaların uzun vadeli davranışını anlamak için kullanılabilir.

Birikmiş yol verileri, zaman serisi verileri olarak sağlanır. Bu veriler şunları içerir:

BigQuery'yi ayarlama

BigQuery'de yol verilerinize erişebilmek için Google Cloud projenizi ayarlamanız ve veri borsasına abone olmanız gerekir.

Ön koşullar

Google Cloud projenizin ve hesabınızın aşağıdaki yapılandırmalara sahip olduğundan emin olun:

  1. BigQuery API'yi etkinleştirin. Talimatlar için Google Cloud Console ile herkese açık bir veri kümesini sorgulama başlıklı makaleyi inceleyin.
  2. Analytics Hub API'yi etkinleştirin. Analytics Hub API'ye bakın.
  3. Gerekli IAM rollerini verin. Abonelikle ilgili görevleri gerçekleştirmek ve veri kümeleri oluşturmak için hesabınızın aşağıdaki rollerine sahip olduğundan emin olun:
  4. Analytics Hub Abonesi (roles/analyticshub.subscriber)

Veri alışverişinize abone olma

Yol verileriniz, BigQuery'deki (Analytics Hub) özel bir veri alışverişi aracılığıyla sizinle paylaşılır. Verilerinize erişmek için bir Google iş ortağından belirli bir abone olma bağlantısı alırsınız. Bu veri kümesi aşağıdaki adlandırma kuralına uyar:

historical_roads_data_PROJECT_NUMBER.

Verilerinize abone olmak için:

  1. Google iş ortağınızın sağladığı abone olma bağlantısını tıklayın. Bu bağlantı sizi doğrudan Google Cloud Console'daki veri alışverişine yönlendirir.
  2. Google Cloud Console'da veri değişimi ayrıntılarını inceleyin.
  3. İletişim kutusunda Abone ol düğmesini tıklayın.
  4. Abonelik tamamlandığında, bağlı veri kümesi Google Cloud Console'daki BigQuery Explorer panelinde görünür. Artık SQL sorgularınızdaki verilere erişmek için Gezgin panelinde gösterilen tablo adlarını kullanabilirsiniz.

BigQuery tabloları

Seçtiğiniz rotaların birikmiş yol verileri, Google'a ait bir bulut projesinin izole edilmiş bir BigQuery veri kümesinde barındırılır. Bu veriler, BigQuery paylaşımında (Analytics Hub) yalnızca sizin için oluşturulan özel bir veri değişimi aracılığıyla sizinle paylaşılır. Verilere erişmek için veri borsasına abone olmanız ve Google Cloud projeniz altında bağlantılı bir veri kümesi oluşturmanız gerekir.

Paylaşılan BigQuery veri kümesi, Google tarafından tanımlanıp oluşturulan birkaç BigQuery tablosu içerir. Aşağıda her tablonun ayrıntıları verilmiştir.

historical_travel_time tablo

historical_travel_time BigQuery tablosunun şeması aşağıda verilmiştir:

Ad Mod Tür Açıklama
selected_route_id NULLABLE Dize Rotanın selected_route_id
display_name NULLABLE Dize Rotanın görünen adı
record_time NULLABLE ZAMAN DAMGASI Rota verilerinin hesaplandığı zaman damgası
duration_in_seconds NULLABLE KAYAN NOKTALI Rotanın trafik durumuna göre süresi
static_duration_in_seconds NULLABLE KAYAN NOKTALI Rotanın trafikten bağımsız süresi
route_geometry NULLABLE GEOGRAPHY Rotanın trafiğe duyarlı çoklu çizgi geometrisi
road_segment_ids TEKRARLANAN Dize Rota üzerindeki yol segmentleri (yer kimlikleri olarak gösterilir)

Tablo davranışları ve gerçekleri

  • Tablo, güne göre bölümlenir ve her bölüm için 10 yıllık bir geçerlilik bitiş tarihi belirlenir.
  • Tablo, toplu olarak yazılan en son trafik verileriyle her saat güncellenir.
  • Roads Selection API'de yeni bir rota oluşturulduktan sonra, bu tablodaki verilerin görünmesi için 1 saat kadar beklemeniz gerekebilir.
  • Bir rota Roads Selection API'den silindiğinde, rotayla ilgili bu tabloya yeni veri yazılmaz. Ancak geçmiş veriler, geçerlilik süresi dolana kadar kalır.
  • Rota üzerindeki yol segmentleri topolojik sıraya göre düzenlenir ve her zaman bağlıdır.

recent_roads_data tablo

Not: Bu tablo yalnızca sözleşmenizde anlık yol verileri yer aldığında kullanılabilir.

historical_travel_time tablosundan farklı olarak bu tabloda, ofset tabanlı hızlı okuma aralıkları (speed_reading_offsets) ve eski koordinat tabanlı hızlı okuma aralıkları (speed_reading_intervals) da bulunur. BigQuery'deki şema aşağıda verilmiştir:

Ad Mod Tür Açıklama
selected_route_id NULLABLE Dize Rotanın selected_route_id
display_name NULLABLE Dize Rotanın görünen adı
record_time NULLABLE ZAMAN DAMGASI Rota verilerinin hesaplandığı zaman damgası
duration_in_seconds NULLABLE KAYAN NOKTALI Rotanın trafik durumuna göre süresi
static_duration_in_seconds NULLABLE KAYAN NOKTALI Rotanın trafikten bağımsız süresi
route_geometry NULLABLE GEOGRAPHY Rotanın trafiğe duyarlı çoklu çizgi geometrisi
speed_reading_intervals TEKRARLANAN KAYIT Eski koordinat tabanlı hızlı okuma aralıkları. 9 Kasım 2026'da veya daha sonra doldurulmayabilir. Bunun yerine speed_reading_offsets kullanın. Hızlı okuma aralıkları başlıklı makaleyi inceleyin.
speed_reading_intervals.interval_coordinates TEKRARLANAN GEOGRAPHY Eski 9 Kasım 2026'da veya daha sonra doldurulması durdurulabilir. Bunun yerine speed_reading_offsets kullanın. Bu aralığın geometrisi
speed_reading_intervals.speed NULLABLE Dize Eski 9 Kasım 2026'da veya daha sonra doldurulması durdurulabilir. Bunun yerine speed_reading_offsets kullanın. Bu aralık için hızın sınıflandırılması. Olası değerler: NORMAL, SLOW, TRAFFIC_JAM. Bu eski alanda, yoğun trafik sıkışıklıkları (koyu kırmızı) da TRAFFIC_JAM olarak bildirilir. TRAFFIC_JAM_HEAVY hiçbir zaman kullanılmaz.
road_segment_ids TEKRARLANAN Dize Rota üzerindeki yol segmentleri (yer kimlikleri olarak gösterilir)
speed_reading_offsets TEKRARLANAN KAYIT Rota boyunca trafik yoğunluğunu gösteren, mesafeye dayalı hız okuma aralıkları. Her aralık, rotanın başlangıcından itibaren mesafeyle ayrılır. Hızlı okuma aralıkları başlıklı makaleyi inceleyin.
speed_reading_offsets.start_offset NULLABLE TAM SAYI Aralığın başlangıcı için rotanın başlangıcından itibaren metre cinsinden mesafe farkı (dahil)
speed_reading_offsets.end_offset NULLABLE TAM SAYI Aralığın bitişi için rotanın başlangıcından itibaren uzaklık uzaklığı (dahil değildir; sonraki aralığın start_offset değerine eşittir)
speed_reading_offsets.speed NULLABLE Dize Bu aralık için hız sınıflandırması, Google Haritalar trafik katmanındaki renklerle uyumludur. Olası değerler: NORMAL (yeşil), SLOW (yavaş), TRAFFIC_JAM (trafik sıkışıklığı), TRAFFIC_JAM_HEAVY (yoğun trafik sıkışıklığı, 8 Ekim 2026'dan itibaren kullanılabilir)

Tablo davranışları ve gerçekleri

  • Tablo, güne göre bölümlenir ve her bölüm için 60 günlük bir geçerlilik bitiş tarihi belirlenir.
  • Tablo, toplu olarak yazılan en son trafik verileriyle her saat güncellenir.
  • Roads Selection API'de yeni bir rota oluşturulduktan sonra, bu tablodaki verilerin görünmesi için 1 saat kadar beklemeniz gerekebilir.
  • Bir rota Roads Selection API'den silindikten sonra, rotayla ilgili bu tabloya yeni veri yazılmaz. Ancak geçmiş veriler, geçerlilik süresi dolana kadar kalır.
  • Rota üzerindeki yol segmentleri topolojik sıraya göre düzenlenir ve her zaman bağlıdır.
  • speed_reading_offsets sütunu, 8 Ekim 2026'da veya bu tarihten sonra kaydedilen satırlar için doldurulur. Önceki satırlarda boş diziler var.
  • Eski speed_reading_intervals sütunu, 9 Kasım 2026'dan itibaren doldurulmayabilir. Bunun yerine speed_reading_offsets politikasını kullanın.

routes_status tablo

Tabloda, seçilen rotaların meta verileri ve durum bilgileri yer alır. Bu araç, tüm rotaları ve durumları daha kolay görüntülemenizi sağlar. Veri filtreleme için diğer iki tabloyla birleştirilebilir. BigQuery'deki şema:

Ad Mod Tür Açıklama
selected_route_id NULLABLE Dize Rotanın selected_route_id
display_name NULLABLE Dize Rotanın görünen adı
durum* NULLABLE Dize Rotanın durumu
validation_error NULLABLE Dize Rotanın doğrulama hatası
low_road_usage_start_time NULLABLE ZAMAN DAMGASI Yeniden doğrulama sırasında rotanın ilk kez düşük yol kullanımı gözlemlediği zaman. VALIDATION_ERROR_LOW_ROAD_USAGE ile ilişkilidir.
route_attributes NULLABLE Dize Seçilen rota için özel özellikler

*Bu tablodaki rota durumu STATE_ yerine STATUS_ ile başlar. Aksi takdirde Roads Selection API ile tutarlıdır.

Tablo davranışları ve gerçekleri

  • Bu tabloya yalnızca STATUS_RUNNING veya STATUS_INVALID durumundaki rotalar dahil edilir.
  • Rotaların meta verileri ve durumu saat başı kesintisiz olarak güncellenir.
  • Roads Selection API'de yeni bir rota oluşturulduktan sonra, rotanın bu tabloda görünmesi için 1 saate kadar beklemeniz gerekebilir.
  • Bir rota Roads Selection API'den silindikten sonra, seçilen rotanın bu tablodan kaldırılması için 1 saat beklemeniz gerekebilir.