日本の山岳一覧・百名山 API を開発しました CLICK !
mountix API - 日本の山岳一覧・百名山 API

mountix API – 日本の山岳一覧・百名山 API

mountix API 日本の主な山岳一覧 の情報を提供します。

mountix API – v1.1.0

mountix API では「日本の主な山岳一覧」をAPIで提供します。

山 – Mountain – と何かをかけあわせる – X – という意味を込めた、RESTful API です。

また、日本の主な山岳一覧に記載された情報に百名山に属する山であるかを独自に追加しました。

そのため、百名山の情報のみを抽出することも可能です。

日本の主な山岳一覧について

国土交通省 国土地理院が掲載している「日本の主な山岳一覧」をもとにデータを作成し、APIで提供します。

API ドキュメント

mountix API – ドキュメント ご確認ください。

サンプル・使用例

山岳情報を検索する – /api/v1/mountains

百名山一覧を取得する

クエリパラメータtag1を指定することで、百名山の一覧を取得することができます。

https://mountix.codemountains.org/api/v1/mountains?tag=1

二百名山一覧を取得する

クエリパラメータtag2を指定することで、二百名山の一覧を取得することができます。

https://mountix.codemountains.org/api/v1/mountains?tag=2

都道府県で検索する

クエリパラメータprefectureに都道府県IDを指定することで、その都道府県にある山の一覧が取得できます。

都道府県IDについては、「都道府県ID一覧 – mountix API」を参照してください。

https://mountix.codemountains.org/api/v1/mountains?prefecture=20

山岳名・山岳名(かな)で検索する

クエリパラメータnameに山岳名・山岳名(かな)を指定することで、山岳名・山岳名(かな)の部分一致検索した山の一覧が取得できます。

https://mountix.codemountains.org/api/v1/mountains?name=白馬
https://mountix.codemountains.org/api/v1/mountains?name=ふじ

複数の検索条件を組み合わせる

複数のクエリパラメータを指定することで以下のような検索が可能です。

長野県にある百名山
https://mountix.codemountains.org/api/v1/mountains?tag=1&prefecture=20
長野県にある名前に白が含まれる山
https://mountix.codemountains.org/api/v1/mountains?prefecture=20&name=白

ページングに対応する

クエリパラメータoffsetlimitを指定することで、ページングに対応可能です。

1ページ目・10件表示
https://mountix.codemountains.org/api/v1/mountains?offset=0&limit=10
2ページ目・10件表示
https://mountix.codemountains.org/api/v1/mountains?offset=10&limit=10

山岳一覧の並べ替え

クエリパラメータsortkey.orderの形式で指定することで、山岳一覧の並べ替えが可能です。

keyでは以下の値を指定することができます。
  • id:ID
  • elevation:標高
  • name:山岳名
orderでは昇順、もしくは降順を指定することができます。
  • asc:昇順
  • desc:降順
標高の降順
https://mountix.codemountains.org/api/v1/mountains?sort=elevation.desc
山岳名の昇順
https://mountix.codemountains.org/api/v1/mountains?sort=name.asc

山岳情報を取得する – /api/v1/mountains/{mountainId}

富士山の山岳情報を取得

検索で取得した山岳情報のidをパスパラメータに指定します。

https://mountix.codemountains.org/api/v1/mountains/396
{
    "id": 396,
    "name": "富士山<剣ヶ峯>",
    "nameKana": "ふじさん<けんがみね>",
    "area": "富士山とその周辺",
    "prefectures": [
        "山梨県",
        "静岡県"
    ],
    "elevation": 3776,
    "location": {
        "latitude": 35.36083333333333,
        "longitude": 138.7275,
        "gsiUrl": "https://maps.gsi.go.jp/#15/35.36083333333333/138.7275"
    },
    "tags": [
        "百名山"
    ]
}

周辺の山岳情報を検索する – /api/v1/mountains/{mountainId}/surroundings

槍ヶ岳の周辺 3 km以内に存在する山岳情報を検索する

distanceの初期値は5000mのため、distance=3000を指定します。

https://mountix.codemountains.org/api/v1/mountains/533/surroundings?distance=3000

長方形の地理空間に存在する山岳情報を検索する – /api/v1/mountains/geosearch

剱岳近辺の山岳情報を検索する

長方形を示す地理空間を (左下隅の経度,左下隅の緯度),(右上隅の経度,右上隅の緯度) の形式で、box=(137.632582,36.600727),(137.601829,36.631957)を指定します。

経度、緯度の順番で座標を指定するように注意してください。

https://mountix.codemountains.org/api/v1/mountains/geosearch?box=(137.632582,36.600727),(137.601829,36.631957)

また、tagで百名山(= 1)または二百名山(= 2)の山のみを検索したり、

nameで山岳名の部分一致検索したりできます。

https://mountix.codemountains.org/api/v1/mountains/geosearch?box=(137.632582,36.600727),(137.601829,36.631957)&tag=1

開発ロードマップ

今後の機能追加・改善の予定を開発ロードマップとして公開します。

Done
クエリパラメータに offset・limit を追加する

ページングに対応します。

対応完了しました。

Done
クエリパラメータ name でかな検索を可能にする

山岳名のみではなく、山岳名(かな)での検索を可能にします。

対応完了しました。

Done
山岳名や標高でのソートを可能にする

クエリパラメータに sort を追加し、ID(= デフォルト)・山岳名・標高でのソートを可能にします。

対応完了しました。

Done
タグに二百名山を追加する

山岳情報のタグに二百名山を追加し、百名山だけでなく二百名山一覧の取得を可能にします。

対応完了しました。

三百名山のタグ追加については、日本の主な山岳一覧に記載がない山が含まれるため対応を見送りました。

利用規約

mountix 利用規約

この規約は、利用者が、codemountains(以下「運営者」)が提供する「mountix」サービス(以下「本サービス」)をご利用頂く際の取扱いにつき定めるものです。本規約に同意した上で本サービスをご利用ください。

第 1 条(定義)
本規約上で使用する用語の定義は、次に掲げるとおりとします。
(1)本サービス:運営者が運営するサービス及び関連するサービス
(2)本サイト:本サービスのコンテンツが掲載されたウェブサイト
(3)本コンテンツ:本サービス上で提供される文字、音、静止画、動画、ソフトウェアプログラム、コード等の総称(投稿情報を含む)
(4)利用者:本サービスを利用する全ての方

第 2 条(本規約への同意)
1 利用者は、本利用規約に同意頂いた上で、本サービスを利用できるものとします。
2 利用者が、プログラムほかその他の手段を用いてAPIへのアクセスを行った時点で本規約へ同意したものとみなします。

第 3 条(規約の変更)
1 運営者は、利用者の承諾を得ることなく、いつでも、本規約の内容を改定することができるものとし、利用者はこれを異議なく承諾するものとします。
2 運営者は、本規約を改定するときは、mountix の Webサイト(https://dottrail.codemountains.org/lp/mountix-api/)に掲載します。
3 前本規約の改定の効力は、運営者が前項により通知を行った時点から生じるものとします。
4 利用者は、本規約変更後、本サービスを利用した時点で、変更後の本利用規約に異議なく同意したものとみなされます。

第 4 条(利用者情報の収集)
運営者はアクセスログならびにCookieなどにより、利用者の情報を収集することがあります。

第 5 条(個人情報等の取り扱い)
個人情報及び利用者情報については、運営者が別途定める「プライバシーポリシー」に則り、適正に取り扱うこととします。

第 6 条(禁止行為) 
本サービスの利用に際し、運営者は、利用者に対し、次に掲げる行為を禁止します。運営者において、利用者が禁止事項に違反したと認めた場合、アクセス禁止など運営者が必要と判断した措置を取ることができます。
(1)運営者または第三者の知的財産権を侵害する行為
(2)運営者または第三者の名誉・信用を毀損または不当に差別もしくは誹謗中傷する行為
(3)運営者または第三者の財産を侵害する行為、または侵害する恐れのある行為
(4)運営者または第三者に経済的損害を与える行為
(5)運営者または第三者に対する脅迫的な行為
(6)マルウェアなど有害なプログラムの使用またはそれを誘発する行為
(7)本サービス用インフラ設備に対して過度な負担をかける行為
(8)本サービスへのサイバー攻撃や不正アクセス行為
(9)運営者が公式に提供しているAPI以外の方法でデータベースなどへアクセスを試みる行為
(10)上記の他、運営者が不適切と判断する行為

第 7 条(免責)
1 運営者は、本サービスの不具合、仕様変更、中断、終了によって生じたいかなる損害についても、一切責任を負いません。
2 運営者は、利用者の本サービスの利用環境について一切関与せず、また一切の責任を負いません。
3 運営者は、本サービスが利用者の特定の目的に適合すること、期待する機能・商品的価値・正確性・有用性を有すること、利用者による本サービスの利用が利用者に適用のある法令または業界団体の内部規則等に適合すること、および不具合が生じないことについて、何ら保証するものではありません。
4 運営者は、本サービスを利用したことにより直接的または間接的に利用者に発生したあらゆる損害について、一切賠償責任を負いません。
5 運営者は、利用者その他の第三者に発生した機会逸失、業務の中断その他いかなる損害(間接損害や逸失利益を含みます)に対して、運営者が係る損害の可能性を事前に通知されていたとしても、一切の責任を負いません。
6 第1項乃至前項の規定は、運営者に故意または重過失が存する場合又は契約書が消費者契約法上の消費者に該当する場合には適用しません。
7 前項が適用される場合であっても、運営者は、過失(重過失を除きます。)による行為によって利用者に生じた損害のうち、特別な事情から生じた損害については、一切賠償する責任を負わないものとします。 
8 利用者は、本サービスの利用に関連し、第三者に損害を与えた場合または第三者との間に紛争を生じた場合、自己の費用と責任において、かかる損害を賠償またはかかる紛争を解決するものとし、運営者には一切の迷惑や損害を与えないものとします。
9 利用者が本サービスの利用に関連して運営者に損害を与えた場合、利用者の費用と責任において運営者に対して損害を賠償(訴訟費用及び弁護士費用を含む)するものとします。

第 8 条(権利譲渡の禁止)
1 利用者は、予め運営者の書面による承諾がない限り、本規約上の地位および本規約に基づく権利または義務の全部または一部を第三者に譲渡してはならないものとします。
2 運営者は、本サービスの全部または一部を運営者の裁量により第三者に譲渡することができ、その場合、譲渡された権利の範囲内で利用者情報を含む、本サービスに係る利用者の一切の権利が譲渡先に移転するものとします。

第 9 条(分離可能性)
本規約のいずれかの条項又はその一部が、各種法令等により無効又は執行不能と判断された場合であっても、本規約の残りの規定及び一部が無効又は執行不能と判断された規定の残りの部分は、継続して完全に効力を有するものとします。

第 10 条(運営者への連絡方法)
本サービスに関する利用者の運営者へのご連絡・お問い合わせは、本サービスまたは運営者が運営するwebサイト内の適宜の場所に掲載する連絡先または運営者が別途指定する方法により行うものとします。

第 11 条(準拠法、管轄裁判所)
1 本規約の有効性,解釈及び履行については,日本法に準拠し,日本法に従って解釈されるものとする。 2 運営者と利用者等との間での論議・訴訟その他一切の紛争については、訴額に応じて、東京簡易裁判所又は東京地方裁判所を専属的合意管轄裁判所とします。

2021年12月22日 施行

プライバシーポリシー

mountix プライバシーポリシー

mountix が収集する情報は以下の通りです。
・アクセスしたユーザのIPアドレス、リファラ、時刻など、一般的な Web 閲覧ソフトウェアやプログラムがサーバに対して HTTP 通信をする際に送信する情報
・Google Analytics が収集する情報

mountix は収集した情報を以下の目的で使用します。
・サービスを改善するため
・不正利用に対処するため(アクセス禁止措置など)

mountix は収集した情報を第三者に開示しません。ただし、以下の場合を除きます。
・Google Analyticsによる解析を行うため、Google 社にデータを提供する場合
・ユーザが同意した場合
・運営者が情報を開示すべき法的責任を負う場合
・運営者、ユーザ、第三者などの権利や財産を保護するために必要であると運営者が判断した場合

Google Analytics についてはこちらをご覧ください。

お問い合わせ

お問い合わせはこちら、もしくは @codemountains までお願いします。