CIFS spesifikasyonu
CIFS (Kapatma ve Olay Feed'i Spesifikasyonu), Waze'in İş Ortakları'nın feed'lerinde Olayları ve Yol Kapatmalarını tanımlamak için kullanılan standart protokolüdür.
Aşağıdaki parametre tablosu her bir öğeyi şu şekilde sınıflandırır:
- Zorunlu: Gerekli bir etiket için düzgün biçimlendirilmiş bir değer olmadığında feed'iniz geçersiz sayılır.
- İstendi: Teknik olarak gerekli olmasa da istenen etiketler önerilir.
- İsteğe bağlı: Daha fazla veri sağlamanıza olanak tanıyan isteğe bağlı etiketler.
Öğelerin sırası, dosyayı ayrıştıran motor için önemli değildir.
Bu etiketler, type
etiketinin değerine göre bir Olayı veya Yol Kapatmayı tanımlayabilir.
Küçük farklılıklar ilgili yerlerde açıklanmıştır.
Feed'deki yol kapanışlarına bazı örnekler aşağıda verilmiştir
Feed'deki olaylarla ilgili bazı örnekler aşağıda verilmiştir
Kapalı durumları ve olayları aynı feed dosyasına birlikte dahil edebileceğinizi unutmayın.
CIFS Öğeleri
Öğe | Gerekli | Etiket girişi | Açıklama |
---|---|---|---|
olay kimliği | Gerekli | Serbest metin | Alfanümerik veya sayısal bir tanımlayıcı belirtir.
<incident id="LND11DEayKr">...</incident> |
tür | Gerekli | Şunlardan biri:
ROAD_CLOSED
ACCIDENT
HAZARD
POLICE
CHIT_CHAT
JAM
|
Tür, etkinliğinizin Waze uygulaması tarafından nasıl kullanılacağını belirler. Diğer tüm türler Waze haritasında gösterilir ve yakındaki Wazer'lar için bir pop-up bildirimi tetikler ancak rotayı doğrudan etkilemez. <type>ROAD_CLOSED</type> |
alt tür | İstek Tarihi | İzin verilen alt türlerin listesine bakın | Bildirilen olayın türü için daha kesin bir açıklama.
|
çoklu çizgi | Gerekli | Boş ayrılmış lat lon çiftlerinin listesi |
Ondalık Derece (DD, projeksiyon SRID 4326) enlem ve boylam koordinatlarıdır. Olayın veya yolun kapanmasının gerçekleştiği konumu ifade eder. Yeterli doğruluk için, ideal olarak ondalık noktasından sonra en az 6 basamak olmalıdır. Koordinatların sırası, etkilenen trafiğin yönünü yansıtmalıdır. Trafik yönü tek bir noktadan düşülemez. Aşağıdaki çoklu çizgi bir trafik yönünü etkiler (her iki yönü de etkilemek için bir <polyline>51.510090 -0.006902 51.509142 -0.006564 51.506291 -0.003640 51.503796 0.001051 51.499218 0.001687 51.497365 0.002020</polyline> |
direction | İstek Tarihi | BOTH_DIRECTIONS veya ONE_DIRECTION |
Kesintinin veya kapanmanın yoldaki trafik yol tariflerinden birini veya ikisini birden etkileyip etkilemediğini belirtir. Çoklu çizgi sağlanmış olsa bile yön belirlemeniz kesinlikle önerilir. Yalnızca tek bir koordinat kümesi sağlanabiliyorsa, etkinliğin doğru sürüş yönünde gösterildiğinden emin olmak için yön alanı gereklidir. <direction>BOTH_DIRECTIONS</direction> |
sokak | Gerekli | Serbest metin | Etkinliğin gerçekleştiği sokağın veya yolun adını belirtir. Waze haritasıyla eşleşmelidir. <street>NW 12th St</street> |
başlangıç zamanı | Gerekli | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Bir kesinti döneminin başlangıç tarihi ve saatini belirtir. Road_CLOSED türünde olmayan olaylar için bu etiketi çıkarabilirsiniz. Olayın şu anda devam ettiği varsayılır. Zaman damgası, saniye cinsinden ISO8601 biçiminde olmalı ve saat dilimi farkını içermelidir. <starttime>2023-04-07T09:00:00+01:00</starttime> |
bitiş zamanı | İstek Tarihi | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Bitiş tarihi ve saatini, ISO8601 biçimini kullanarak saniye cinsinden belirtin ve saat dilimi farkını ekleyin Bu değeri atlarsanız varsayılan olarak başlangıç zamanından 14 gün sonra olur. <endtime>2023-04-07T23:00:00+01:00</endtime> |
açıklama | İstek Tarihi | Serbest metin | Trafikteki aksaklığın nedeni. Bu açıklama 40 karakterden kısa olmalıdır. 40 karakterden uzun bir açıklama kabul edilir ancak Waze uygulamasında düzgün bir şekilde görüntülenmeyebilir. <description>I-95 All NB lanes closed btwn Exits 184 and 186.</description> |
şerit etkisi | isteğe bağlı | yapılandırılmış şerit etkisi bilgileri | Bunu yalnızca olayda yolun tamamen kapatılmaması durumunda sağlayın.
WZDx şerit biçimini veya benzer bir biçimi kullanarak bir şerit dizisi belirterek
tüm şeritler hakkında bilgi sağlayın.
Tam biçim örneği: <lanes> <lane> <order>1</order> <type>LANE</type> <status>CLOSED</status> </lane> <lane> <order>2</order> <type>LANE</type> <status>OPEN</status> </lane> </lanes> Kısmi biçim örneği: <lane_impact> <total_closed_lanes>2</total_closed_lanes> <roadside>RIGHT</roadside> </lane_impact> |
takvim | İsteğe bağlı | <dayname>hh:mm-hh:mm</dayname> |
Olay için tüm başlangıç ve bitiş tarih ve saatlerini içerir. <schedule> <monday>09:00-11:00,17:00-21:00</monday> <thursday>09:00-11:00,17:00-21:00</thursday> <friday>09:00-11:00,17:00-21:00</friday> <saturday>00:00-05:00</saturday> <sunday>09:00-18:00</sunday> </schedule> |
Olay ve Kapanış alt türleri
Olayın niteliğiyle ilgili daha fazla ayrıntı verin. Kabul edilebilir alt türler, sağlanan türe göre belirlenir.
Tür | Olası alt türler |
---|---|
ACCIDENT |
|
HAZARD |
|
ROAD_CLOSED |
|
JAM |
|
POLICE |
|