こんにちは、ジオテクノロジーズ株式会社カスタマーサクセス担当です。
日々、MapFan APIサポート窓口へ様々なご質問をいただく中で、「この点、もっと分かりやすくお伝えできていれば...」と気づかされることが多々あります。
そこで今回、2025年度下半期にいただいたご質問を振り返り、特にお問い合わせの多かったTOP3をまとめました。
少しでも皆様のお役に立ちましたら幸いです。
第3位：「どの道路情報がどのAPIから取得できるの?」道路情報取得ガイド
Q. 寄せられた声：
「勾配度や車線数はどのAPIで取れますか?」
「緯度経度から標高値と交差点名を取得したいのですが...」
「制限速度の情報はどこから取得できる?」
「海上の橋の標高って取れるの?」
MapFan APIには様々な道路情報を取得できるAPIが用意されていますが、「どの道路情報がどのAPIで取得できるのか」という疑問が第3位にランクインしました。
A．MapFan APIで取得できる道路情報
MapFan APIでは様々な道路情報を取得できます。
本記事では、お問い合わせの多かった以下のデータについてご紹介します。
-🏔️道路標高
-🛣️ 車線数
-🚗制限速度
-🚦交差点名称
🏔️ 道路標高
取得可能API：ルート検索API（標高値付きオプション）
取得方法：・出発地と目的地を指定してルート検索を実行
・elevationパラメータを設定
レスポンス形式：ルート検索情報の後に、緯度経度と標高値がセットで返却
注意点：
✅ オプション契約が必要です
⚠️ 直進区間などルート形状点が無い地点の道路標高値は取得できません
⚠️ 全ての道路に対して標高値を取得できるわけではありません（標高データの整備が完了していない場合など）
⚠️ データ品質により不正な急勾配(30%以上)が返却される場合あります(全体の約0.1%)
🌉 橋の標高
✅ルート形状点が橋上に付与されている場合
→ その地点の標高値が取得可能です
⚠️ ルート形状点がない橋の場合
→ 橋の中心付近の標高値を取得したい場合は、橋の出口と入口の標高値から按分計算を行い、
算出していただく必要があります
※ただし、算出した標高値は現実の標高値と異なる可能性がある点、ご了承ください
🛣️ 車線数
取得可能API：マップマッチングAPI
取得方法：GPS軌跡データを入力してマッチング実行
🚗 制限速度
取得可能API：マップマッチングAPI
取得方法：GPS軌跡データを入力してマッチング実行
🚦 交差点名称
交差点名が整備されている場合、取得が可能です。
ただし、交差点名の取得は少し複雑で、複数の方法がありますが、それぞれに注意点があります。
方法1: マップマッチングAPI ⭐おすすめ
条件：GPS軌跡が交差点を必ず通過する必要あり
注意点：1点のGPS座標では取得不可
方法2: ルート検索API
条件：交差点を通過するルートを引く必要あり
方法3：周辺道路情報取得API
利点：交差点近くの緯度経度1点で取得可能
注意点：
道路リンクが交差点手前で細かく分割されている場合は取得できないケースがあります
⛰️ 【補足】勾配度
MapFan APIでは勾配度を直接取得することはできません。
代替方法：
ルート形状点の標高値を元に、形状点 A から形状点 B に、何メートル進む間に
何メートル上がるかで簡易的に勾配を計算することができます。
※ただし、算出した勾配度は現実の勾配度と異なる可能性がある点、ご了承ください。
📚 各APIの詳しい仕様を確認するには
「どのAPIがどのような仕様なのか」という詳細については、MapFan API の技術仕様書に詳しく記載されています。
MapFan API 技術仕様書のダウンロード：
・ご契約中の方：MapFan Developers Supportの『ダウンロード』から※要アカウント・要ログイン
・未契約の方：ジオテクノロジーズ公式サイトの『MapFan API仕様書をダウンロードする』から
サポートチームより：
実際の運用シーンに応じた最適なAPI選択については、個別にご相談いただくことも可能です。
「この使い方で合っているか確認したい」
「この情報を取得したいけど、どうやったらいいのか分からない」
などのご質問がございましたら、いつでもサポートまでお問い合わせください。
🎯 まとめ：サポートチームは皆さんの味方です
今回ご紹介した内容は、実際に多くのお客様からいただいたご質問です。
「もしかして、こんなこと聞いていいのかな...」と思われたことがあったかもしれませんが、どんな小さな疑問でも、どうぞお気軽にお問い合わせください。
サポートチームは、皆さんがMapFan APIをスムーズにお使いいただけるよう、全力でサポートいたします。
MapFan APIサポートについて
MapFan APIの製品仕様に関するお問い合わせは、専用サポートサイトにてお問い合わせを承っております。
サポートサイトでは、仕様書のダウンロードやアップデート情報の確認、社内メンバーの問い合わせ履歴も含め、過去のやり取りをすべて確認できます。
URL：https://developers.mapfan.com/hc/ja
※アカウント登録が必要となります
※アカウント登録依頼や登録前にご質問の方はなんでも相談窓口へご連絡ください
※専用サポートサイトの詳細についてはこちら（https://geot.ent.box.com/file/1971741513251?s=zn6pxpm4697gdiag8injp8jwbgli78xy）よりご確認いただけます
他のランキング記事はこちら：