kepler.glのトラブル対処|表示されない・位置が違う・動作が重い

読込・座標・レイヤー・背景の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施設の教材で、環境とデータを切り分ける

  1. 作業中の地図JSONを保存してから、小さなfacilities.csvを別の空の地図で試します。
  2. Add Dataで読み込み、8 rowsを確認します。
  3. Pointのlatにlatitude、lngにlongitudeを指定します。
  4. フィルターなし、1レイヤー、2Dで表示を確認します。
  5. 教材は表示できて実データだけ表示できないなら、実データの列・型・座標・容量の差を調べます。

東京付近の教材値は経度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などで確定し、画面へ反映されたことを見てから次の操作へ進みます。

コメント

タイトルとURLをコピーしました