ジオスタジオ 詳細マニュアル

基本情報

プラグインID	geo-studio
対象バージョン	v1.3.1(配布中の最新版)
カテゴリ	一覧画面カスタマイズ
説明	レコードの緯度経度や住所を、地図のピン表示と都道府県の色分けマップで可視化します。

動作条件

対応環境	kintone スタンダードコース(デスクトップ版UI)。最新版の Chrome / Edge / Safari / Firefox に対応。
動作画面	レコード一覧のカスタマイズビュー。指定したビューを開くとタブ切替の地図ビューが表示されます。
必要なフィールド	タイトルフィールド(ポップアップ等の見出し)のほか、使うビューに応じて: ピンマップ=緯度・経度の数値・計算または文字列(1行)×2、都道府県マップ=都道府県名または住所の文字列(1行)・ドロップダウン・ラジオボタン。ピンの色分けはドロップダウンまたはラジオボタン、統計バブルのサイズ基準・合計・平均の集計値には数値または計算フィールドを使います。
必要な権限	閲覧はレコード閲覧権限。一括ジオコーディングの実行(設定画面)にはアプリ管理権限と対象レコードの編集権限が必要です。

設定項目リファレンス

プラグイン設定の全項目です。「項目」は設定データ(エクスポートファイルの config)のキーを表し、[] は配列の要素を意味します。設定画面での入力項目と1対1に対応します。この構造の正式な定義はJSON Schema(catalog.json の configSchema)として公開しています。

設定のポイント

• targetView にはジオスタジオを表示するカスタマイズビューのビューIDを指定します。ビューのHTMLは空でかまいません。
• views(ビュー)は最大5個まで定義でき、配列の順序がタブの並び順、先頭のビューが初期表示になります。同じタイプのビューを軸や配色を変えて複数並べることもできます(例: 「顧客マップ」「売上バブル」)。設定画面のビューカードの複製ボタン(⧉)で、条件違いのビューを簡単に作れます。
• 緯度・経度は10進数(例: 緯度 35.6812 / 経度 139.7671)で保持してください。度分秒表記(35°40′52″など)は読み取れません。
• ピンマップの「表示方法」は ピン(既定) と 統計バブル から選べます。統計バブルはサイズ基準の数値フィールドが必須で、円の面積が値に比例します(最大半径 10〜80px・既定30 / 不透明度 0.1〜1・既定0.6)。
• 都道府県マップの都道府県フィールドは、都道府県名(「東京都」「大阪府」。「東京」など接尾辞なしも可)のほか、住所文字列でもかまいません(先頭の都道府県名を自動で抽出します)。
• 都道府県マップの配色は6種類(青・緑・赤・紫・赤/黄/緑・赤/白/青)+反転から選べます。「多いほど良い」指標は青や緑、「多いほど危険」な指標は赤、目標比のような中間に意味がある指標は赤/黄/緑などの分岐配色が向いています。
• 一括ジオコーディング(住所から緯度・経度を一括変換)は、住所・緯度・経度のフィールドを割り当てて設定画面から実行します。緯度・経度が両方入っているレコードはスキップされます(「変換済みも上書き」にチェックすると全件変換し直します)。

動作仕様

• レコードはビューを開いたときに一括取得し(500件ずつ・最大1万件)、全ビューで共有します。タブ切替時の再取得はありません(「再読み込み」ボタンで最新化できます)。
• ピンマップ: 緯度・経度が有効なレコードをピンで表示します。ピンをクリックすると、タイトルと設定したフィールド(最大4個)がポップアップし、レコード詳細へのリンクも表示されます。色分け基準フィールド(ドロップダウン/ラジオ)を設定すると、選択肢ごとの色でピンが塗り分けられ、凡例が表示されます。
• ピンマップの表示件数が1,500件を超えると、ピンの代わりに軽量な丸マーカー(canvas描画)に自動で切り替わります。
• 統計バブル: サイズ基準フィールドの値が正の数のレコードを、値に応じた大きさの円で表示します(面積が値に比例。大きい円から順に描画するため、小さい円が埋もれません)。値が0以下・未入力のレコードは表示されません。
• 都道府県マップ: 都道府県フィールドの値から都道府県を判定し、件数・合計・平均の集計値で5段階に塗り分けます。地図データはプラグインに同梱されており、外部リクエストなしで描画されます。都道府県にマウスを載せると集計値がポップアップします。
• 地図の拡大縮小は Ctrl(⌘)+ホイール、またはズームボタンで行います(ホイール単独はページスクロールを優先する誤操作防止の仕様です)。
• 一括ジオコーディング: 実行の都度、送信先(国土地理院の住所検索API)への同意チェックと確認ダイアログを挟んでから、1件/秒で変換します(サーバー負荷への配慮)。変換結果は四捨五入して小数第6位までを緯度・経度フィールドに保存します。「中断」ボタンでいつでも止められ、そこまでの結果は保存されます。
• 外部通信: レコードの内容が当社(KINTAUROS)のサーバーに送信されることはありません。ピンマップの地図タイル画像(国土地理院タイル)の取得時に表示領域のタイル座標が国土地理院に渡るのみで、ジオコーディングは設定画面から明示的に実行したときだけ住所文字列を国土地理院へ直接送信します。都道府県マップは外部リクエストなし。地図ライブラリ(Leaflet)は同梱です。

制限事項・既知の仕様

• モバイルアプリの画面では動作しません(デスクトップ版UIのみ)。
• 表示できるレコードは最大1万件です。超過分は表示されず、件数表示に「(上限)」と表示されます。
• ビューは5個まで、ポップアップに表示する追加フィールドは4個までです。
• 都道府県マップは日本の47都道府県のみ対応です。市区町村単位の塗り分けや海外の地図には対応していません。
• ジオコーディングの精度は国土地理院の住所検索APIに依存します(概ね番地精度が目安)。ビル名や旧住所を含む表記は見つからないことがあります。
• 地図タイルは国土地理院の淡色地図に固定です(タイル提供元の変更・カスタムタイルURLの指定はできません)。

設定のインポート / エクスポート

プラグイン設定画面の上部にある「設定のインポート / エクスポート」から、現在の設定をJSONファイルとして書き出し(エクスポート)、別のアプリで読み込み(インポート)できます。検証用アプリから本番アプリへの設定コピーや、バックアップ・復元にご利用ください。

• インポートは取り込む内容の差分を確認してから「設定画面に反映」し、最後に「保存」を押して確定します(反映しただけでは保存されません)。
• 読み込んだファイルはブラウザ内で処理され、KINTAUROSのサーバーには送信されません。
• 別のアプリの設定を取り込んだ場合、このアプリに存在しないフィールドは警告として一覧表示されるので、反映後に該当箇所を選び直してください。

エクスポートファイルは次の形式(封筒形式)です。config の中身が設定本体で、その構造は上の設定項目リファレンスのとおりです。

{
  "kintauros": "config/v1",
  "plugin": "<プラグインID>",
  "pluginName": "<プラグイン名>",
  "pluginVersion": "<バージョン>",
  "exportedAt": "<書き出し日時(ISO 8601)>",
  "sourceApp": "<書き出し元アプリID>",
  "config": { ... 設定本体 ... }
}

AIエージェント向け: ブラウザコンソールAPI

各プラグインは共通ランタイム window.KINTAUROS を搭載しており、ブラウザの開発者コンソールから設定の読み取り・検証・保存ができます。設定の保存(save: true)はkintoneの制約上、プラグイン設定画面でのみ成功します。

KINTAUROS.config.plugins()                   // このページのKINTAUROSプラグインID一覧
KINTAUROS.config.describeAll()               // 同居プラグインすべての設定サマリ
KINTAUROS.config.of('<プラグインID>').schema()    // 設定のJSON Schema
KINTAUROS.config.of('<プラグインID>').export()    // 現在の設定(封筒つき)
KINTAUROS.config.of('<プラグインID>').validate(x) // 保存せず検証
KINTAUROS.config.of('<プラグインID>').diff(x)     // 現在の設定との差分
await KINTAUROS.config.of('<プラグインID>').import(x, { save: true }) // 検証して保存(設定画面のみ)

登録が1件だけのページでは of(...) を省略できます(例: KINTAUROS.config.export())。

トラブルシューティング

ビューを開いても地図が表示されない

アプリ設定 > プラグイン からジオスタジオの設定画面を開き、対象のカスタマイズビュー・タイトルフィールド・ビューを設定して保存し、「アプリを更新」してください。表示されるのは設定で指定したビューだけです。

E001: 設定されたフィールドが見つかりません

設定後にフィールドが削除・変更された状態です。プラグイン設定画面を開き、各ビューのフィールドを現在のフォームに合わせて選び直して保存してください。

一部のレコードが地図に表示されない

ピンマップは緯度・経度が未入力・不正(数値として読めない、または範囲外)のレコードを表示しません(画面上部に「〜件は表示していません」と件数が出ます)。統計バブルはサイズ基準の値が0以下・未入力のレコードも対象外です。住所しかない場合は、設定画面の一括ジオコーディングで緯度・経度を作成してください。

都道府県マップで「該当なし」になるレコードがある

都道府県フィールドの値から都道府県名を判定できていません。値が都道府県名で始まっているか(「東京都千代田区…」は可、「千代田区…」は不可)、表記ゆれ(スペース・略称など)がないかを確認してください。

一括ジオコーディングで「住所が見つからず」になる

国土地理院の住所検索APIで該当が見つからなかった住所です。ビル名・部屋番号を除く、丁目・番地をハイフン表記にするなど表記を整えて再実行してください(変換済みのレコードはスキップされるため、失敗した分だけ再変換されます)。

地図がホイールで拡大縮小できない

誤操作防止のため、ホイール単独ではズームしない仕様です。Ctrlキー(Macは⌘キー)を押しながらホイール操作するか、地図左上のズームボタンをお使いください。

エラーコードと診断情報

ジオスタジオを含むKINTAUROSプラグインは、エラー発生時にブラウザのコンソールへ統一形式のログを出力します。人間向けの1行に続けて、機械可読なJSON(code / plugin / version / appId / message / doc)を出力し、doc には該当エラーの解説ページのURLが入ります。

[KINTAUROS <プラグインID>@<バージョン>] E001: 設定されたフィールドが見つかりません: ...
{"kintauros":{"code":"E001","plugin":"...","version":"...","appId":"...","message":"...","doc":"https://kintauros.com/docs/errors/E001"}}

各エラーコードの意味と対処はエラーコード一覧を参照してください。また、プラグイン設定画面の「サポート用情報をコピー」から、環境・バージョン・ライセンス状態・直近のエラーを含む診断情報をコピーできます(レコードの内容や個人情報は含まれません)。お問い合わせの際はこの情報を添えてください。

ライセンスについて

• 初回利用時は、プラグイン設定画面の「利用開始」ボタンから60日間の無料トライアルを開始できます(カード登録不要)。
• トライアル・契約の期限が切れるとプラグインの動作は停止し、画面に案内が表示されます。料金プランから契約すると同じ設定のまま再開できます。
• ライセンス確認のための外部通信で送信されるのは、kintoneドメイン名・プラグインID・バージョンのみです。レコードの内容や個人情報が外部に送信されることはありません。
• ライセンスサーバーに一時的に接続できない場合も、プラグインは一定期間動作を継続する設計です。

サポート

解決しない場合はお問い合わせからご連絡ください。その際、プラグイン設定画面の「サポート用情報をコピー」でコピーした診断情報を添えていただくと、調査がスムーズです。

最終更新: 2026-09-12 / 対象バージョン: v1.3.1