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 rota oluşturduktan sonra 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.

Toplanan yol verileri, aşağıdakileri içeren zaman serisi verileri olarak sağlanır:

BigQuery ayarlarını yapma

BigQuery'de yol verilerinize erişebilmek için Google Cloud projenizi oluşturmanız ve veri alışverişine 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. Analiz merkezi API'ye bakın.
  3. Gerekli IAM rollerini verin. Abone görevlerini gerçekleştirmek ve veri kümeleri oluşturmak için hesabınızın aşağıdaki rollere sahip olduğundan emin olun:
  4. Analiz merkezi Abonesi (roles/analyticshub.subscriber)

Veri alışverişinize abone olma

Yol verileriniz, BigQuery'deki (Analiz merkezi) özel bir veri alışverişi aracılığıyla sizinle paylaşılır. Verilerinize erişmek için bir Google iş ortağından özel bir abonelik 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 tarafından sağlanan abonelik 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 alışverişi ayrıntılarını inceleyin.
  3. İletişim kutusunda Subscribe (Abone ol) düğmesini tıklayın.
  4. Abonelik tamamlandığında, bağlı veri kümesi Google Cloud konsolundaki BigQuery Gezgin 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ş BigQuery veri kümesinde barındırılır. Bu veriler, BigQuery paylaşımında (Analiz merkezi) yalnızca sizin için oluşturulan özel bir veri alışverişi aracılığıyla sizinle paylaşılır. Verilere erişmek için veri alışverişine abone olmanız ve Google Cloud projenizde bağlı bir veri kümesi oluşturmanız gerekir.

Paylaşılan BigQuery veri kümesi, Google tarafından tanımlanan ve oluşturulan birkaç BigQuery tablosu içerir. Her bir tabloyla ilgili ayrıntılar aşağıda verilmiştir.

historical_travel_time tablosu

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

Ad Mod Tür Açıklama
selected_route_id NULLABLE Dize Rotanın selected_route_id kadarı
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 trafiğe duyarlı süresi. has_road_closure, true olduğunda hariç tutulur (NULL).
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 boyunca yer kimlikleri olarak temsil edilen yol segmentleri
has_road_closure NULLABLE BOOLE Rota üzerinde tamamen kapalı bir yol olup olmadığı. true olduğunda, rota geçilemez olduğu için duration_in_seconds atlanır (NULL). NULL değeri, yolun kapalı olup olmadığı bilgisinin belirlenemediğini gösterir.

Tablo davranışları ve gerçekleri

  • Tablo, güne göre bölümlere ayrılır ve her bölüm için 10 yıllık bir geçerlilik süresi 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 verileri görmek için 1 saate kadar beklemeniz gerekebilir.
  • Bir rota Roads Selection API'den silindikten sonra bu tabloya rota için yeni veri yazılmaz. Ancak geçmiş veriler, geçerlilik süresi dolana kadar saklanır.
  • Rota boyunca yol segmentleri topolojik sırayı takip eder ve her zaman birbirine bağlıdır.
  • has_road_closure işareti, Google Haritalar'daki tam kapalı yol durumuyla tutarlıdıreşleşir.

recent_roads_data tablosu

Not: Bu tablo yalnızca sözleşmenizde gerçek zamanlı yol verileri varsa kullanılabilir.

historical_travel_time tablosundan farklı olarak bu tabloda, ofset tabanlı hız ölçüm aralıkları (speed_reading_offsets) ve eski koordinat tabanlı hız ölçüm aralıkları (speed_reading_intervals) da bulunur. BigQuery'deki şema şu şekildedir:

Ad Mod Tür Açıklama
selected_route_id NULLABLE Dize Rotanın selected_route_id kadarı
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 trafiğe duyarlı süresi. has_road_closure, true olduğunda hariç tutulur (NULL).
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ız okuma aralıkları. 9 Kasım 2026'da veya daha sonra doldurulması durdurulabilir. Bunun yerine speed_reading_offsets kullanın. Hız ölçüm aralıkları bölümüne bakın.
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ırması. 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 boyunca yer kimlikleri olarak temsil edilen yol segmentleri
speed_reading_offsets TEKRARLANAN KAYIT Rota boyunca trafik yoğunluğunu temsil eden, ofset tabanlı hız okuma aralıkları. Her aralık, rotanın başlangıcından itibaren mesafe ofsetiyle sınırlandırılır. has_road_closure, true olduğunda atlanır. Hız ölçüm aralıkları bölümüne bakın.
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 sonu için rotanın başlangıcından itibaren metre cinsinden mesafe farkı (hariç; sonraki aralığın start_offset değerine eşittir)
speed_reading_offsets.speed NULLABLE Dize Bu aralık için hızın sınıflandırması, Google Haritalar trafik katmanındaki renklerle uyumludur. Olası değerler: NORMAL (yeşil), YAVAŞ (sarı), TRAFİK_SIKIŞIKLIĞI (kırmızı), TRAFİK_SIKIŞIKLIĞI_YOĞUN (koyu kırmızı, 8 Ekim 2026'dan itibaren kullanılabilir)
has_road_closure NULLABLE BOOLE Rota üzerinde tamamen kapalı bir yol olup olmadığı. Rota geçilemediği için true, duration_in_seconds ve speed_reading_offsets atlandığında. NULL değeri, yolun kapalı olup olmadığı bilgisinin belirlenmediğini gösterir.

Tablo davranışları ve gerçekleri

  • Tablo güne göre bölümlere ayrılır ve her bölüm için 60 günlük bir geçerlilik süresi 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 verileri görmek için 1 saate kadar beklemeniz gerekebilir.
  • Bir rota Roads Selection API'den silindikten sonra bu tabloya rota için yeni veri yazılmaz. Ancak geçmiş veriler, geçerlilik süresi dolana kadar saklanır.
  • Rota boyunca yol segmentleri topolojik sırayı takip eder ve her zaman birbirine 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'da veya bu tarihten sonra doldurulmayabilir. Bunun yerine speed_reading_offsets politikasını kullanın.
  • has_road_closure işareti, Google Haritalar'daki tam kapalı yol durumuyla tutarlıdıreşleşir.

routes_status tablosu

Tablo, seçilen rotaların meta verilerini ve durum bilgilerini içerir. Bu sayede tüm rotaları ve durumları daha kolay görüntüleyebilirsiniz. Veri filtreleme için diğer iki tabloyla birleştirilebilir. BigQuery'deki şema şu şekildedir:

Ad Mod Tür Açıklama
selected_route_id NULLABLE Dize Rotanın selected_route_id kadarı
display_name NULLABLE Dize Rotanın görünen adı
status* 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 rotada düşük yol kullanımının ilk kez gözlemlendiği zaman. VALIDATION_ERROR_LOW_ROAD_USAGE ile ilişkilidir.
route_attributes NULLABLE Dize Seçilen rota için özel özellikler
dynamic_routing NULLABLE BOOLE Rotanın dinamik (true) mi yoksa sabit (false) mi olduğunu gösterir. dynamicRouting bölümüne bakın.
kaynak NULLABLE GEOGRAPHY Rotanın başlangıç ara noktası
hedef NULLABLE GEOGRAPHY Rotanın hedef ara noktası
ara ürünler TEKRARLANAN GEOGRAPHY Rotanın ara noktaları
static_route_geometry NULLABLE GEOGRAPHY Ara noktalardan canlı trafik olmadan hesaplanan statik rotanın çoklu çizgi geometrisi
road_segment_ids TEKRARLANAN Dize Canlı trafik olmadan hesaplanan statik rota boyunca yer kimlikleri olarak temsil edilen yol segmentleri

Tablo davranışları ve gerçekleri

  • Bu tabloya yalnızca STATUS_RUNNING veya STATUS_INVALID durumundaki rotalar dahil edilir.
  • Rota meta verileri ve durumu her saat 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ı 1 saati bulabilir.
  • Sabit rotalarda (dynamic_routing: false), road_segment_ids içindeki yer kimlikleri, Google'ın yol ağındaki değişiklikleri yansıtacak şekilde otomatik olarak güncellenir ancak aynı rotayı temsil etmeye devam eder. Dinamik rotalar (dynamic_routing: true) için road_segment_ids güncellenmez.