道路通行量(歩行者)API (v1.1)

Download OpenAPI specification:Download

ジオテクノロジーズが保有する歩行者通行量(道路を通行する歩行者の人数の推計値)を、2022年1月分以降から取得できます。

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

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

API利用日 取得対象 取得可能な最新データ 備考
2024年4月2日 月指定 2024年3月 月初2日目より、前月分のデータが取得可
2024年5月1日 月指定 2024年3月 2024年4月のデータはまだないため、前月分のデータは取得不可
2024年5月2日 月指定 2024年4月 月初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 .. 1000 ]
探索半径(m)

形式

radius=<半径>

入力例

radius=1000
month
required
integer
取得対象の月

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

形式

month=YYYYMM

入力例

month=202310
day_of_week
string
取得対象の曜日

未指定の場合は全曜日(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の期間を探索します。

header Parameters
x-api-key
required
string

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

Responses

Response samples

Content type
application/json
{
  • "type": "FeatureCollection",
  • "features": [
    ],
  • "properties": {
    }
}

道路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
required
integer
取得対象の月

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

形式

month=YYYYMM

入力例

month=202310
day_of_week
string
取得対象の曜日

未指定の場合は全曜日(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の期間を探索します。

header Parameters
x-api-key
required
string

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

Responses

Response samples

Content type
application/json
{
  • "type": "Feature",
  • "geometry": {
    },
  • "properties": {
    }
}

変更履歴

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