道路通行量（車）API (v1.1)

Download OpenAPI specification:Download

ジオテクノロジーズが保有する自動車通行量（道路を通行する自動車（バイクも含む）の台数の推計値）を、2022年1月分以降から取得できます。

取得対象	取得可能な最新データ
日指定	API利用日の前々日
月指定	API利用日の前月（月初2日目以降）

具体例について、下記をご確認ください。

API利用日	取得対象	取得可能な最新データ	備考
2023年10月2日	日指定	2023年9月30日
2023年10月2日	月指定	2023年9月	月初2日目より、前月分のデータが取得可
2023年11月1日	日指定	2023年10月30日
2023年11月1日	月指定	2023年9月	10月31日分のデータが無いため、10月分は取得不可
2023年11月2日	日指定	2023年10月31日
2023年11月2日	月指定	2023年10月	月初2日目より、前月分のデータが取得可

本APIのご利用に際しては、以下をご留意ください。

最新のデータは、更新日のAM中にデータ更新された後に、利用可能となります。
通行量を精度高く推計するためのGPSログが十分に集まっていない道路については、通行量推計の対象外です。
弊社データにて「細街路（区画街路などの沿道宅地利用の機能が強い道路や、普通車での離合が困難な狭い道路など、誘導案内に適さない道路）」として整備された道路は、通行量推計の対象外です。
渋滞により低速走行をしている場合でも、通行量の推計対象として処理されます。
※独自に自動車（バイクを含む）のログを抽出して集計対象としております
本APIは秒間10リクエスト（全エンドポイント合計）のレート制限をかけています。また本APIを連続実行する場合は、前回リクエスト分のレスポンスが返却されてから次のリクエストを実行するようにしてください。
本APIはシステムメンテナンスのため、火曜日 AM1:30～2:30前後に一時的にご利用いただけない場合があります。

道路通行量（車）API

エリアAPI

指定エリア（円）・指定期間に対して以下を提供します。

方向（上下線）別の道路形状とその平均通行量(台/時間)
エリア全体の時間別の平均通行量(台/時間)とユーザ属性ごとの平均通行者比率(運転手に限らず同乗者を含む)

以下のような利用用途を想定しています。

指定エリア・指定期間の全体の通行量をグラフ化する
指定エリア・指定期間の方向（上下線）別の道路の通行量を道路形状と合わせて描画する
指定エリアの方向（上下線）別の道路形状を取得し、後述の道路APIで通行量をグラフ化したい道路を選択できるようにする

Authorizations:

api_key

query Parameters

center

required

string

探索円の中心座標

形式

center=<経度>,<緯度>
世界測地系(JGD2011)のdegree形式で記述してください。

パラメータ	値
経度	浮動小数 (100.0〜160.0)
緯度	浮動小数 (0.0〜66.0)

入力例

center=139.703360,35.69363

radius

required

integer [ 1 .. 2000 ]

探索半径（m）

形式

radius=<半径>

入力例

radius=2000

month

integer

取得対象の月

month または date のいずれかの指定が必須です。
month と date の両方同時の指定はできません。

利用日の前月まで指定可能です。
最新のデータは各月2日のAM中にデータ更新された後に、利用可能となります。
例) 利用日が2023年8月15日の場合、202307まで指定可能

形式

month=YYYYMM

入力例

month=202210

date

integer

取得対象の日付

month または date いずれかの指定が必須です。
month と date の両方同時の指定はできません。

利用日の前々日まで指定可能です。
最新のデータは各日のAM中にデータ更新された後に、利用可能となります。
例) 利用日が2023年8月15日の場合、20230813まで指定可能

形式

date=YYYYMMDD

入力例

date=20221001

day_of_week

string

取得対象の曜日

month が指定された時のみ指定可能です。
未指定の場合は全曜日(all)となります。

形式

day_of_week=<曜日>
指定できる曜日は以下です。

値	意味
sun	日曜日
mon	月曜日
tue	火曜日
wed	水曜日
thu	木曜日
fri	金曜日
sat	土曜日
week	平日（月火水木金）
holi	休日（土日）
all	全曜日

入力例

day_of_week=week

time_range

string

取得対象の時間帯

3時間単位で探索時間帯を指定可能です。未指定の場合は全時間帯(00:00-23:59)となります。

形式

time_range=<開始時間帯>,<終了時間帯>
指定できる時間帯は以下です。

値	意味
1	00:00-02:59
2	03:00-05:59
3	06:00-08:59
4	09:00-11:59
5	12:00-14:59
6	15:00-17:59
7	18:00-20:59
8	21:00-23:59

入力例

time_range=3,5

上記の記述で06:00-14:59の期間を探索します。

offset

integer [ 0 .. 10 ]

道路形状のオフセット距離（m）

弊社データ整備において「双方向通行可能な一条道路」として定義された道路について、通行量を方向（上下線）ごとに分けて描画できるように、指定されたパラメータの距離の分だけ通行方向の左側に離した位置の道路形状を取得できます。
未指定の場合は距離0mとなります。

「単方向のみ通行可能な道路」（高速道路本線や中央分離帯などで物理的に上下線が分かれている二条道路、および、一方通行の一条道路）は、本パラメータを指定してもオフセットされません。

本パラメータは、見栄えが最適になるよう地図の表示スケールに合わせて設定していただく想定です。
本パラメータを指定せず、クライアント側で任意のオフセット距離で上下線を分けて描画することも可能です。

形式

offset=<距離>

入力例

offset=5

header Parameters

x-api-key

required

string

APIキーによる認証を行います。
弊社より提供されたAPIキーを記述してください。

Responses

Response samples

200

Content type

application/json

Example

month

{"type": "FeatureCollection",
"features": [{"type": "Feature",
"geometry": {"type": "LineString",
"coordinates": [[139.703619,
35.693458
],
[139.703537,
35.693271
]
]
},
"properties": {"tr": 123,
"link_id": -12345,
"road_class": 1
}
}
],
"properties": {"tr_mon_3": 121,
"tr_mon_4": 125,
"ratio_mon_3_10_m": 0.025,
"ratio_mon_3_10_f": 0.015,
"ratio_mon_3_20_m": 0.065,
"ratio_mon_3_20_f": 0.075,
"ratio_mon_3_30_m": 0.145,
"ratio_mon_3_30_f": 0.085,
"ratio_mon_3_40_m": 0.155,
"ratio_mon_3_40_f": 0.08,
"ratio_mon_3_50_m": 0.16,
"ratio_mon_3_50_f": 0.065,
"ratio_mon_3_60_m": 0.095,
"ratio_mon_3_60_f": 0.015,
"ratio_mon_3_70_m": 0.015,
"ratio_mon_3_70_f": 0.005,
"ratio_mon_4_10_m": 0.025,
"ratio_mon_4_10_f": 0.015,
"ratio_mon_4_20_m": 0.065,
"ratio_mon_4_20_f": 0.075,
"ratio_mon_4_30_m": 0.145,
"ratio_mon_4_30_f": 0.085,
"ratio_mon_4_40_m": 0.155,
"ratio_mon_4_40_f": 0.08,
"ratio_mon_4_50_m": 0.16,
"ratio_mon_4_50_f": 0.065,
"ratio_mon_4_60_m": 0.095,
"ratio_mon_4_60_f": 0.015,
"ratio_mon_4_70_m": 0.015,
"ratio_mon_4_70_f": 0.005,
"center": "139.703360,35.69363",
"radius": 2000,
"month": 202210,
"day_of_week": "mon",
"time_range": "3,4",
"offset": 5
}
}

道路API

指定の道路・指定期間に対して以下を提供します。

エリアAPIで取得した道路リンクID指定の道路の、時間別の平均通行量(台/時間)とユーザ属性ごとの平均通行者比率(運転手に限らず同乗者を含む)

以下のような利用用途を想定しています。

前述の道路APIで取得した道路からグラフ化したい道路を選択し、通行量をグラフ化する

Authorizations:

api_key

query Parameters

link_id

required

string

方向（上下線）別の道路のリンクID

道路リンクIDは、道路API実行の直前にエリアAPIから取得したものを指定してください。道路リンクIDはデータ更新により変化する場合がありますので、古くなった道路リンクIDを指定すると正常にデータを取得できない場合があります。

形式

link_id=<道路リンクID>

入力例

link_id=-12345

month

integer

取得対象の月

month または date のいずれかの指定が必須です。
month と date の両方同時の指定はできません。

利用日の前月まで指定可能です。
最新のデータは各月2日のAM中にデータ更新された後に、利用可能となります。
例) 利用日が2023年8月15日の場合、202307まで指定可能

形式

month=YYYYMM

入力例

month=202210

date

integer

取得対象の日付

month または date いずれかの指定が必須です。
month と date の両方同時の指定はできません。

利用日の前々日まで指定可能です。
最新のデータは各日のAM中にデータ更新された後に、利用可能となります。
例) 利用日が2023年8月15日の場合、20230813まで指定可能

形式

date=YYYYMMDD

入力例

date=20221001

day_of_week

string

取得対象の曜日

month が指定された時のみ指定可能です。
未指定の場合は全曜日(all)となります。

形式

day_of_week=<曜日>
指定できる曜日は以下です。

値	意味
sun	日曜日
mon	月曜日
tue	火曜日
wed	水曜日
thu	木曜日
fri	金曜日
sat	土曜日
week	平日（月火水木金）
holi	休日（土日）
all	全曜日

入力例

day_of_week=week

time_range

string

取得対象の時間帯

3時間単位で探索時間帯を指定可能です。未指定の場合は全時間帯(00:00-23:59)となります。

形式

time_range=<開始時間帯>,<終了時間帯>
指定できる時間帯は以下です。

値	意味
1	00:00-02:59
2	03:00-05:59
3	06:00-08:59
4	09:00-11:59
5	12:00-14:59
6	15:00-17:59
7	18:00-20:59
8	21:00-23:59

入力例

time_range=3,5

上記の記述で06:00-14:59の期間を探索します。

offset

integer [ 0 .. 10 ]

道路形状のオフセット距離（m）

弊社データ整備において「双方向通行可能な一条道路」として定義された道路について、通行量を方向（上下線）ごとに分けて描画できるように、指定されたパラメータの距離の分だけ通行方向の左側に離した位置の道路形状を取得できます。
未指定の場合は距離0mとなります。

「単方向のみ通行可能な道路」（高速道路本線や中央分離帯などで物理的に上下線が分かれている二条道路、および、一方通行の一条道路）は、本パラメータを指定してもオフセットされません。

本パラメータは、見栄えが最適になるよう地図の表示スケールに合わせて設定していただく想定です。
本パラメータを指定せず、クライアント側で任意のオフセット距離で上下線を分けて描画することも可能です。

形式

offset=<距離>

入力例

offset=5

header Parameters

x-api-key

required

string

APIキーによる認証を行います。
弊社より提供されたAPIキーを記述してください。

Responses

Response samples

200

Content type

application/json

Example

month

{"type": "Feature",
"geometry": {"type": "LineString",
"coordinates": [[139.703619,
35.693458
],
[139.703537,
35.693271
]
]
},
"properties": {"tr_mon_3": 121,
"tr_mon_4": 125,
"ratio_mon_3_10_m": 0.025,
"ratio_mon_3_10_f": 0.015,
"ratio_mon_3_20_m": 0.065,
"ratio_mon_3_20_f": 0.075,
"ratio_mon_3_30_m": 0.145,
"ratio_mon_3_30_f": 0.085,
"ratio_mon_3_40_m": 0.155,
"ratio_mon_3_40_f": 0.08,
"ratio_mon_3_50_m": 0.16,
"ratio_mon_3_50_f": 0.065,
"ratio_mon_3_60_m": 0.095,
"ratio_mon_3_60_f": 0.015,
"ratio_mon_3_70_m": 0.015,
"ratio_mon_3_70_f": 0.005,
"ratio_mon_4_10_m": 0.025,
"ratio_mon_4_10_f": 0.015,
"ratio_mon_4_20_m": 0.065,
"ratio_mon_4_20_f": 0.075,
"ratio_mon_4_30_m": 0.145,
"ratio_mon_4_30_f": 0.085,
"ratio_mon_4_40_m": 0.155,
"ratio_mon_4_40_f": 0.08,
"ratio_mon_4_50_m": 0.16,
"ratio_mon_4_50_f": 0.065,
"ratio_mon_4_60_m": 0.095,
"ratio_mon_4_60_f": 0.015,
"ratio_mon_4_70_m": 0.015,
"ratio_mon_4_70_f": 0.005,
"link_id": -12345,
"month": 202210,
"day_of_week": "mon",
"time_range": "3,4",
"offset": 5,
"road_class": 1
}
}

変更履歴

日付	内容
2024年8月29日	・本APIのレート制限を追記・レート制限超過時のエラーレスポンスを追記