読込・座標・レイヤー・背景の4段階に分け、症状から原因を調べます。8施設の小さな教材を使い、設定とデータの問題を切り分ける手順をまとめます。
対象はGIS未経験者を含む、都市データを地図で調べたい方です。操作の確認環境は公式デモの3.3.0-alpha.21(2026年11月17日)。開発版のため、導入環境によって項目名や利用できる機能は異なります。
都市データの共通教材をダウンロード(ZIP)。展開して使ってください。施設・区域・人口・イベント・起終点・軌跡はすべて自作の架空データです。実在の地域の評価や実際の移動を表しません。教材の利用・改変・再配布は可能です。背景地図の権利と利用条件は各配信元に従ってください。
この実習で使うファイル:facilities.csv。ZIPを展開してから選びます。別の実習のフィルターやレイヤーが残っている場合は、新しいタブの空の地図で始めるか、表示状態を確認してください。初回の画面操作は共通の操作案内を参照できます。
最初に「どこまでできているか」を分ける
地図が出ないときは、すべてをやり直す前に「ファイルが読めた」「位置が決まった」「レイヤーが見える」「背景が表示された」を別々に確認します。背景地図だけの問題と、CSVの座標がない問題では対処が違います。
症状から確認する早見表
| 症状 | 最初の確認 | 次の操作 |
|---|---|---|
| 読込の一覧に出ない | 形式・文字コード・CSVの見出し | 小さい教材CSVで読み込みを試す |
| 行数はあるが点がない | lat / lngの対応、型、フィルター | 全体範囲へ戻し、条件を解除 |
| 全然違う場所に出る | 経度と緯度、座標系、符号 | WGS 84経緯度へ変換した元値を確認 |
| 色分けできない | 数値が文字列になっていないか | 単位や区切りを整理して再読込 |
| 点が少なく見える | 重なり・集約・同一座標 | IDと行数を元表で照合 |
| 日時がずれる | 秒とミリ秒、時差指定、表示タイムゾーン | 既知の1時刻で入力と表示を比較 |
| 動作が重い | 行数・列数・レイヤー・3D | 必要なデータに絞り、2Dで確認 |
8施設の教材で、環境とデータを切り分ける
- 作業中の地図JSONを保存してから、小さなfacilities.csvを別の空の地図で試します。
- Add Dataで読み込み、8 rowsを確認します。
- Pointのlatにlatitude、lngにlongitudeを指定します。
- フィルターなし、1レイヤー、2Dで表示を確認します。
- 教材は表示できて実データだけ表示できないなら、実データの列・型・座標・容量の差を調べます。
東京付近の教材値は経度139台、緯度35台です。経度と緯度を逆に入れると、緯度が90度を超える不正な組になります。実データが平面直角座標や投影座標なら、列名をlongitudeに変えるだけでは直りません。QGISやPythonで座標変換し、適切な経緯度を用意します。
表示されない理由を1つずつ外す
目のアイコンでレイヤーが非表示になっていないか、透明度が0になっていないか、上にある区域の塗りで隠れていないか確認します。次にフィルター、時間窓、現在の地図範囲を確認します。条件を複数同時に変えると、どれが原因だったか分からなくなります。
Iconだけ出ないなら、座標だけでなくicon列の利用可能な名前を確認します。Tripだけ再生できないなら、LineStringの時刻形式と順序を調べます。18行のhourly-counts.csvが3点に見えるのは、3地点を複数時刻に記録した教材の構造によるもので、15行が消えた証拠ではありません。
重いときは、表示とデータ量の両方を減らす
不要な列を外す、対象期間を絞る、事前集計する、同じデータを重複読込しないなどの準備が有効です。いったん3Dや多数のレイヤーを避け、基本のPointで確認します。行数だけで一律に安全な上限は決められず、形状の複雑さ、属性、端末のメモリー、ブラウザーなどで変わります。
背景が空でもデータの点が表示される場合は、背景タイルの接続・選択したスタイル・必要なトークンを確認します。画面のLoadingという文字だけで、何が止まっているかを決めつけないでください。表示されている対象とエラーの内容を合わせて判断します。
相談するときに残す情報
- kepler.glの導入先・表示されたバージョン・ブラウザー。
- ファイル形式、行数、おおよその容量、使う列名と型。
- 期待した表示と実際の症状、試した条件。
- 個人情報を除いた再現用の小さなデータと画面。
QGISで元データの属性と座標系を確認できる場合は、そこで正しく見えるかも手掛かりになります。ただし、QGISで表示できたからkepler.glでも同じ形式・型が対応しているとは限りません。元ファイルを保管し、小さい例で段階的に原因を絞るのが確実です。
参考資料
設定を変える前に元の状態を残す
作業を失わないよう、まずJSONを保存します。読込画面でファイルを選んだ後、Ready to add file to mapになってからAdd Dataを押したかも確認してください。数値入力はTabなどで確定し、画面へ反映されたことを見てから次の操作へ進みます。



コメント