premium
mapdata

過去地図管理情報検索

過去地図データの整備されている地区の属性、範囲情報の検索を行います。

緯度経度指定の場合、当該緯度経度が含まれる地図の整備年度と市区町村が全て返却されます。
※1994年～2020年のうち、ゼンリンが過去に整備していない年はデータが存在しないため返却されません。
※2021年以降は、ゼンリンの整備有無に関わらず一時点の全地区の状態を保存しているため必ず情報が返却されます。

地図描画を行う際は指定年度によって利用するマップタイプが異なります。
マップタイプの詳細は、こちらをご確認ください。

検索条件を複数指定した場合はAND結合となります。

※本APIを利用するには別途契約が必要です。

https://[domain]/search/mapdata

HTTP request method

POST/GET

ContentType

application/x-www-form-urlencoded

Parameters

名前	説明
word string	エリア名称を指定複数ワードはスペース区切りで指定してください。AND検索となります。最大文字数 255
word_match_type integer default 3	検索語句のマッチタイプを指定 1 完全一致 2 前方一致 3 部分一致
position array[number]	座標を指定 "経度,緯度"で指定してください。
pastmap_year array[integer]	過去地図年度を指定(複数指定可) ※地域と提供年の組み合わせについては「過去地図データ提供地区一覧表」をご参照ください。
pastmap_id array[integer]	過去地図管理IDを指定(複数指定可)
sort array[string] default pastmap_year	出力順を指定(複数指定可) デフォルトは昇順です。降順指定の場合、ソートキーの前方にマイナス(-)を付加してください。 pastmap_id 過去地図管理ID pastmap_year 過去地図年度 address_code2 都道府県コード address_code3 市区町村コード branch_code 枝コード地区によって住宅地図帳の冊子が分かれた場合に振られるコード area_name エリア名称
limit array[integer] default List[0,100]	検索結果取得件数を"オフセット,件数"で指定最大値 2000,1000
datum string default JGD	入出力座標の測地系を指定 JGD 世界測地系 TOKYO 日本測地系 TOKYO_NAVI 日本測地系(ゼンリンナビ地図)

Responses

エラーについては「エラーメッセージ一覧」を参照してください。

Media type:application/json

Status Code:200

キー名			説明
status string			ステータス
result	info	hit integer	検索結果総数
	item	pastmap_id integer	過去地図管理ID
		pastmap_year integer	過去地図年度
		address_code2 string	都道府県コード
		address_code3 string	市区町村コード
		branch_code integer	枝コード
		area_name string	エリア名称
		polygon_type integer	ポリゴン種別 2 市区町村 3 大字の結合ポリゴン 99 矩形ポリゴン
		position array[number]	["経度","緯度"]

Example

リクエストURL

https://[domain]/search/mapdata?word_match_type=3&position=139.723646,35.651638&limit=0,100&datum=JGD

レスポンス

{
  "status": "OK",
  "result": {
    "info": {
      "hit": 19
    },
    "item": [
      {
        "pastmap_id": 95131031,
        "pastmap_year": 1995,
        "address_code2": "13",
        "address_code3": "103",
        "branch_code": 1,
        "area_name": "東京都港区",
        "polygon_type": 3,
        "position": [
          139.731706000434,
          35.6747566731771
        ]
      },
      {
        "pastmap_id": 97131031,
        "pastmap_year": 1997,
        "address_code2": "13",
        "address_code3": "103",
        "branch_code": 1,
        "area_name": "東京都港区",
        "polygon_type": 3,
        "position": [
          139.751643608941,
          35.6580783420139
        ]
      },
      {
        "pastmap_id": 131031,
        "pastmap_year": 2000,
        "address_code2": "13",
        "address_code3": "103",
        "branch_code": 1,
        "area_name": "東京都港区",
        "polygon_type": 3,
        "position": [
          139.751599663628,
          35.658069390191
        ]
      },
      {
        "pastmap_id": 5131031,
        "pastmap_year": 2005,
        "address_code2": "13",
        "address_code3": "103",
        "branch_code": 1,
        "area_name": "東京都港区",
        "polygon_type": 2,
        "position": [
          139.751599663628,
          35.658069390191
        ]
      },
      ...
    ]
  }
}

premiummapdata