「しずみち info」API による道路情報のオープンデータ提供 API

データ活用方法

1. API 利用の概要
静岡市では道路に関連する情報を提供する「しずみち info」にて、API よりリアルタイムにオープンデータを提供しています。この API では動的データとして道路規制情報や災害情報、アンダーパスのデータを API よりご自由に利用できます。また、静的データとして道路台帳などの提供を行っており、静的データは合わせて Shape でダウンロードできます。詳細は下記 Wiki サイトに記載してあります。
本資料では動的データである道路規制情報、災害情報、アンダーパスを利用するためのデータの説明をします。API の利用方法については下記 Wiki で確認願います。

【運営中】API 利用の Wiki サイト

API によるオープンデータ提供の Wiki サイト（運用中）
http://opendata-api-wiki-dot-shizuokashi-road.appspot.com/


いつでも、自由に利用できます。
オープンデータ CC BY 4.0 のもと提供です（無料）。
利用方法は Wiki の利用ガイドをご覧ください。

【データ取得 URL】主な提供道路データ

道路情報の API URL
災害情報

静岡市が管理している道路上で発生した災害情報
https://openapi.city.shizuoka.jp/opendataapi/servicepoint/disaster

道路規制情報静岡市が管理している道路で道路管理者が把握する道路規制情報
https://openapi.city.shizuoka.jp/opendataapi/servicepoint/roadRegulation

アンダーパス冠水水位

静岡市が管理している冠水の危険があるアンダーパスの冠水水位やポンプの稼働状況
https://openapi.city.shizuoka.jp/opendataapi/servicepoint/underpath【取得データについて】

取得データは「GeoJSON」です
クリエイティブ・コモンズ・ライセンス 表示

CC BY 4.0 のもと提供です（無料）1道路情報のデータ取得例
ここでは Wiki のサンプルプログラムを利用した道路情報のデータ取得例を主に記載します。

2. 事前準備（1） Wiki の利用ガイドと API リファレンスでデータ取得について確認（2） データ詳細はオープンデータ一覧で確認
Wiki サイト
Wiki サイト（3） Wiki サイトのサンプルプログラムで取得データの確認ができます。
サンプルプログラムは以下の手順で利用できます。
②③

取得したい URL を入力
今回、道路規制情報の URL を入力「受信」を押下①

地図上で、表形式で、JSON で取得データの確認可能

Wiki サイト（4） 認証キーの発行ができます。
認証キーがない場合は利用者全体で 10 秒あたり 10 回までの利用になります。
認証キーを利用することで、利用者毎に 10 秒あたり 10 回までの利用が可能になります。
Wiki サイト2

3. 道路規制情報について（1） 道路規制情報の生成するための元データについて
道路規制情報の規制区間である LineString の地物形状は静岡市が所有している道路台帳の道路網図基盤（以下、「道路網図」という。）より生成しています。道路網図のデータは Wiki のオープ
ンデータ一覧より Shape ファイルでダウンロードすることができます。
道路網図は静岡市の道路管理上およびデータの２次利用を可能とすることを目的として基本データとして採用しました。
道路網図より規制区間を生成していることから、データ利用をする際にいくつかの注意すべき事項があります。その例をいくつか記載します。
① 静岡市の管理道路
しずみち info で提供するデータは静岡市管理道路内になります。政令市は通常市が管理すべき道路の他、都道府県と同様の管理権限を所有します。静岡市が管理しない代表的な道路としては、NEXCO が管理する高速道（市内では新東名高速道路、東名高速道路）、国交省が管理する直轄国道（市内では国道 1 号、国道 52号）、港などの港湾施設の道路（静岡県管理の清水港臨港道路）、一般有料道路（静岡市ではありません）、施設内道路や私道などがあります。
赤線 市以外の管理道路
青線 静岡市の管理道路
図１．管理道路© QGIS© 地理院タイル（https://maps.gsi.go.jp/development/ichiran.html）② DRM との比較
道路網図は DRM と異なり、あくまでも道路の基本的事項を示した台帳データとした道路管理用地図データであり、DRM のノード、リンクなどのネットワーク構成を持っていません。また、道路の路線を管理するため、起点、終点で示す路線網になっており、路線が交わらない交差点が発生します。

© QGIS図２．道路網図例（交差点を確認）

●

起点

●

終点

青線 道路網図3赤枠

二条道路の違い

なお、道路網図では二条道路な
ど DRM では上下線分離されている道路でも同一路線名であるために中心線を通っています。
そのため、高規格道路など二条道路の上下線分離などが単一線で表現されます。

赤線：DRM青線：道路網図
図３．DRM と道路網図の比較© QGIS

分離帯で構成分離

道路規制情報での規制区間は工事や災害により規制をかける実際の場所を示すため、DRMの Link の区間全てに規制を必ずかけるわけではないと考えています。そのため、ネットワーク構成を持っていなくてもいいのではないかという、考えにたっています。

公園で構成分離

図４．図３の航空写真© QGIS青線：道路網図© 地理院タイル（https://maps.gsi.go.jp/development/ichiran.html）③ 規制データの地図上の精度
道路規制情報のデータを生成している道路網図と DRM や
例えばゼンリンの地図の道路Google Map

では地図上の精度が異なります。特に山間部での精度の違いが顕著に表れます。
道路網図

そのため、道路規制情報のデータを例えばカーナビに活DRM© Google© 2018 ZENRIN CO,LTD (Z18JG 第 062 号)

用する場合、道路網図とリンク ID との紐づけもないため、

図５．道路網図と道路台帳、Google Map の重ね合わせ（静岡市葵区横沢地内）
4

ナビのデータとの差異を考慮する必要があると思われます。

（2） 扱っている規制種別と規制原因について
しずみち info で扱っている規制種別は下記の通りです。なお、規制種別を示すアイコンは Wiki
サイトより取得することが可能です（しずみち info で利用）。
表１．規制種別
規制種別 regulation_type

アイコン

説明

全面通行止

全面通行止め片側交互通行

２車線の道路で上下線の片側路線のみを通行可として、上下線の車両を交互に通行する規制

大型車両通行止

大型車両の全面通行止め

チェーン必要積雪、凍結などにより、冬用タイヤもしくはタイヤチェーンなどの装着が必要

夜間通行止

夜間のみ全面通行止め

時間帯全面通行止

時間帯によって全面通行止めを実施し、全面通行止めを実施してない時間は通行可能

片側通行止

上下線いずれかを全面通行止め

車線減少

複数車線ある場合、一部車線の規制を行う車線減少

その他規制

その他規制

規制なし

規制をかけない工事を実施している場合―

なお、夜間通行止めは時間帯全面通行止めの一種と考えてもよく、わかりやすく情報提供するために作成しています。データ作成をする職員によっては夜間通行止めを時間帯全面通行止めで記載する可能性もあります。
規制原因を大きく分けて工事、災害等、気象条件、事前通行規制に分けられます。火災やその他もありますが、道路管理者として利用することはありません。
表２．主な規制区分と規制原因
規制区分
category

規制原因
reason工事

工事（道路）

工事（占用）

工事（復旧）

工事（河川）

災害等

災害（土砂災害）

災害（河川災害） 災害（浸水害） 災害（倒木）

災害（橋梁）

気象条件

気象条件

事前通行規制雨量

積雪

工事（作業）

災害（道路）

波高5

（3） 道路規制情報の JSON 表示例について
ここでは道路規制情報のうち、規制種別が「全面通行止」、「時間帯全面通行止」、「夜間通行止」、「片側通行止」を例にして、取得できる JSON を説明します。
① 全面通行止
ここでは災害起因による全面通行止めの JSON 例を記載します。
参考 URLhttps://openapi.city.shizuoka.jp/opendataapi/servicepoint/roadRegulation?regulation_type=全面通行止&category=災害等

regulation_type で規制種別を示します。ここでは全面通行止です。
規制原因の項目

mid_point の座標値は規制区間の中間ポイントです。しずみち info ではここに規制アイコンを配置しています。
start_date は災害に起因する場合と工事に起因する場合とでは異なります。災害の場合は、災害が発生し通行止めにす時間帯全面通行止
夜間通行止で利用する項目る必要があると判断した時の日時になります。現地確認をしたのちに登録する場合もあるので、情報提供を受けた時間を規制開始とした場合はデータを提供
開始した時間と start_date は異なります。end_date は規制終了の予定日で災害起因の場合はほとんど提供されません。clear_date は実際に規制が終了した日時になるので、実際に提供されることはありません。
rldated_files では写真や PDF などの添付ファイルで公開されたデータのみを提供します。
opne_flags はしずみち info で公開されている情報かを示します。

地物の緯度経度
以下に続く

図６．災害原因による全面通行止の JSON 例6

② 時間帯全面通行止
参考 URLhttps://openapi.city.shizuoka.jp/opendataapi/servicepoint/roadRegulation?regulation_type=時間帯全面通行止

regulation_type は時間帯全面通行止の場合です。
start_date は工事の場合では規制が始まった日時もしくは、始まる予定日時になります。end_date は規制終了の予定日になります。
clear_date は実際に規制が終了した日時になるので、実際に提供されることはありません。工事の場合はVICS データと同様、更新の課題があります（後述記載）。
timezones は通行止めをかける時間帯になります。工事による時間帯全面通行止の場合には、ある時間帯は車を通行させて、工事を行っている時間は全面通行止にする対応をしており、その表現になります。なお、日中帯を全て工事のため規制をかけることもあり、その例を図８に示し地物の緯度経度ます。

以下に続く

図７．工事による時間帯全面通行止めの JSON 例

図８．日中帯を通行止めする時間帯全面通行止めの JSON 例

7

③ 夜間通行止
参考 URLhttps://openapi.city.shizuoka.jp/opendataapi/servicepoint/roadRegulation?regulation_type=夜間通行止

regulation_type は夜間通行止の場
合です。
この規制では時間帯により規制が変わるため、public_memo にて一般公開用にその説明を記載しています。
timezones では夜間に全面通行止をかけるため、規制時間帯を記載しています。職員によっては時間帯全面通行止で記載する可能性があり、データ利用の際は「時間帯全面通行止」と「夜間通行止」は同意味で扱ったほうがいいかもしれません。

地物の緯度経度
以下に続く

図９．夜間通行止めの JSON 例④ 片側通行止
片側通行止めは上下線分離している路線にて、どちらか一方の規制をかける場合です。
矢印の向いている方向が通行止め「上り」「下り」のどちらかを通行止め

終点始点© Google© 2018 ZENRIN CO,LTD (Z18JG 第 062 号)

図 10．片側通行止めのしずみち info での登録画面例

8

参考 URL
https://openapi.city.shizuoka.jp/opendataapi/servicepoint/roadRegulation?regulation_type=片側通行止

regulation_type は片側通行止の場合です。
図 10 のとおり矢印の向いている方向
で通行止めをかけますが、LineStringでは最初の緯度経度が通行止めの始点、最後の緯度経度が通行止めの終点を示します。
な お 、 こ の 規 制 で は 写 真 がrelated_files に 格 納 さ れ て お り 、location が写真、thumbnail _location
がサムネイルを示します。

公開ファイルのみ提供
Open_flag 1

写真画像例 1.22Mb

サムネイル画像
規制の起点© Google© 2018 ZENRIN CO,LTD (Z18JG 第 062 号)

規制の終点

図 11．片側通行止の JSON 例
9

（4） 道路規制情報の更新頻度について
道路規制情報の更新頻度ですが、データは登録された時にそのままオープンデータ提供されていきます。ただし、データの内容上 1sec や 10sec などの精度が必要ではないと考えています。
事前通行規制に関する通行止めは道路管理者の判断になるため、道路管理者である静岡市のデータが一番早い提供になります。VICS 提供路線であれば 静岡市から 道路交通情報センターもしくは交通管制センター（以下、「交通管理者など」という。）へ情報提供後に反映されると思われます。
なお、平成 26 年時に（財）道路交通情報通信システムセン
ターの光ビーコン設置路線および FM 多重放送提供路線をもとに作成した VICS 提供の想定を図 12 に示します。ただし、実際の提供される路線は把握していません。

© Google© QGIS図 12．静岡市内の VICS 提供想定路線（平成 26 年）
赤線 VICS 提供想定路線

白線 静岡市管理道路

災害に伴う規制は、静岡市が把握してしずみち info 上に登録した時点でオープンデータ提供されます。
災害に伴う規制は以下のような形で情報を把握することが多いと考えており、これは後述の災害情報の収集も併せて行われることを想定しています。


地域の方々、道路利用者、地元建設業者などから道路管理者（静岡市）への情報提供→ 職員などが現場に向かい状況確認 → 現場確認後、規制を検討し登録



情報が入った警察、交通管理者、消防機関などから道路管理者（静岡市）へ情報提供→ 職員などが現場に向かい状況確認 → 現場確認後、規制を検討し登録

道路管理者（静岡市）のパトロールにて災害を発見→ このまま情報収集に移ります → 現場確認後、規制を検討し登録



情報を得た報道機関のニュースにより道路管理者（静岡市）などが情報把握
災害に伴う規制は静岡市からのオープンデータ提供が早い情報と考えています。なお、災害情報を登録しつつ道路規制情報の登録をしなかったことが過去ありました。特に冠水に伴う規制はエリアで冠水しており時間により水が引いていくことから、対応が難しいです。また、災害に伴う道路規制が終了したにも関わらずそのまま道路規制情報が残っていることもあります。

10

工事に伴う道路規制情報は規制が始まる前から予告情報として提供することができます。その場合は規制が始まるのを start_date で判断します。なお、工事に伴う規制は雨には工事を実施しないことや土日に休工するなど、現場の状況や気象条件によって変わってきます。予め多くの周知を行う高速道路や国管理道路の規制と異なり、受注業者がコントロールしていきます。そのため、規制が始まっても毎日の更新の把握が難しく、山間部の迂回が難しい路線を除き、始まった期間のうちの何日か規制をかけるといった工事が多いのが現状です。
この解決策として、平成 29 年度より工事の受注業者が現場でリアルタイムに規制・解除を登録できるシステムを試験的に運用しています。平成 30 年度はさらに対応工事を拡大実施をして、情報精度を高めていく予定です。なお、現在はこの解除データは API によるオープンデータ提供をしていないため、平成30 年度に提供できるよう検討の予定です。
© Google© 2018 ZENRIN CO,LTD (Z18JG 第 062 号)

図 13．しずみち info 解除表示例
なお、この工事に伴う道路規制情報ですが、現在は静岡市内でも NEXCO 管理の高速道路および国交省管理道路の提供はされていません。また、道路管理者の工事情報を提供しており、占用工事の規制情報も提供されていません。今後は規制の伴う管工事（水道、下水道、ガス）の提供が課題であると考えています。

4. 災害情報について
災害情報は point のデータになります。災害情報の位置情報は災害現場にてタブレットで情報登録する場合は GPS の位置情報を参考に Google Map 上で職員が地点選択をしていきます。特に険峻な山あいでは GPS の衛星が補足できない場合も考慮して、最終的には職員が地点選択をするようにしました。また、PC 上では Google Map 上で職員が地点選択をしますが、電話により通報があった場合は、職員が住所から検索して付近の地点を登録することもあります。
（1） 扱っている災害種別について
しずみち info で扱っている災害原因は「災害等」、「気象条件」、「火災」、「その他」に区分を別けており、道路管理者として現在、「災害等」と「気象条件」を利用します。
災害等と気象条件の詳細は表３の通りです。災害種別は JSON 上では災害詳細（reasons）に格納されており、災害区分（type）、災害原因（reason）、災害原因の詳細（reason_detail）で表されています。このうち、災害原因の詳細は専門的な方々だけが利用することを想定しています。

11

表３．主な災害種別
災害詳細
災害区分
災害等

type

災害原因

reasonsreason

災害原因の詳細

災害（土砂災害）

法面崩壊,

reason_detaiol

落石,崩土,土石流,

河道閉塞,

道路冠水,浸水

路面陥没,路面隆起,電柱倒壊,信号機倒壊,脱線,

null

土砂堆積
災害（河川・浸水害）

破堤,

災害（倒木）

倒木

災害（橋梁）

橋梁損壊,

落橋

災害（道路災害）

道路亀裂,路肩崩壊,施設損壊,

沿道障害建物倒壊,水道管破裂,災害等

マンホール浮上,気象条件

気象条件

積雪・凍結,強風,霜,大雨,台風,洪水,高潮,越波,津波,地震,

null（2） 災害情報の JSON 表示例について
ここでは取得できる災害情報の JSON 例を説明します。
① 災害情報の JSON 例
参考 URLhttps://openapi.city.shizuoka.jp/opendataapi/servicepoint/disaster

災害の発生日時は occur_dateで示します。道路規制情報で記載したとおり、静岡市が災害を把握してしずみち info に登録した時点でオープンデータ提供
PDF の添付例されます。close_date は災害

サムネイルなし

が収束して工事に移行した場合公開ファイルのみ提供
Open_flag 1などで、災害情報が終了した場合に登録されるため、実際には提供されません。
related_files で添付ファイルが格納されますが、災害の詳細を伝えるための PDF なども添付されます。PDF ではサムネイルの提供はありません。
災害地点は Point ですので１つの緯度経度になります。

図 14．災害情報の JSON 例 その１12また、災害地点（場所）は町丁字もしくは近傍の住所をspot で提供します。
response_status は災害の対応状況で「未対応」、「指示出」、「応急済」、「保留」の４種類で現在の状況が把握できます。ただし、職員に浸透していない項目であるため、利用が少ないのが現状です。
図 15 では提供されている写真が非常に多い災害例になります。この災害では 11 枚の写真が提供されています。

交通解放後の写真

添付ファイル
地物の緯度経度
以下に続く発生当初の写真
図 15．災害情報の JSON 例 その２写真などの添付ファイルは公開されているものだけがオープンデータとして提供されます。
この公開の有無は添付ファイルだけでなく情報全体でも公開の有無が選択でき、情報全体の公開区分で open_flag：”0”で公開されていない情報の添付ファイルは提供されません。
② 災害情報の試験データ
災害情報は災害発生毎の登録になるため、提供データがないことが通常になります。
RestAPI による提供で常に最新情報を提供することが思想にあるため、過去の履歴データを取得することができません。
そこで、ダミーデータモードを用意して、災害情報に関しては試験データを取得できるようにしてあります。詳細は Wiki の API リファレンスを参照してください。
13

図 16．ダミーデータモードの説明（Wiki API リファレンス）このダミーデータモードで取得できるデータは平成 26 年 10 月に静岡県を横断した台風 18号で被害があった実際の災害情報になります。災害情報の件数はこの台風で 394 件に上っています。なお、写真などの添付ファイルの格納はありません。また、システムの運用を始めた当時の登録情報ですので表３に示した災害詳細（reasons）と異なる内容で登録されています。

災害の原因は１つでないことがある事例になります。ここでは路肩崩壊、法面崩壊、倒木が合わせて登録されています。

図 17．ダミーデータモードでの災害情報の取得例（5） 災害情報の更新頻度について
災害情報の更新頻度は前述の道路規制情報の更新頻度の記載の通りです。

14

5. アンダーパス冠水水位について（1） アンダーパス冠水水位の説明
静岡市では冠水の危険がある、鉄道や幹線道路をくぐるアンダーパスの冠水水位をクラウド上に収集し監視をしています。
これらのデータをオープンデータとして API より提供をしています。
扱っている主なデータとしては水位センサーの水位データと冠水の水位により「道路冠水」や「通行止め」の状態を示す警戒状態になります。なお、通信回線が断になり、アンダーパスの状況把握できない場合は警戒状態は「欠測」となります。
静岡市で監視をしているアンダーパスは 14 箇所。そのうち１箇所のアンダーパスでは２地点に分かれて冠水する可能性があるため、データは 15 地点の提供をしています。
アンダーパスの水位センサーは排水するためのポンプ設備がある建物のポンプ漕内に設置する場合（パターン１）とアンダーパスの道路最低面付近のポンプ設備が設置されているピット内に設置する場合（パターン２）があり、冠水が始まる前から水位状況を把握したいため、通常はマイナス（-）数値を持たせています。

センサー設置建物

センサー設置建物

図 18．パターン１・建物内のポンプ漕内に水位センサーが設置されている例（大坪）センサー設置個所
センサー設置個所

図 19．パターン２・道路最低面のピット内に水位センサーが設置されている例（興津東）
図 20、図 21 にはその概念図を示します。水位センサーの水位の基準はアンダーパスの道路最低面になります。データでは水位が 0cm で道路最低面まで水があり、冠水が始まった状態を示します。

15

0cm0cm

図 20．パターン１概念図

図 21．パターン２概念図

水位は通常時は地下水位などの影響もありますが、それほどの変動がありません。ただし、ゲリラ豪雨といった短時間強雨などにより排水能力を超えた場合には急速に水位が上がることがあります。例えば、平成 29 年６月 21 日には５つのアンダーパスが同時冠水をしています。下図の水位によりわかりますが、それまで水位変動がなかったのが突然変動するため、常時監視することが望ましいデータであると言えます。

図 22．巴町 2017/06/21

図 23．中之郷 2017/06/21

図 24．庵原川橋西 2017/06/2116なお、アンダーパスの冠水は降雨による原因の他にポンプ故障などの設備故障により地下水が排水できないため冠水する事象があることもわかっています。

図 25．平成 29 年６月 21 日の冠水状況（庵原川橋西）（2） アンダーパス冠水水位の JSON 表示例について
ここでは取得できるアンダーパス冠水水位の JSON 例を説明します。
参考 URLhttps://openapi.city.shizuoka.jp/opendataapi/servicepoint/underpath

observerpointname が観測点名称、アンダーパスの名称になります。また、路線名はroadname になります。
観測時刻は updatedate で示されます。
実際の冠水監視をしている代表点は Pointの緯度経度で示しています。
警戒状態は alertmode で示され、道路冠水で道路最低面の冠水が始まったこと、通行止めで車が通行するのに危険な水位となり通行止めにする水位を示します。また、欠測は電波状況や現地システムの故障などによりクラウド上にデータが収集できていないことを示します。
アンダーパスの実水位は waterlevel で示され、基準点はアンダーパスの道路最低面になります。通常はマイナス(-)表記になっています。

図 26．アンダーパス冠水水位の JSON 例

17このデータ取得にてアンダーパスの緯度経度より冠水水位が分かれば、ルート探索に反映することができると考えています。なお、アンダーパスの水位に伴い、道路のどの区間を規制すべきかのデータについては作成をしておりませんが、容易に作成できるデータであると考えています。

（3） アンダーパス冠水水位の更新頻度について
アンダーパス冠水水位のデータ更新は５分毎に自動的に更新
静岡市では冠水水位の取得は５分毎になります。そのため、API 提供するオープンデータも 5 分毎に提供しています。なお、システム連携によりオープンデータ提供のタイムラグが出てきます。

以上

18