CIFS spesifikasyonu
CIFS (Kapanma ve Olay Feed'i Spesifikasyonu), Waze'in iş ortaklarının feed'lerindeki olayları ve kapalı yolları açıklamak için kullandığı standart protokoldür.
Aşağıdaki parametre tablosunda her öğe şu şekilde sınıflandırılır:
- Zorunlu: Zorunlu bir etiket için düzgün biçimlendirilmiş bir değer olmadan feed'iniz geçersiz kabul edilir.
- İstenen: Teknik olarak gerekli olmasa da istenen etiketlerin kullanılması önerilir.
- İsteğe bağlı: Daha fazla veri sağlamanıza olanak tanıyan isteğe bağlı etiketler.
Dosyayı ayrıştıran motor için öğelerin sırası önemli değildir.
Bu etiketler, type etiketinin değerine göre bir Olay veya Yol Kapatma'yı tanımlayabilir.
Küçük farklılıklar, ilgili yerlerde açıklanmıştır.
Aşağıda, feed'deki yol kapatma örnekleri verilmiştir:
Aşağıda, feed'deki olay örnekleri verilmiştir:
Kapatma ve olay bilgilerini aynı feed dosyasında birleştirebileceğinizi unutmayın.
CIFS Öğeleri
| Öğe | Zorunlu | Etiket girişi | Açıklama |
|---|---|---|---|
| olay kimliği | Zorunlu | Serbest metin | Alfanümerik veya sayısal bir tanımlayıcı belirtir.
<incident id="LND11DEayKr">...</incident> |
| tür | Zorunlu | Ş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 pop-up bildirim tetikler ancak yönlendirme üzerinde doğrudan bir etkisi olmaz. <type>ROAD_CLOSED</type> |
| alt tür | İstek Tarihi | İzin verilen alt türlerin listesine bakın. | Bildirilen olayın türüyle ilgili daha ayrıntılı bir açıklama.
|
| polyline | Zorunlu | Boşlukla ayrılmış lat lon çiftlerinin listesi |
Olayın veya yol kapanmasının konumunu açıklayan ondalık derece (DD, projeksiyon SRID 4326) enlem ve boylam koordinatları. Yeterli doğruluk için ondalık işaretten sonra en az 6 basamak olmalıdır. Koordinatların sırası, etkilenen trafiğin yönünü yansıtmalıdır. Trafiğin yönünü tek bir noktadan çıkaramayız. Aşağıdaki çoklu çizgi, tek bir trafik yönünü etkiler (her iki yönü de etkilemek için <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 |
Aksaklığın veya kapanmanın yoldaki trafik yönlerinden birini mi yoksa her ikisini mi etkilediğini belirtir. Çoklu çizgi sağlansa bile yön bilgisi vermeniz kesinlikle önerilir. Yalnızca tek bir koordinat grubu sağlanabiliyorsa etkinliğin doğru sürüş yönünde gösterilmesi için yön alanı gereklidir. <direction>BOTH_DIRECTIONS</direction> |
| sokak | Zorunlu | Serbest metin | Etkinliğin gerçekleştiği caddenin veya yolun adını belirtir. <street>NW 12th St</street> |
| starttime | Zorunlu | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Bir kesinti döneminin başlangıç tarih ve saatini belirtir. ROAD_CLOSED türünde olmayan olaylar için bu öğeyi atlayabilirsiniz. Bu durumda, olayın şu anda etkin olduğu varsayılır. Zaman damgası, saniyelik ayrıntı düzeyinde ISO8601 biçiminde olmalı ve saat dilimi farkını içermelidir. <starttime>2023-04-07T09:00:00+01:00</starttime> |
| endtime | İstek Tarihi | yyyy-MM-dd'T'HH:mm:ss+HH:mm |
Bitiş tarih ve saatini saniye ayrıntı düzeyinde ISO8601 biçimini kullanarak belirtin ve saat dilimi farkını ekleyin. Bu değeri atlarsanız şu anda varsayılan olarak başlangıç zamanından 14 gün sonra ayarlanır. <endtime>2023-04-07T23:00:00+01:00</endtime> |
| açıklama | İstek Tarihi | Serbest metin | Trafik aksamasının nedeni. Bu açıklama 40 karakterden kısa olmalıdır. 40 karakterden uzun açıklamalar kabul edilir ancak Waze uygulamasında düzgün şekilde gösterilmeyebilir. <description>I-95 All NB lanes closed btwn Exits 184 and 186.</description> |
| şerit etkisi | isteğe bağlı | yapılandırılmış şerit etki bilgileri | Yalnızca olay tam yol kapanması değilse ve trafiğin tek bir yönünü etkiliyorsa şerit etkisine ilişkin veriler 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> |
| program | İsteğe bağlı | <dayname>hh:mm-hh:mm</dayname> |
Olayın tüm başlangıç ve bitiş tarih ve saatlerini kapsar. <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 Kapanma 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 |
|