sgcMaps：Delphi、C++ Builder、.NET 向けネイティブマップ

タイルと地図データ

フォームの中に本物の地図を。中にブラウザは不要

多くの地図コンポーネントは、Web ビューと JavaScript ライブラリをラップしているため、デスクトップアプリケーションがブラウザを同梱することになります。sgcMaps は違います。TsgcVCLMap と TsgcFMXMap は、タイルを自身のキャンバスにダウンロード、キャッシュ、描画し、マウスホイールによるズームとドラッグによるパンを処理し、通常の Delphi のイベントを発生させます。地図は他のコントロールと同じネイティブコントロールです。ドッキングでき、フォームとともにテーマが適用され、他のコードと同じようにデバッグできます。配布やセキュリティ対策が必要な追加プロセスはなく、アプリケーションが動作するどのマシンでも、地図は同じように動作します。

• Layers コレクションは、1 つ以上の TsgcMapLayer 項目を保持し、それぞれが独自の TileSourceType を持ちます
• TsgcFMXMap は、Delphi XE6 以降の Windows、macOS、iOS、Android で動作します
• Lazarus LCL コントロールは、ディスク上のタイルを表示します
• .NET では、WinForms 用の SgcMapControl とヘッドレスの MapView が 1 つのエンジンを共有します
• アラビア語とヘブライ語の右から左対応：ズームボタン、レイヤースイッチャー、コンパス、スケールバー、帰属表示は反対側に移動し、マップは地理的な向きを保ちます

タイルと地図データ

どのサイズでも鮮明なベクタータイル

ラスタータイルは拡大するとぼやけ、スタイルを変えるたびにサーバーから新しい画像を取得する必要があります。ベクタータイルでは、コントロールがジオメトリを受け取り、道路、水域、建物、ラベルを自分で描画するので、高 DPI の画面やエクスポートした画像でも文字が鮮明なままです。レイヤーを Mapbox Vector Tile サーバーに向け、VectorStyleFile を空のままにすれば組み込みのスタイルを使え、MapLibre または Mapbox GL のスタイルファイルを読み込めば、ブランドに合わせられます。ベクターレイヤーは、VCL と FireMonkey のコントロールのどちらでも動作します。

• mtsVectorHTTP は、ベクタータイルサーバーを読み込みます（Delphi XE2 以降）
• mtsVectorMBTiles は、ローカルのベクター MBTiles ファイルを読み込みます（オフラインパック）
• TsgcMapVectorStyle は、LoadFromFile または LoadFromJSON でスタイルを読み込みます
• デコードと描画は、TsgcMapTileSource_MVT の中にあり、標準的な Delphi コードで書かれています

マーカー、図形、ジオメトリ

数千のマーカーでも読みやすい

車両群、店舗網、センサーグリッドは、すぐに重なり合うピンの塊になります。クラスタリングを有効にすると、近くのマーカーは番号付きの 1 つの円にまとまり、ユーザーがズームインすると再び分かれます。これはズームレベルごとに再計算されます。各マーカーは独自のポップアップ、ツールチップ、アイコンを持ち、クリック、ドラッグ、クラスタのクリックはイベントとして届くので、地図は単なる画像ではなく、ワークフローの一部になります。マーカーは、データからループで追加することも、GeoJSON、GPX、KML ファイルからインポートすることもでき、ClearMarkers は 1 回の呼び出しでそれらをリセットします。

• MarkerOptions.Clustering と、GridSize、MinClusterSize、ZoomOnClick
• マーカーごとの PopupText、TooltipText、IconBitmap
• OnMarkerClick、OnClusterClick、OnMarkerDragEnd イベント
• 一括読み込みの前後で BeginUpdate と EndUpdate を使い、FitToMarkers がすべてを画面に収めます
• MarkerAtScreen と ClusterAtScreen で、任意のピクセルの当たり判定を行います

マーカー、図形、ジオメトリ

地理計算はすでに用意されています

この車両はゾーンの内側にありますか。最も近い拠点までの距離は。ルート上でその顧客に最も近い点はどこか。こうした疑問はどの地図アプリケーションにも出てきますが、極付近や長距離では間違いやすいものです。ジオメトリユニットは、WGS84 球面上でこれらに答え、地図がまったくないサービスからも呼び出せる通常の関数として提供されます。関数は通常の TsgcMapCoord レコードを受け取り、独自のオーバーレイを描画するときは、sgcMapLatLonToPixel と sgcMapPixelToLatLon が、画面座標とワールド座標を変換します。

• メートル単位の sgcMapDistance、sgcMapInitialBearing、sgcMapDestinationPoint
• ジオフェンス向けの sgcMapPointInPolygon と sgcMapPointInPolygonWithHoles
• sgcMapNearestPointOnPolyline は、位置をルートにスナップします
• 滑らかで軽い線のための sgcMapGeodesicInterpolate と sgcMapSimplify

検索とルーティング 登録版のみ

インターネットもキーも不要のルートと住所検索

オンラインのルーティングは、現場向けアプリが使われるまさにその場所で失敗しやすく、リクエストごとに費用がかかることもあります。オフラインルーターは、OpenStreetMap の抽出データから一度だけ作ったルートグラフを使って、車、自転車、徒歩のルートをデバイス上で計算します。オフラインジオコーダーは、SQLite の GeoNames インデックスから、地名の検索と、クリックした位置の逆ジオコーディングを行います。どちらもネットワーク、アカウント、リクエストごとの料金は不要です。ルーターとジオコーダーは非ビジュアルコンポーネントなので、Windows サービスやコンソールツールが、画面に地図を表示せずに、ルートや住所のリクエストに応答できます。

• TsgcMapOfflineRouter は、TsgcMapRouteGraphBuilder が .osm.pbf から作成したグラフを使って GetRoute に応答します
• sgcMapAddRouteToPolylines は、結果を地図上に描画します
• TsgcMapOfflineGeocoder の ReverseGeocode は、TsgcMapGeoIndexBuilder が作成したインデックスを使います
• グラフとインデックスを作るコマンドラインビルダーは、Tools フォルダにあります

Community 版はオンラインサービスを使い、オフラインルーターとジオコーダーはオフラインパックに含まれます。

ファイル、レンダリング、モバイル

サーバーで地図画像を描画

ルート付きの納品書、今日の事故を載せた日報、Web ページのサムネイルなど、ウィンドウに表示されない地図は多くあります。同じコントロールが、表示されないまま、コンソールアプリケーションや Windows サービスから PNG やビットマップを描画します。画像を送る前にすべてのタイルが届いたかを確認できるので、タイルサーバーが遅くても、お客様向けの文書に灰色の四角が残ることはありません。サーバー側のレンダリングは、対話型コントロールと同じレイヤー、マーカー、図形を使うため、画面上で設計した地図は PNG でも同じ見た目になります。

• SaveToPNG と SaveToPNGFile（Delphi 2009 以降）
• 独自のパイプライン向けの RenderToBitmap と SaveToBMPFile
• LastRenderMissingTiles は、取得できなかったタイルを報告します
• .NET の MapView.RenderToPng は、Linux でも動作します

印刷、プレビュー、PDF

地図ビューを印刷、またはアクセシブルな PDF にエクスポート

地図は、現在のビューの画像として 1 ページに印刷されます。範囲はコントロールと同じで、中心、ズーム、タイル、レイヤー、マーカー、図形が含まれます。スケールバーと帰属表示は印刷され、ズームボタン、レイヤー切り替え、コンパスは印刷されません。印刷によってビューが動くことはありません。

• Print は印刷ダイアログを表示するか既定のプリンターへ直接印刷し、ShowPrintPreview はページ移動、ズーム、ページ設定、印刷、PDF エクスポートを備えたプレビューを開きます
• PrintSettings は用紙、向き、余白、拡大縮小、ヘッダーとフッターのテキストを保持し、プリンター、プレビュー、PDF のすべてがこれを使います
• ExportToPDF は、ページを 1 枚のタグ付き画像 (既定は 192 dpi) として書き出し、中心、ズーム、レイヤーとマーカーの数を示す代替テキストを付けます
• TsgcUIPDFOptions の PDFALevel で、アーカイブ用に PDF/A-2a または PDF/A-3a を、単独でも PDF/UA との併用でも追加できます

印刷とプレビューは、無料の Community 版を含むすべてのエディションで、VCL、FireMonkey、WinForms で使えます。FireMonkey では、印刷は Windows と macOS で、プレビューと PDF エクスポートはすべてのプラットフォームで動作します。PDF エクスポートには sgcUIPDF ブリッジとライセンスされた sgcPDF (.NET では NuGet パッケージ esegece.sgcUICore.sgcPDF) が必要なため、Community 版には含まれません。

アクセシビリティ

キーボードで操作でき、UI Automation に公開されるマップ

sgcMaps は、マップを代替テキスト、マーカーの一覧、レイヤーの一覧とともに Microsoft UI Automation に公開し、各レイヤーは表示されているかどうかを報告します。マーカーにはキーボードで移動できます。

• 矢印キーでマップをパンし、プラスキーとマイナスキーでズームし、Home で最初のビューに戻ります
• Page Up と Page Down で前後のマーカーへ移動し、Enter でフォーカスされたマーカーを実行し、Esc でマーカーのフォーカスを解除します
• マップは、フォーカスを持っている間、表示されるフォーカスリングを示します
• sgcMaps は .NET では WinForms コントロールなので、マップは WinForms でアクセシブルです

アクセシビリティは、無料の Community 版を含むすべてのエディションで既定で有効です。VCL では Delphi 7 から Delphi 13 までのすべての Delphi と C++Builder のバージョンで、FireMonkey では Windows で、そして WinForms で使えます。 Delphi と C++Builder では、AccessibleName と AccessibleDescription が UI Automation に公開される名前と説明を設定し、.NET では各フレームワーク標準のアクセシブルな名前とヘルプテキストが同じ役割を果たします。アクセシビリティ適合レポートを参照してください。 マップの画像は中心とズームだけで説明され、マップのレンダラーは Windows のハイコントラストに従いません。マップの画像はプロバイダーのタイル画像であるためです。