地図カスタマイズ 手順書
FormBridge のフォームに地図を表示し、利用者が指定した位置の緯度・経度を kintone に保存するまでの手順です。
できること
- フォーム上のラベルの位置に地図を表示します。
- 地図をタップ(クリック)した位置の緯度・経度を、指定したフィールドに自動で入力します。
- 初期位置は「固定の位置」または「利用者の現在地」から選べます。
- 地図の左上に現在地ボタンを表示します。
- 緯度・経度フィールドは、利用者が直接書き換えられないよう読み取り専用になります。
- スマートフォンでは地図の幅が画面いっぱいになり、ボタンは指で押しやすい大きさ(44px 以上)で表示されます。
設定手順
-
kintone アプリに緯度・経度のフィールドを用意する
保存先の kintone アプリに、緯度用と経度用のフィールドを 1 つずつ追加します。
- フィールドの種類は「数値」または「文字列(1行)」を使います。
- 「数値」を使う場合は、小数点以下の桁数を 6 桁以上にしてください(約 10cm の精度です)。
- フィールドコードを控えておきます(例:
緯度、経度)。
-
FormBridge のフォームにフィールドと地図用ラベルを配置する
FormBridge のフォーム編集画面で、次の 3 つを配置します。
- 緯度フィールド
- 経度フィールド
- 地図を表示したい位置にラベルを置き、ラベルの文字として
mapのような半角の ID を入力します。この文字が地図に置き換わります。
ラベルを HTML で編集できる場合は
<div id="map"></div>のように要素の id として書いても動作します。ID はフォーム内の他の文字と重ならないもの(例:map、fbmap1)にしてください。 -
このツールでプログラムを作成する
地図カスタマイズ作成を開き、次の項目を入力します。
項目 入力する内容 ラベルID 手順 2 でラベルに入力した ID(例: map) 緯度・経度のフィールドコード 手順 1 で控えたフィールドコード 背景地図 地理院 標準地図/地理院 淡色地図/地理院 衛星写真 幅・高さ・ズーム 幅は %、高さは px。ズームは 15〜17 程度が目安です 初期値 「固定の位置」または「利用者の現在地」 ポイントの移動 初期値が現在地のとき、地図のタップで位置を変更できるかどうか 初期位置 地図をタップして指定。現在地を使う場合も、取得に失敗したときに表示する位置として必要です 「OK(プログラムを出力)」を押し、「.js ファイルをダウンロード」で
formbridge-map.jsを保存します。 -
FormBridge にファイルを登録する
- FormBridge で対象のフォームの編集画面を開きます。
- フォームの設定にある「JavaScript / CSS でカスタマイズ」を開きます。
- JavaScript の欄に、ダウンロードした
formbridge-map.jsを追加します。 - 設定を保存し、フォームを公開(更新)します。
画面の名称は FormBridge のバージョンによって異なる場合があります。詳しくは FormBridge の公式ヘルプ(新バージョン/旧バージョン)をご確認ください。出力したプログラムは新旧どちらのバージョンでも動作するよう作られています。
-
外部リソースの読み込みを許可する(制限している場合のみ)
フォームで外部リソースの読み込みを制限している場合は、次のホストを許可してください。
ホスト 用途 unpkg.com地図ライブラリ Leaflet(JavaScript・CSS)。「Leaflet を自動で読み込む」をオフにした場合は不要 cyberjapandata.gsi.go.jp地理院地図の地図画像 -
パソコンとスマートフォンで動作を確認する
- 公開フォームを開き、ラベルの位置に地図が表示されることを確認します。
- 地図をタップし、緯度・経度が入力されることを確認します。
- 現在地を使う設定の場合は、スマートフォンで位置情報の許可を求められることを確認します。
- テスト回答をして、kintone に緯度・経度が保存されることを確認します。
フォームでの動き
| 初期値 | ポイントの移動 | 動き |
|---|---|---|
| 固定の位置 | 常に可 | 初期位置を中心に地図を表示します。地図をタップすると、ピンが立ち、緯度・経度が入力されます。 |
| 利用者の現在地 | 可 | 現在地を取得して緯度・経度に入力します。その後、地図のタップやピンのドラッグで位置を変更できます。 |
| 利用者の現在地 | 不可 | 現在地を取得して緯度・経度に入力します。地図のタップでは変更できません。現在地ボタンで取得し直せます。 |
- 現在地の取得に失敗した場合は、初期位置を表示し、地図の下に理由を表示します。
- 確認画面から戻ったときなど、すでに緯度・経度が入っている場合はその位置を表示します。
- 現在地の情報は利用者の端末内でのみ使われ、入力された緯度・経度以外はどこにも送信されません。
うまく動かないとき
地図が表示されない
- ラベルの文字と「ラベルID」が完全に一致しているか確認してください(前後の空白や全角・半角の違いに注意)。
- ファイルが「JavaScript / CSS でカスタマイズ」に登録され、フォームが保存・公開されているか確認してください。
- 外部リソースの読み込みを制限している場合は、手順 5 のホストを許可してください。
緯度・経度が入力されない
- フィールドコードが正しいか確認してください。フィールド名(表示名)ではなく、フィールドコードを入力します。
- 緯度・経度フィールドがフォームに配置されているか確認してください。利用者に見せたくない場合も、フォームには配置しておく必要があります。
現在地が取得できない
- 端末の位置情報サービスと、ブラウザの位置情報の許可を確認してください。
- 一度「許可しない」を選ぶと、ブラウザの設定から許可し直す必要があります。
- 屋内などでは精度が低くなったり、時間がかかることがあります。
設定を変更したい
もう一度このツールでプログラムを作成し、FormBridge に登録済みのファイルを新しいファイルに差し替えてください。古いファイルは削除してください(2 つ登録すると地図が重複します)。
注意事項
- FormBridge の JavaScript カスタマイズはトヨクモ株式会社のサポート対象外です。本ツールで作成したプログラムも動作を保証するものではありません。必ず事前に動作確認を行ってください。
- 地図画像の表示のため、利用者の端末から国土地理院の地図配信サーバーへ通信が発生します。地理院タイルの利用条件は国土地理院のページをご確認ください。