GeoJSONを地図に表示する方法と失敗しない5手順

目次

• GeoJSONを地図表示に使う前に押さえる基本

• 手順1 表示したい地物と目的を整理する

• 手順2 座標の順序と位置の基準を確認する

• 手順3 データ構造と属性情報を点検する

• 手順4 地図側の読み込み条件と表示方法を決める

• 手順5 表示後に位置ずれと見え方を検証する

• GeoJSON表示でよくある失敗と防ぎ方

• 実務で扱いやすいGeoJSONに整える考え方

• まとめ GeoJSON表示は事前確認と検証で安定する

GeoJSONを地図表示に使う前に押さえる基本

GeoJSONは、地図上に点、線、面などの地物を表現するために広く使われるデータ形式です。道路、敷地、境界、施設、調査地点、施工範囲、管理区域など、位置情報を持つ対象をテキスト形式で扱えるため、地図表示や空間データの受け渡しに向いています。拡張子だけを見ると単なるファイルに見えるかもしれませんが、中身は座標と属性情報を組み合わせた構造化データです。そのため、地図に表示する前には、何をどの位置に表示したいのか、座標の意味が正しいか、地図側が読み込める形になっているかを確認する必要があります。

実務でGeoJSONを扱う場面では、作成したデータを地図に載せればすぐに正しく表示されると思われがちです。しかし、実際には「地図の外に表示される」「日本のデータなのに海外に飛ぶ」「点は表示されるが線や面が出ない」「文字情報はあるのにクリックしても内容が見られない」「データ量が多くて動作が重い」といった問題が起こることがあります。これらの多くは、地図表示の段階だけでなく、事前の整理や確認不足が原因です。

GeoJSONを地図に表示する方法は、大きく分けると、地図を表示する仕組みにGeoJSONファイルを読み込ませる方法と、画面側の処理でGeoJSONの内容を読み取り、点や線や面として描画する方法があります。どちらの場合でも重要なのは、GeoJSONの形が正しいこと、座標が地図で使う前提に合っていること、そして表示目的に合った見せ方になっていることです。単に読み込めるだけでは、実務で使える表示とは言えません。現地確認、報告、共有、管理、更新作業に使うのであれば、表示の正確さと見やすさの両方が必要です。

この記事では、GeoJSONを地図に表示する際に失敗しないための流れを5つの手順に分けて解説します。特定のソフトウェア名やサービス名に依存せず、一般的な地図表示の考え方として整理しています。すでにGeoJSONファイルを持っている担当者にも、これからデータを作成する担当者にも使えるように、座標、構造、属性、読み込み、検証の順番で確認していきます。

手順1 表示したい地物と目的を整理する

GeoJSONを地図に表示する最初の手順は、データそのものを開く前に、表示したい地物と利用目的を整理することです。地図表示では、点、線、面のどれを扱うのかによって確認すべき内容が変わります。点であれば、施設位置、撮影地点、調査箇所、基準点、標識、マンホールなどが対象になります。線であれば、道路中心線、配管ルート、境界線、巡回経路、施工ラインなどが対象になります。面であれば、敷地、区域、工区、規制範囲、調査範囲、管理範囲などが対象になります。

表示する地物の種類を整理しないまま作業を始めると、地図上には表示されたものの、実務で判断しにくい状態になりがちです。たとえば、調査地点を確認したいだけであれば点の表示が中心になりますが、施工範囲を共有したい場合は面の表示が重要になります。境界やルートを確認したい場合は線の連続性が大切です。目的によって、必要な属性情報や表示色、ラベル、クリック時に見せる内容も変わります。

GeoJSONでは、ひとつのデータの中に複数の地物をまとめることができます。点だけのデータもあれば、線だけのデータもあり、点、線、面が混在するデータもあります。ただし、混在データは便利な一方で、表示ルールを整理しておかないと見づらくなります。調査地点、道路線、区域面が同じ色や同じ太さで表示されると、何を見ればよいのか分かりにくくなります。実務では、地物の種類ごとに役割を分け、必要に応じてデータを分割する考え方も有効です。

目的の整理では、閲覧だけなのか、確認作業に使うのか、報告資料に使うのか、現地で更新するのかも考える必要があります。閲覧だけであれば、見た目の分かりやすさが優先されます。確認作業に使うなら、位置精度や属性の正確性が重要になります。報告資料に使うなら、凡例や名称の統一が必要です。現地で更新するなら、地物ごとの識別番号や作業状態を持たせると扱いやすくなります。

また、表示範囲も早い段階で決めておくと失敗を減らせます。市区町村全体なのか、工区単位なのか、数百メートルの現場範囲なのかによって、適切な縮尺や表示密度が変わります。広域データをそのまま詳細地図に載せると重くなることがあり、逆に詳細な現場データを広域地図で見せると点や線が重なって意味が伝わりにくくなることがあります。GeoJSONを地図に表示する作業は、単なる読み込み作業ではなく、利用場面に合わせて地物を整理する作業でもあります。

手順2 座標の順序と位置の基準を確認する

GeoJSONを地図に表示するときに最も多い失敗のひとつが、座標の扱いによる位置ずれです。GeoJSONでは、座標は原則として経度、緯度の順で記述します。高さや標高などを含める場合は、必要に応じて3番目の値として扱われます。日本語の実務では「緯度経度」という言い方に慣れているため、緯度、経度の順で入力してしまうことがあります。この順序を間違えると、地図上ではまったく別の場所に表示されたり、表示範囲の外に出てしまったりします。

たとえば、日本国内の位置情報であれば、経度はおおむね120度台から150度台、緯度はおおむね20度台から40度台の範囲に入ります。これが逆になっていると、緯度として扱われる数値が大きすぎたり、経度として扱われる数値が小さすぎたりして、意図しない位置になります。地図に表示する前に、座標値の並びと数値の範囲をざっと確認するだけでも、大きなミスを防げます。

座標の基準も重要です。GeoJSONでは、一般的な地図表示で扱いやすい地理座標を前提にする必要があります。現場測量や設計データでは、平面直角座標系、ローカル座標、工事用の任意座標などが使われることがあります。これらの座標をそのままGeoJSONに入れても、一般的な背景地図上には正しい位置で表示されません。数値としては入っていても、地図側が経度と緯度として解釈すれば、まったく異なる位置になります。

実務では、座標変換の有無を必ず確認してください。元データが緯度経度なのか、平面座標なのか、現場独自の座標なのかを把握し、地図表示に必要な形へ変換してからGeoJSONにする必要があります。変換作業を行った場合は、変換前の座標系、変換後の座標系、使用した変換条件、確認した代表点を記録しておくと安心です。後から位置ずれが見つかったときに、どこでずれたのかを追いやすくなります。

線や面のデータでは、座標の順序だけでなく、点の並び順も確認します。線は座標が並んだ順番に結ばれるため、点の順序が乱れていると線が折り返したり交差したりします。面では、外周を構成する座標列が閉じている必要があります。最初の座標と最後の座標が一致していないと、表示側で面として扱えなかったり、意図しない形になったりすることがあります。穴のある面や複数の面を持つデータでは、外側の輪郭と内側の輪郭の扱いも確認が必要です。

位置の確認では、代表点を使った照合が有効です。すべての座標を目で確認することは現実的ではありませんが、分かりやすい地点を数か所選び、地図上の既知の位置と重なるかを確認すれば、大きな座標ミスを早期に見つけられます。交差点、施設入口、敷地角、橋梁端部、工区端点など、現地で確認しやすい点を使うと判断しやすくなります。GeoJSONの表示で失敗しないためには、読み込み後に見るだけでなく、読み込み前に座標の意味を確認することが欠かせません。

手順3 データ構造と属性情報を点検する

GeoJSONを地図に表示するためには、データ構造が正しく整っている必要があります。GeoJSONは、地物の集合、個別の地物、形状、属性情報といった要素で構成されます。地図側はこの構造を読み取り、点、線、面として描画します。構造が崩れていると、ファイル自体は存在していても読み込めない、読み込めても一部しか表示されない、属性が表示されないといった問題が起こります。

まず確認したいのは、地物の形状種別です。点を示すデータ、複数点を示すデータ、線を示すデータ、複数線を示すデータ、面を示すデータ、複数面を示すデータでは、座標配列の階層が異なります。見た目には似たような数字の並びに見えても、階層がひとつ違うだけで地図側が解釈できなくなることがあります。特に、線と複数線、面と複数面は混同しやすいため、データ作成時や変換時に注意が必要です。

次に、属性情報を点検します。属性情報には、地物名、管理番号、分類、状態、更新日、担当区分、備考などを入れることができます。地図表示では、単に位置を示すだけでなく、クリックしたときに内容を確認したり、分類ごとに色を変えたり、検索や絞り込みに使ったりするために属性が重要になります。属性名がばらばらだったり、同じ意味の項目が複数の表記に分かれていたりすると、地図上での表示制御が難しくなります。

実務で扱いやすい属性にするには、項目名を統一し、空欄の扱いを決めておくことが大切です。たとえば、同じ管理番号を「番号」「管理ID」「ID」のように複数表記にすると、後から集計や検索を行う際に手間が増えます。状態を表す項目でも、「完了」「済」「対応済み」のように表記が混ざると、分類表示が安定しません。GeoJSONを地図に表示する前に、属性情報の項目名と値の表記をそろえておくと、表示後の確認がしやすくなります。

文字コードや記号の扱いにも注意が必要です。日本語の属性を含むGeoJSONでは、文字が正しく表示されるかを確認します。地図上のポップアップやラベルに日本語を表示する場合、文字化けが起きると現場名や施設名が読めなくなります。また、改行、引用符、特殊な記号が属性に含まれる場合、データの作成方法によっては構造エラーの原因になることがあります。自由記入欄をそのまま取り込むと、意図しない記号が混入することもあるため、公開や共有の前には一度確認しておくと安心です。

データ量も点検の対象です。GeoJSONは人が読める形式で扱いやすい一方、座標点数が非常に多い線や面をそのまま入れると、地図表示が重くなることがあります。特に、広い範囲の道路、河川、行政区域、細かい境界線などを高密度な座標のまま表示すると、読み込みに時間がかかったり、画面操作が重くなったりします。実務で必要な精度を保ちながら、表示目的に対して過剰に細かい座標を整理することも重要です。

データ構造の点検は、地図に表示できるかどうかだけでなく、表示後に使える状態かどうかを確認する作業です。位置が正しくても、属性が読みにくければ管理には使いにくくなります。属性が整っていても、形状が崩れていれば範囲やルートの確認には使えません。GeoJSONを地図に表示する前には、形状、座標階層、属性、文字、データ量をまとめて確認し、読み込み後のトラブルを減らしましょう。

手順4 地図側の読み込み条件と表示方法を決める

GeoJSONの準備ができたら、次に地図側でどのように読み込ませ、どのように表示するかを決めます。地図表示の仕組みにはさまざまな種類がありますが、基本的な考え方は共通しています。背景となる地図を表示し、その上にGeoJSONの地物を重ね、地物の種類や属性に応じて見た目を設定します。ここで重要なのは、読み込みさえできればよいと考えず、実務で確認しやすい表示ルールを作ることです。

点の表示では、記号の大きさ、色、ラベルの有無、クリック時に見せる内容を決めます。調査地点が多い場合、すべての点にラベルを常時表示すると地図が読みにくくなります。その場合は、通常時は点だけを表示し、クリックまたは選択時に名称や管理番号を表示する方法が適しています。逆に、数が少ない重要地点であれば、地図を開いた時点で名称が見えるようにしたほうが分かりやすい場合もあります。

線の表示では、線幅、色、破線や実線の使い分け、前後関係が重要です。道路、管路、ルート、境界などを同じ太さと色で表示すると、種類の違いが分かりにくくなります。属性に分類がある場合は、分類ごとに表示ルールを分けると判断しやすくなります。また、背景地図の道路や建物と重なる場合は、線が背景に埋もれないように太さや透明度を調整します。線が細すぎると見落としやすく、太すぎると位置の確認がしにくくなるため、用途に合わせた調整が必要です。

面の表示では、塗りの透明度と外周線の見せ方が大切です。面を濃く塗りつぶすと範囲は目立ちますが、背景地図が見えにくくなります。施工範囲や管理区域を示す場合は、薄い塗りと外周線を組み合わせると、背景との関係を確認しやすくなります。複数の区域が重なる場合は、重なり部分の見え方にも注意します。面の表示は視覚的な影響が大きいため、実務では関係者が誤読しないように慎重に設定する必要があります。

読み込み条件では、ファイルの配置場所や更新方法も考えます。地図画面を開くたびにGeoJSONを読み込むのか、あらかじめ画面側に組み込むのか、更新時に差し替えるのかによって運用が変わります。現場や管理業務で定期的に更新するデータであれば、ファイル名、更新日、作成者、版数を管理しておくと、古いデータを表示してしまうリスクを減らせます。GeoJSONは扱いやすい形式ですが、差し替えや共有が簡単だからこそ、版管理を曖昧にしないことが大切です。

表示速度も確認しましょう。データ量が小さいうちは問題がなくても、地物数や座標点数が増えると動作が重くなることがあります。特に、現地で端末を使って確認する場合、通信環境や端末性能の影響を受けることがあります。地図表示が遅いと、確認作業そのものが止まり、実務効率が下がります。必要に応じてデータを範囲別に分ける、表示縮尺に応じて出す情報を変える、属性で絞り込めるようにするといった工夫が有効です。

地図側の表示方法を決める段階では、利用者の視点も欠かせません。作成者にとって分かりやすい表示でも、現地担当者、管理者、発注者、協力会社など、見る人が変わると必要な情報も変わります。専門用語だけの属性表示では伝わりにくい場合がありますし、逆に情報を詰め込みすぎると確認に時間がかかります。GeoJSONを地図に表示する目的は、位置情報を見える化して判断しやすくすることです。読み込み条件と表示方法は、その目的に合わせて設計しましょう。

手順5 表示後に位置ずれと見え方を検証する

GeoJSONを地図に読み込んだら、最後に必ず表示結果を検証します。地図上に表示された時点で完了と考えるのは危険です。表示されることと、正しい位置に正しい意味で表示されることは別です。実務で使うGeoJSONでは、位置、形状、属性、見え方、操作性を確認し、必要に応じて修正してから共有することが重要です。

まず確認するのは位置ずれです。代表点を選び、背景地図や既知の位置と重なるかを見ます。点データであれば、施設や調査地点が想定した場所にあるかを確認します。線データであれば、道路、境界、ルートなどに沿っているかを確認します。面データであれば、敷地や区域の外周が想定範囲と合っているかを確認します。全体が一定方向にずれている場合は座標変換や基準の問題が疑われます。一部だけがずれている場合は、元データの入力ミスや座標列の乱れが考えられます。

次に、縮尺を変えて見え方を確認します。広域表示では全体の位置関係が分かりやすいか、詳細表示では地物の重なりや境界が確認しやすいかを見ます。広域では問題なく見えても、拡大すると線がずれて見えることがあります。逆に、詳細では正しく見えても、広域では点が密集して判別できないことがあります。利用場面に合わせて、どの縮尺で何を確認するのかを意識することが大切です。

属性の表示も検証します。地物をクリックまたは選択したときに、必要な情報が表示されるかを確認します。管理番号、名称、分類、状態、備考などが正しく読めるか、空欄や不要な項目が多すぎないかを見ます。属性の順番がばらばらだと、確認作業に時間がかかります。実務でよく見る項目を上位に出し、補足情報は必要に応じて確認できるようにすると扱いやすくなります。

線や面では、形状の崩れも確認します。線が途中で切れていないか、意図しない折れ曲がりがないか、面が閉じているか、穴や複数面が正しく表示されているかを見ます。面が反転したように見える、広い範囲を不自然に塗りつぶしている、線が地図の端から端まで伸びているといった場合は、座標の順序や配列構造に問題がある可能性があります。見た目の異常は、データ構造の異常を知らせるサインでもあります。

共有前の検証では、複数の環境で確認することも有効です。作成者の画面では問題なく表示されても、別の端末や別の閲覧環境では表示速度や文字の見え方が異なることがあります。特に現地利用を想定する場合は、通信状況、画面サイズ、操作のしやすさを確認します。地図上で目的の地物をすぐに見つけられるか、必要な情報にすぐアクセスできるかを確認しておくと、運用開始後の混乱を減らせます。

検証結果は、できれば記録に残しておきましょう。確認日、確認者、使用したデータ名、確認した代表地点、修正内容を残しておくと、後からデータの妥当性を説明しやすくなります。GeoJSONは更新しやすい形式ですが、更新のたびに確認を省くと、少しずつ品質が崩れることがあります。表示後の検証を手順として定着させることで、地図表示の信頼性を保てます。

GeoJSON表示でよくある失敗と防ぎ方

GeoJSONを地図に表示する際の失敗は、いくつかの典型的なパターンに分けられます。最も多いのは、座標の順序を間違えるケースです。緯度と経度を逆にしてしまうと、地図上では意図しない場所に表示されます。日本国内のデータであれば、経度と緯度の数値範囲を確認するだけでも発見できることがあります。データ作成時には、座標列の先頭が経度であることを意識し、元データの項目名にも注意します。

次に多いのは、座標系が合っていないケースです。現場の平面座標や任意座標を、そのままGeoJSONとして使うと、一般的な地図上には正しく載りません。元データがどの座標基準で作られているかを確認し、必要な変換を行うことが大切です。設計図、測量成果、現地記録、既存の管理データを組み合わせる場合は、座標基準が混在していないかを特に注意してください。

データ構造の崩れもよくある問題です。括弧の閉じ忘れ、余分な記号、座標配列の階層違い、形状種別と座標形式の不一致があると、地図側で読み込めない場合があります。複数のデータを手作業で結合したときや、表形式のデータから変換したときに起こりやすい問題です。読み込みエラーが出る場合は、地図側だけを疑うのではなく、GeoJSONそのものの構造を確認する必要があります。

属性情報の不統一も、表示後の使いにくさにつながります。地図上には表示されているのに、クリックしても必要な情報が分からない、分類で色分けしたいのに値がばらばらで分けられない、検索したい項目が空欄になっている、といった問題です。GeoJSONを単なる図形データとして扱うのではなく、地物ごとの情報を持つデータとして整えることが重要です。位置だけでなく、属性まで含めて品質を確認しましょう。

重すぎるデータも失敗の原因になります。細かすぎる境界線や大量の点を一度に表示すると、地図操作が遅くなることがあります。特に、広範囲のデータと詳細な現場データを同じ粒度で扱うと、表示負荷が高くなります。実務では、表示目的に合わせてデータを分ける、不要な属性を削る、座標点数を整理する、対象範囲を絞るといった工夫が必要です。正確さを保ちながら、地図表示に適した軽さに整えることが大切です。

見た目の設定不足も見落とせません。点が小さすぎて見えない、線が背景に埋もれる、面の塗りが濃すぎて背景が読めない、ラベルが多すぎて地図が隠れるといった問題は、データ自体が正しくても起こります。地図表示では、データの正しさと同じくらい、見やすさが重要です。関係者が迷わず判断できるように、表示色、線幅、透明度、ラベルの出し方を調整しましょう。

実務で扱いやすいGeoJSONに整える考え方

GeoJSONを地図に表示する作業を安定させるには、毎回その場で対応するのではなく、実務で扱いやすい形に整える考え方が必要です。まず、データの役割を明確にします。確認用、共有用、記録用、更新用では、必要な精度や属性、表示方法が異なります。確認用なら位置と分類が分かりやすいことが重要です。共有用なら誰が見ても意味が伝わる名称や説明が必要です。記録用なら作成日や更新履歴が重要です。更新用なら識別番号や状態管理が欠かせません。

ファイル名や版管理も実務では大切です。GeoJSONは差し替えや複製が簡単なため、古いファイルと新しいファイルが混在しやすくなります。ファイル名に対象範囲、用途、日付、版数などを含めておくと、どのデータを表示しているのか判断しやすくなります。共有時には、最新版だけでなく、どの時点のデータなのかを明確にすることが重要です。地図上の表示が正しくても、古いデータであれば判断を誤る可能性があります。

属性設計では、後から使う場面を考えて項目を作ります。地図上で見せるための名称だけでなく、検索、絞り込み、集計、更新に使う項目を整えておくと、運用しやすくなります。たとえば、分類、状態、担当、確認日、備考といった項目が整っていれば、現場確認後の管理にもつなげやすくなります。ただし、項目を増やしすぎると入力や確認の負担が大きくなります。必要な項目に絞り、表記ルールを決めることが現実的です。

地図表示に使うGeoJSONでは、不要な情報を入れすぎないことも大切です。元データには多くの属性が含まれている場合がありますが、地図上で使わない項目まで含めると、ファイルが大きくなり、確認時にも見づらくなります。公開範囲や共有先によっては、内部管理用の情報を含めない配慮も必要です。表示目的に合わせて必要な情報だけを残すことで、軽く、分かりやすく、安全に扱えるデータになります。

更新作業を想定する場合は、元データとGeoJSONの関係も整理しておきましょう。GeoJSONを直接編集する運用もありますが、表形式の台帳や測量成果、設計データから変換して作る場合もあります。どれが正本で、どれが表示用の派生データなのかを決めておかないと、修正箇所が分からなくなります。表示用GeoJSONを直したのに元データが古いままだと、次回変換時に修正が消えることがあります。データの流れを明確にしておくことが、継続運用の安定につながります。

現地利用を考える場合は、端末での見やすさも意識します。屋外では画面が見えにくいことがあり、細い線や淡い色は確認しづらい場合があります。通信環境が不安定な場所では、重いGeoJSONの読み込みに時間がかかることもあります。現場で使う地図表示は、事務所の大きな画面で見る場合とは条件が異なります。作成段階で現地利用を想定し、地物数、表示範囲、ラベル、属性表示を調整しておくと、実際の作業で使いやすくなります。

GeoJSONを実務で活用するうえでは、地図表示だけでなく、位置情報の取得から整理、確認、共有までを一連の流れとして考えることが重要です。現地で取得した座標や写真位置、調査結果をGeoJSONとして整理できれば、後工程での確認や報告がスムーズになります。逆に、取得時の座標精度や属性入力が曖昧だと、地図表示の段階で修正が増えます。地図に表示する最後の工程だけでなく、データを作る最初の工程から品質を意識しましょう。

まとめ GeoJSON表示は事前確認と検証で安定する

GeoJSONを地図に表示する方法は、基本的にはGeoJSONの地物を地図上に読み込み、点、線、面として描画する流れです。しかし、実務で失敗しないためには、単に読み込むだけでは不十分です。表示したい地物と目的を整理し、座標の順序と基準を確認し、データ構造と属性を点検し、地図側の読み込み条件と見せ方を決め、最後に位置ずれや見え方を検証する必要があります。この5手順を踏むことで、表示されない、ずれる、重い、読みにくいといったトラブルを減らせます。

特に重要なのは、座標と属性の確認です。GeoJSONでは座標の順序が経度、緯度であることを意識し、元データの座標基準が地図表示に合っているかを確認します。また、属性情報を整えることで、地図上の地物が単なる図形ではなく、管理や判断に使える情報になります。地図表示は見た目の作業に見えますが、その裏側にはデータ整理の品質が大きく影響します。

GeoJSONを扱う実務担当者にとって、安定した地図表示は現地確認、社内共有、報告、維持管理の効率化につながります。表示前の確認を省かず、表示後の検証を習慣にすることで、関係者が同じ位置情報を見ながら判断しやすくなります。さらに、現地で取得した位置情報を正しく整理し、GeoJSONなどの形式で活用できる流れを整えれば、地図を使った業務全体の精度とスピードを高めやすくなります。

現場で位置情報を取得し、そのまま地図表示や記録管理につなげたい場合は、スマートフォンなどを活用した位置情報取得の仕組みも選択肢になります。ただし、利用する機器やアプリによって取得精度、対応形式、出力方法、運用条件は異なります。GeoJSONでの整理や地図表示を実務に取り入れる場合は、特定の製品名やサービス名だけに依存せず、座標基準、出力形式、属性管理、現地での確認方法を比較しながら、自社の業務に合う方法を選ぶことが大切です。