概要
地名の位置情報を取得するサービスを、ウェブAPIとして公開するものです。
地名データとして、縮尺1/25000相当の電子国土基本図のラベル情報を主に利用しているため、以下のような点にご注意ください。
- 検索できる地名は、およそ街区レベル(丁目)までです。(住居表示のようなレベルの検索には対応していません。)
- 検索結果の位置情報は、電子国土基本図のラベルの位置となります。例えば、「筑波山」の検索結果は、山頂ではなくラベルの位置が表示されます。
利用データ
本サービスでは、以下のデータを利用しています。
- 数値地図(国土基本情報)(平成30年)
http://www.gsi.go.jp/kibanjoho/kibanjoho40027.htmlこのサービスの作成に当たっては、国土地理院長の承認を得て、同院発行の数値地図(国土基本情報)電子国土基本図(地名情報)を使用した。(承認番号 平30情使、 第731号) - 国土数値情報:公共施設データ(平成18年)
http://nlftp.mlit.go.jp/ksj/gml/datalist/KsjTmplt-P02-v4_0.html - 国土数値情報:市区町村役場データ(平成26年)
http://nlftp.mlit.go.jp/ksj/gml/datalist/KsjTmplt-P34.html
使用方法
https://geospot.sakura.ne.jp/geocode/v1/search
リクエストパラメータ一覧
パラメータ | 値 | 説明 |
---|---|---|
query | string | 検索語:任意の文字列 |
category | string | 検索対象のカテゴリです。’居住地名’, ‘自然地名’, ‘交通施設’, ‘土地利用’, ‘公共施設’ から指定します。無指定のときは、すべて対象です。
例: |
results | integer | 最大取得件数(デフォルト: 20000、最大: 20000) |
output | string | 出力形式: ・ json – JSON形式(検索結果はgeojson)(デフォルト) ・ simple – 簡易出力(検索結果は配列) |
※ ‘category’のキーワードは、’query’に含めることもできます。
例:
「query=筑波山&category=自然地名」=「query=筑波山 自然地名」:筑波山を含む自然地名
「query=筑波山&category=-自然地名」=「query=筑波山 -自然地名」:自然地名を除く筑波山を含む地名
検索条件について
‘query’に渡す検索文字には以下のようなものが利用できます。
- つくば市東1
- 茨城県 埼玉県 小学校
都道府県、市区町村は複数指定できます。それらについてOR検索になります。 - %沢
ワイルドカードがつかえます。% : 任意の長さ(ゼロを含む)の文字列、_ : 任意の1文字 - 富_山
ワイルドカード例。「富士山」「富岡山」などに一致します。 - %ばる
読み仮名にもワイルドカードが使えます。※公共施設は、読み仮名検索に対応していません。 - 宮崎県 %ばる
宮崎県内の「**ばる」。※都道府県、市区町村はワイルドカードの対象外です。 - 宮崎県 %ばる 自然地名
宮崎県内の「**ばる」。自然地名のみ。 - 宮崎県 %ばる -自然地名
宮崎県内の「**ばる」。自然地名を除く。 - 廹 -曖昧検索
「-曖昧検索」を加えて異体字等の曖昧検索をしないようにできます。
レスポンスの例
json (デフォルト):
https://geospot.sakura.ne.jp/geocode/v1/search?query=筑波山&category=自然地名
{ result_info: { query_string: "筑波山", query: { prefecture: [ ], city: [ ], text: [ "筑波山" ], category: [ "自然地名" ] }, geodetic: "wgs1984", count: 1 }, results: [ { type: "Feature", geometry: { type: "Point", coordinates: [ 140.1012334, 36.2271778 ] }, properties: { name: "筑波山(茨城県 つくば市)", datasource_code: 1, datasource: "国土地理院「数値地図(国土基本情報)」", ftclass_code: 312, ftclass: "山地" } } ] }
simple:
https://geospot.sakura.ne.jp/geocode/v1/search?query=筑波山&category=自然地名&output=simple
{ result_info: { query_string: "筑波山", query: { prefecture: [ ], city: [ ], text: [ "筑波山" ], category: [ "自然地名" ] }, geodetic: "wgs1984", count: 1 }, results: [ [ 140.1012334, 36.2271778, "筑波山(茨城県 つくば市)", 1, 312 ] ] }
検索結果の利用例
地図アプリ等と組み合わせて利用した際のイメージの例を示します。
・「茨城県 埼玉県 小学校」の検索例
※検索条件に、都道府県名・市区町村名を複数入れた場合、それらについてOR検索となります。
利用条件
本サービスはどなたでも自由に利用できますが、利用にあたっては出典の記載をお願いします。
出典の記載方法は以下の通りです。
出典:地質図Navi地名検索サービス(https://geospot.sakura.ne.jp/wp/data/67/)
免責事項
- 本サービスを利用することによって生じたいかなる不利益・損害に対しても、サービス提供者は責任を負いません。
- サーバのメンテナンスやデータの更新などのため、無断で停止する場合があります。
- サーバの負荷の状況や維持の状況などにより、サービスの運用が難しいと判断した場合、予告無くサービスの提供を制限もしくは終了することがあります。
履歴
- 2018.12.3 Ver. 1.0 公開
- 2018.12.4 Ver. 1.1 よみがな検索対応。ワイルドカード対応。
- 2018.12.5 Ver. 1.11 曖昧検索を使わない設定を追加。