地図の背景
グラフィカルビューは、Google Maps または MapTiler の実際の地図上に配置できます。ビュー全体の背景として設定することも、ビュー上に配置した Static Map ウィジェットとして使用することも可能です。地図画像は NetCrunch Server によって取得されるため、API キーがブラウザーに渡ることはありません。
サイトの図は、何と何が接続されているかを示します。地図上の図であれば、それがどこにあるか — どの建物、どのキャンパス、どの国か — まで把握できます。訪れたことのない場所で発生したアラートを理解するには、こちらのほうが早い場合がよくあります。
2 種類の地図
NetCrunch では 2 種類の地図を利用できますが、それぞれ解決する問題が異なります。
- Geographic Vector
- 組み込みの等高線マップです。国や地域がベクターとして描画されます。インターネット接続やアカウントは必要なく、ぼやけることなく拡大縮小でき、座標を使用して要素を配置できます。大陸、国、地域のビューにはこちらを使用してください。グラフィカルダッシュボードを参照してください。
- Google Maps and MapTiler
- プロバイダーから取得する実際の地図です。道路、地名、地形などが表示されます。ベクターマップと同様に、座標を使用して要素を配置できます。等高線マップで表示できるレベルよりも詳細な情報が必要な場合に使用してください。たとえば、キャンパス、工業団地、市街地区などです。
地図を背景として設定する
グラフィカルビューエディター ビュープロパティ 背景
Type リストには、None、Geographic Vector、Google Maps、Maptiler Maps、Image が表示されます。2 つの地図プロバイダーのいずれかを選択すると、地域を選択するためのピッカーが開きます。
- 名前を入力して住所または場所を検索するか、地図をドラッグして移動します。
- 目的の地域までズームします。範囲は 2 ～ 20 です。Google Maps は整数単位でズームインします。MapTiler は 0.5 単位でズームインするため、2 つのレベルの間に設定できます。
- Confirm をクリックします。
選択した地域はビューとともに保存され、その上にビューが描画されます。
Static Map ウィジェット
同じ地図を、パレットから Static Map ウィジェットとして利用できます。地図をビュー全体の背後ではなく、ビューの一部に配置する場合に使用してください。たとえば、複数のゲージの横にサイトパネルを配置する場合や、1 つのダッシュボードに 2 つの場所を横並びで表示する場合などです。
このウィジェットは場所の画像であり、座標系ではありません。ウィジェット上にドロップした要素は、他の要素と同様に手動で配置されます。地理的位置の機能は、地図がビューの背景として設定されている場合にのみ動作します。ノードを緯度と経度に基づいて自動配置する場合は、ウィジェットではなく地図の背景を使用してください。
プロバイダーによる違い
2 つのプロバイダーは動作が異なるため、利用できるコントロールも異なります。
- Google Maps
- 個々の要素をオンまたはオフにできます。対象は Countries、Regions、Cities、Roads、Street names、Road signs です。デフォルトでは Countries、Cities、Street names、Road signs が表示され、Regions と Roads は表示されません。スタイルのリストはなく、外観はこれらの切り替えによってのみ制御されます。
- MapTiler
- 代わりに Map style を選択します。選択肢は Base、Dataviz、OpenStreetMap、Streets、Winter、Japan GSI です。デフォルトは Streets ですが、日本語版では Japan GSI です。要素ごとの切り替えはなく、選択したスタイルによって描画内容が決まります。
座標を使用した要素の配置
地図がビューの背景として設定されている場合、要素を手動ではなく地理的に配置できます。位置情報を持つノードは、配置時にドロップされた場所ではなく、地図上のその位置に描画されます。
これが、地図の背景と地図の画像が異なる点です。また、地理的位置が重要な場合にウィジェットよりも背景を優先する理由でもあります。この機能は、両方のプロバイダーの地図と Geographic Vector マップで利用できます。
ライトテーマとダークテーマ
地図は、ビューの描画に使用されているテーマに従います。MapTiler のスタイルはダークバリアントに切り替わり、Google Maps はダークな地図スタイルに切り替わります。そのため、ビュー定義を複製しなくても、1 つのビューを両方のテーマで適切に表示できます。
Japan GSI にはダークバリアントがないため、そのまま表示されます。Japan GSI を中心にダークダッシュボードを作成した場合、地図は明るいままになります。
map-api-keys
API キー
設定 NetCrunch システム Server External Services
地図画像は商用サービスから取得され、各プロバイダーによって使用量が計測されます。
- キーを設定しない場合、NetCrunch は独自の組み込み共有クォータを使用します。公正利用の制限が適用されます。機能の評価や、ときどき使用する程度であれば十分です。
- 独自のキーを使用する場合、リクエストはアカウントに対して課金され、公正利用の上限は適用されません。壁面ディスプレイで常時表示するダッシュボードを作成する場合は、事前にキーを設定してください。このようなダッシュボードでは、1 日に 2 回開く程度のダッシュボードよりもはるかに頻繁に画像が再取得されます。
- Google Maps API key
console.cloud.google.comで Maps Static API と Geocoding API を有効にして作成します。ピッカーの住所検索では Geocoding が使用されます。Geocoding を有効にしていないキーでも地図は動作しますが、検索結果がまったく見つからなくなります。- MapTiler API key
cloud.maptiler.comで作成します。無料プランには、月 100,000 件のタイルリクエストが含まれます。
各キーには Test ボタンがあり、プロバイダー経由でサンプルを取得してキーが機能するかどうかを報告します。そのため、空のダッシュボードを見て初めて問題に気付くのではなく、設定時に確認できます。
キーがブラウザーに渡ることはありません。コンソールは NetCrunch Server に画像を要求し、サーバーが設定済みのキーをプロバイダーの URL に組み込んで、画像自体を取得します。コンソールが Google や MapTiler に直接接続することはないため、ページからキーを読み取ることはできません。また、監視対象ネットワーク上のブラウザーがいずれかのプロバイダーへ外部接続する必要もありません。必要なのはサーバーからの接続だけです。
地図が表示されない場合
Map unavailable と表示されたパネルは、サーバーが画像を取得できなかったことを示します。通常の原因は次のとおりです。確認する場合は、この順番が適しています。
- NetCrunch Server にプロバイダーへの外部接続がない
- 設定されたキーが間違っている、期限切れになっている、または必要な API が不足している — Test を使用して、ネットワークの問題と区別します
- アカウントのクォータを使い切っている、または組み込み共有クォータがレート制限を受けている