Birikmiş yol verileri, seçtiğiniz rotalar için zaman içinde oluşturabileceğiniz verileri ifade eder. Yolları Seçme API'si 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, her rota için yolculuk süresi, hız okuma aralıkları (SRIs) ve rota geometrisini içeren zaman serisi verileri olarak sağlanır. Bu veriler BigQuery aracılığıyla depolanır ve bunlara erişilir.
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:
- 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.
- Analytics Hub API'yi etkinleştirin. Analytics Hub API başlıklı makaleyi inceleyin.
- Gerekli IAM rollerini verin. Hesabınızın, abone görevlerini gerçekleştirmek ve veri kümeleri oluşturmak için aşağıdaki rollerin bulunduğundan emin olun:
- Analytics Hub Abonesi (
roles/analyticshub.subscriber) - BigQuery Kullanıcısı (
roles/bigquery.user)
- Analytics Hub Abonesi (
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 özel 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:
- 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.
- Google Cloud Console'da veri değişimi ayrıntılarını inceleyin.
- İletişim kutusunda Abone ol düğmesini tıklayın.
- 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ümesi altında 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 alışverişine 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
Aşağıda, BigQuery tablosu historical_travel_time için şema verilmiştir:
| Ad | Mod | Tür | Açıklama |
|---|---|---|---|
| selected_route_id | NULLABLE | Dize | selected_route_id rotanın |
| 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 |
Tablo davranışları ve gerçekleri
- Tablo, güne göre bölümlendirilmiştir ve her bölüm için 10 yıllık bir geçerlilik bitiş tarihi belirlenmiştir.
- Tablo, toplu olarak yazılan en son trafik verileriyle saatte bir güncellenir.
- Roads Selection API'de yeni bir rota oluşturulduktan sonra, bu tablodaki verilerin kullanılabilir hale gelmesi için 1 saat 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 kalı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'dan farklı olarak bu tabloda SpeedReadingInterval verileri de bulunur. BigQuery'deki şema:
| Ad | Mod | Tür | Açıklama |
|---|---|---|---|
| selected_route_id | NULLABLE | Dize | selected_route_id rotanın |
| 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 | Rota boyunca trafik yoğunluğunu gösteren aralıklar. Routes API'deki orijinal tanıma bakın. |
| speed_reading_intervals.interval_coordinates | TEKRARLANAN | GEOGRAPHY | Bu aralığın geometrisi |
| speed_reading_intervals.speed | NULLABLE | Dize | Bu aralık için hız sınıflandırması. Olası değerler: NORMAL, SLOW, TRAFFIC_JAM |
Tablo davranışları ve gerçekleri
- Tablo, güne göre bölümlendirilmiştir ve her bölüm için 60 günlük bir geçerlilik süresi belirlenmiştir.
- Tablo, toplu olarak yazılan en son trafik verileriyle saatte bir güncellenir.
- Roads Selection API'de yeni bir rota oluşturulduktan sonra, bu tablodaki verilerin kullanılabilir hale gelmesi için 1 saat kadar beklemeniz gerekebilir.
- Bir rota, Roads Selection API'den silindikten sonra bu rota için tabloya yeni veri yazılmaz. Ancak geçmiş veriler, geçerlilik süresi dolana kadar kalır.
routes_status tablo
Tabloda, seçilen rotaların meta verileri ve durum bilgileri yer alır. Tüm rotaları ve durumları daha kolay görüntüleme olanağı sunmayı amaç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 | selected_route_id rotanın |
| 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 |
Tablo davranışları ve gerçekleri
- Bu tabloya yalnızca STATE_RUNNING veya STATE_INVALID durumundaki rotalar dahil edilir.
- Rotaların meta verileri ve durumu saatte bir kez 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 saate kadar beklemeniz gerekebilir.