地図カスタマイズ 手順書

FormBridge のフォームに地図を表示し、利用者が指定した位置の緯度・経度を kintone に保存するまでの手順です。

できること

設定手順

  1. kintone アプリに緯度・経度のフィールドを用意する

    保存先の kintone アプリに、緯度用と経度用のフィールドを 1 つずつ追加します。

    • フィールドの種類は「数値」または「文字列(1行)」を使います。
    • 「数値」を使う場合は、小数点以下の桁数を 6 桁以上にしてください(約 10cm の精度です)。
    • フィールドコードを控えておきます(例: 緯度、経度)。
  2. FormBridge のフォームにフィールドと地図用ラベルを配置する

    FormBridge のフォーム編集画面で、次の 3 つを配置します。

    • 緯度フィールド
    • 経度フィールド
    • 地図を表示したい位置にラベルを置き、ラベルの文字として map のような半角の ID を入力します。この文字が地図に置き換わります。

    ラベルを HTML で編集できる場合は <div id="map"></div> のように要素の id として書いても動作します。ID はフォーム内の他の文字と重ならないもの(例: map、fbmap1)にしてください。

  3. このツールでプログラムを作成する

    地図カスタマイズ作成を開き、次の項目を入力します。

    項目入力する内容
    ラベルID手順 2 でラベルに入力した ID(例: map)
    緯度・経度のフィールドコード手順 1 で控えたフィールドコード
    背景地図地理院 標準地図/地理院 淡色地図/地理院 衛星写真
    幅・高さ・ズーム幅は %、高さは px。ズームは 15〜17 程度が目安です
    初期値「固定の位置」または「利用者の現在地」
    ポイントの移動初期値が現在地のとき、地図のタップで位置を変更できるかどうか
    初期位置地図をタップして指定。現在地を使う場合も、取得に失敗したときに表示する位置として必要です

    「OK(プログラムを出力)」を押し、「.js ファイルをダウンロード」で formbridge-map.js を保存します。

  4. FormBridge にファイルを登録する

    1. FormBridge で対象のフォームの編集画面を開きます。
    2. フォームの設定にある「JavaScript / CSS でカスタマイズ」を開きます。
    3. JavaScript の欄に、ダウンロードした formbridge-map.js を追加します。
    4. 設定を保存し、フォームを公開(更新)します。

    画面の名称は FormBridge のバージョンによって異なる場合があります。詳しくは FormBridge の公式ヘルプ(新バージョン/旧バージョン)をご確認ください。出力したプログラムは新旧どちらのバージョンでも動作するよう作られています。

  5. 外部リソースの読み込みを許可する(制限している場合のみ)

    フォームで外部リソースの読み込みを制限している場合は、次のホストを許可してください。

    ホスト用途
    unpkg.com地図ライブラリ Leaflet(JavaScript・CSS)。「Leaflet を自動で読み込む」をオフにした場合は不要
    cyberjapandata.gsi.go.jp地理院地図の地図画像
  6. パソコンとスマートフォンで動作を確認する

    • 公開フォームを開き、ラベルの位置に地図が表示されることを確認します。
    • 地図をタップし、緯度・経度が入力されることを確認します。
    • 現在地を使う設定の場合は、スマートフォンで位置情報の許可を求められることを確認します。
    • テスト回答をして、kintone に緯度・経度が保存されることを確認します。

フォームでの動き

初期値ポイントの移動動き
固定の位置常に可初期位置を中心に地図を表示します。地図をタップすると、ピンが立ち、緯度・経度が入力されます。
利用者の現在地可現在地を取得して緯度・経度に入力します。その後、地図のタップやピンのドラッグで位置を変更できます。
利用者の現在地不可現在地を取得して緯度・経度に入力します。地図のタップでは変更できません。現在地ボタンで取得し直せます。

うまく動かないとき

地図が表示されない
  • ラベルの文字と「ラベルID」が完全に一致しているか確認してください(前後の空白や全角・半角の違いに注意)。
  • ファイルが「JavaScript / CSS でカスタマイズ」に登録され、フォームが保存・公開されているか確認してください。
  • 外部リソースの読み込みを制限している場合は、手順 5 のホストを許可してください。
緯度・経度が入力されない
  • フィールドコードが正しいか確認してください。フィールド名(表示名)ではなく、フィールドコードを入力します。
  • 緯度・経度フィールドがフォームに配置されているか確認してください。利用者に見せたくない場合も、フォームには配置しておく必要があります。
現在地が取得できない
  • 端末の位置情報サービスと、ブラウザの位置情報の許可を確認してください。
  • 一度「許可しない」を選ぶと、ブラウザの設定から許可し直す必要があります。
  • 屋内などでは精度が低くなったり、時間がかかることがあります。
設定を変更したい

もう一度このツールでプログラムを作成し、FormBridge に登録済みのファイルを新しいファイルに差し替えてください。古いファイルは削除してください(2 つ登録すると地図が重複します)。

注意事項

カスタマイズを作成する