MapFan+(マップファンプラス) 外部連携仕様

MapFan+(マップファンプラス)は2016年11月17日をもちまして販売終了いたしました。 また、2017年7月末日をもちましてサービス終了いたします。

iOSアプリケーション「MapFan+」における、地図やルートを表示する外部連携仕様について解説します。

本外部連携仕様は、外部から「MapFan+」アプリケーションを起動して、地図表示や、ルート表示をさせるためのものです。

この連携仕様を利用することにより、iPhone/iPad/iPod touch 上で外部のiOSアプリケーションやウェブサイトから「MapFan+」の起動、指定した場所の地図の表示、指定した複数点を通るルート表示ができるようになります。
また、各種パラメータにより、起動時の状態を細かく指定することができます。

連携には、「URLスキーム」という仕組みを利用します。詳細な仕様は以下のとおりです。

注意事項・お願い

◆注意事項
<利用規約について>
本外部連携仕様を使用する前に、以下の利用規約を必ずご確認ください。
本連携仕様を使用した時点で、利用規約に同意されたものとみなします。

<免責事項>
本仕様は予告無く変更する場合があります。
また、本連携機能は予告無く停止する場合があります。

<動作保証について>
外部連携により「MapFan+」が呼び出された際、「MapFan+」が起動している状態(バックグラウンド起動含む)では、アプリの表示状態によって、全て指定どおりに動作するとは限りません。

◆お願い
アプリケーションからの連携時に「MapFan+」アプリが存在しなかった場合の処理として、下記URLを表示するようにしてください。

https://itunes.apple.com/jp/app/mapfan+/id551921916?mt=8

※AppStoreの「MapFan+」のページです

機能仕様

◆URLスキーム
[URLスキーム] mapfanplus:

文字コード: UTF-8
パラメータ指定方法: パラメータの値はURLエンコードして指定すること。

◆パラメータ一覧

パラメータ名 パラメータ和名 必須 入力値条件 対応アプリ
Ver
説明
TYPE 起動タイプ × AS 1.0.0 「MapFan+」が以下のどのモードで起動するかを指定する。
AS:通常起動
MV:地図表示
RS:ルート探索
FS:フリーワード検索
CS:周辺検索
※「起動タイプ」が未指定の場合は、「AS」指定時と同様の挙動となる。
MV 1.0.0
RS 1.0.0
FS 1.2.0
CS 1.2.0
MP 地図中心座標 △1
△3
半角数字,
半角カンマ,
半角ピリオド
1.0.0 「地図表示」で利用する「地図中心座標」の「緯度経度」を指定する。
「地図中心座標」は以下のフォーマットで指定するものとする。
・パラメータ書式:【緯度】,【経度】
・測地系:WGS84
・緯度経度書式:Degree
※△1:「起動タイプ」が「MV」の場合に必須パラメータとなる。
※△3:「起動タイプ」が「CS」、かつ、「MP」未指定の場合には、MapFan+が取得している最新の現在地を「MP」として利用する。

例)MP=35.682085,139.766221
MS 地図表示スケール × double型 1.0.0 「地図表示」で利用する「地図表示スケール」を指定する。
「地図表示スケール」は以下の値をとり得るものとする。
0 < MS <= 1.0
※未指定の場合は、「MapFan+」通常起動時に利用する値を利用する。

スケール例(目安)と指定値
1/3125スケール:0.00032
1/6250スケール:0.00016
1/12500スケール:0.00008
1/25000スケール:0.00004
1/50000スケール:0.00002
1/100000スケール:0.00001
BG 出発地 × 半角数字,
半角カンマ,
半角ピリオド
1.0.0 「ルート探索」で利用する「出発地」の「緯度経度」を指定する。
「出発地」は以下のフォーマットで指定するものとする。
・パラメータ書式:【緯度】,【経度】
・測地系:WGS84
・緯度経度書式:Degree

※「出発地」が未指定の場合は、「MapFan+」が取得している最新の「現在地」を「出発地」として採用する。

例)BG=35.682085,139.766221
PS1 立寄地1 × 半角数字,
半角カンマ,
半角ピリオド
1.0.0 「ルート探索」で利用する「立寄地1」の「緯度経度」を指定する。
「立寄地1」は以下のフォーマットで指定するものとする。
・パラメータ書式:【緯度】,【経度】
・測地系:WGS84
・緯度経度書式:Degree

例)PS1=35.682085,139.766221
PS2 立寄地2 × 半角数字,
半角カンマ,
半角ピリオド
1.0.0 「ルート探索」で利用する「立寄地2」の「緯度経度」を指定する。
「立寄地2」は以下のフォーマットで指定するものとする。
・パラメータ書式:【緯度】,【経度】
・測地系:WGS84
・緯度経度書式:Degree

例)PS2=35.682085,139.766221
PS3 立寄地3 × 半角数字,
半角カンマ,
半角ピリオド
1.0.0 「ルート探索」で利用する「立寄地3」の「緯度経度」を指定する。
「立寄地3」は以下のフォーマットで指定するものとする。
・パラメータ書式:【緯度】,【経度】
・測地系:WGS84
・緯度経度書式:Degree

例)PS3=35.682085,139.766221
PS4 立寄地4 × 半角数字,
半角カンマ,
半角ピリオド
1.0.0 「ルート探索」で利用する「立寄地4」の「緯度経度」を指定する。
「立寄地4」は以下のフォーマットで指定するものとする。
・パラメータ書式:【緯度】,【経度】
・測地系:WGS84
・緯度経度書式:Degree

例)PS4=35.682085,139.766221
PS5 立寄地5 × 半角数字,
半角カンマ,
半角ピリオド
1.0.0 「ルート探索」で利用する「立寄地5」の「緯度経度」を指定する。
「立寄地5」は以下のフォーマットで指定するものとする。
・パラメータ書式:【緯度】,【経度】
・測地系:WGS84
・緯度経度書式:Degree

例)PS5=35.682085,139.766221
ED 目的地 △2 半角数字,
半角カンマ,
半角ピリオド
1.0.0 「ルート探索」で利用する「目的地」の「緯度経度」を指定する。
「目的地」は以下のフォーマットで指定するものとする。
・パラメータ書式:【緯度】,【経度】
・測地系:WGS84
・緯度経度書式:Degree

※△2:「起動タイプ」が「RS」の場合に必須パラメータとなる。

例)ED=35.682085,139.766221
BGN 出発地名称 × 全半角文字
最大文字数256文字
1.0.0 「出発地」の表示用の名称を指定する。
「起動タイプ」が「RS」、かつ、「出発地」が設定された場合に有効となる。
PS1N 立寄地1名称 × 全半角文字
最大文字数256文字
1.0.0 「立寄地1」の名称を指定する。
「起動タイプ」が「RS」、かつ、「立寄地1」が設定された場合に有効となる。
PS2N 立寄地2名称 × 全半角文字
最大文字数256文字
1.0.0 「立寄地2」の名称を指定する。
「起動タイプ」が「RS」、かつ、「立寄地2」が設定された場合に有効となる。
PS3N 立寄地3名称 × 全半角文字
最大文字数256文字
1.0.0 「立寄地3」の名称を指定する。
「起動タイプ」が「RS」、かつ、「立寄地3」が設定された場合に有効となる。
PS4N 立寄地4名称 × 全半角文字
最大文字数256文字
1.0.0 「立寄地4」の名称を指定する。
「起動タイプ」が「RS」、かつ、「立寄地4」が設定された場合に有効となる。
PS5N 立寄地5名称 × 全半角文字
最大文字数256文字
1.0.0 「立寄地5」の名称を指定する。
「起動タイプ」が「RS」、かつ、「立寄地5」が設定された場合に有効となる。
EDN 目的地名称 × 全半角文字
最大文字数256文字
1.0.0 「目的地」の表示用の名称を指定する。
「起動タイプ」が「RS」、かつ、「目的地」が設定された場合に有効となる。
RC ルート種別 × 1 1.1.0 ルート検索結果画面で、どのルートを最初に表示するか指定する。
「起動タイプ」が「RS」の場合に有効。
1:有料優先
2:有料回避
3:自転車・徒歩
※「起動タイプ」が未指定の場合は、最後に表示したルートが表示される。
2 1.1.0
3 1.1.0
KW 検索キーワード × 全半角文字
最大文字数256文字
1.2.0 「フリーワード検索」「周辺検索」の検索条件となる「キーワード」を指定する。
「起動タイプ」が「FS」、または、「CS」のときに有効となる。

URLスキーム起動サンプル

◆通常起動

mapfanplus:

◆地図表示

東京スカイツリーを中心とした地図
mapfanplus:/?TYPE=MV&MP=35.710058%2C139.810718&MS=0.000008

◆ルート探索

東京ディズニーランドから東京都庁までのルート
mapfanplus:/?TYPE=RS&BG=35.632546%2C139.881328&BGN=%E6%9D%B1%E4%BA%AC%E3%83%87%E3%82%A3%E3%82%BA%E3%83%8B%E3%83%BC%E3%83%A9%E3%83%B3%E3%83%89&ED=35.688742%2C139.691774&EDN=%E6%9D%B1%E4%BA%AC%E9%83%BD%E5%BA%81&RC=1

◆フリーワード検索

キーワード「スターバックス 渋谷」での検索結果
mapfanplus:/?TYPE=FS&KW=%e3%82%b9%e3%82%bf%e3%83%bc%e3%83%90%e3%83%83%e3%82%af%e3%82%b9%e3%82%b3%e3%83%bc%e3%83%92%e3%83%bc%20%e6%b8%8b%e8%b0%b7

◆周辺検索(緯度経度指定あり)

キーワード「銀行」で品川駅の周辺検索結果
mapfanplus:/?TYPE=CS&MP=35.628199%2C139.738702&KW=%e9%8a%80%e8%a1%8c

◆周辺検索(緯度経度指定なし)

キーワード「トイレ」で現在地の周辺検索結果
mapfanplus:/?TYPE=CS&KW=%e3%83%88%e3%82%a4%e3%83%ac

変更履歴

[2013/05/20] フリーワード検索、周辺検索の項目を追加

[2013/04/08] ルート種別の項目を追加

[2013/02/25] 新規公開