用途
map_layer: company_regions {
feature_key: "ISO_A3"
file: "/map_folder/regions.json"
format: topojson
label: "desired label for chart visualization"
max_zoom_level: 12
min_zoom_level: 2
projection: airy
property_key: "ISO_A3"
property_label_key: "NAME"
}
|
階層
map_layer |
デフォルト値
なし
許可
地図のレイヤの識別子と、地図のレイヤのプロパティを定義するサブパラメータ。 |
定義
map_layer パラメータを使用すると、カスタム地図のレイヤを定義できます。このレイヤを使用して、Looker で郡や郵便番号などの地域データをプロットし、マップグラフを作成できます。
地図のレイヤが存在する場合、通常はインタラクティブな地図のビジュアリゼーションがデフォルトの地図のビジュアリゼーションとして選択されます。唯一の例外は米国の州の地図です。Looker では、アラスカとハワイのインセットを使用するため、デフォルトで静的地図(地域)グラフが使用されます。
地図のレイヤは、TopoJSON ファイルまたは GeoJSON ファイルを受け入れることができます。カスタム地図のレイヤは、ライン ジオメトリとポリゴン ジオメトリのみをサポートしています。ポイント ジオメトリはサポートされていません。緯度と経度の座標を使用して地図上にポイントデータをプロットするには、代わりに type: location のディメンションを定義します。
カスタム マップレイヤ ファイルの作成の詳細については、カスタム マップ リージョンの作成のベスト プラクティスのページをご覧ください。
Looker では、ユーザーのブラウザタブに過剰な負荷がかからないように、カスタム地図のレイヤのファイルは 5 MB 未満にすることをおすすめします。
組み込みの地図のレイヤ
Looker にはいくつかの組み込みの地図のレイヤが含まれています。独自の地図のレイヤを作成する前に、組み込みの地図のレイヤを使用できるかどうかを確認してください。
countriesとus_statesの組み込み地図のレイヤでは、国名と州名に適切な大文字表記が使用されています。データは、大文字と小文字を区別して地図のレイヤにプロットされるため、これらの組み込みの地図のレイヤを使用するには、データでも大文字と小文字を適切に使用する必要があります。たとえば、データセットで「new delhi」と小文字で表記されている場合、組み込みの地図のレイヤでは「New Delhi」と表記されているため、データが正しくプロットされません。
countries- 完全な国名、ISO 3166-1 alpha-3 の 3 文字の国コード、または ISO 3166-1 alpha-2 の 2 文字の国コードを使用できます。データセットでは、これら 3 つのオプションのうち 1 つだけを使用する必要があります。これらのオプションを組み合わせて使用することはできません。データで ISO 3166-1 alpha-2 を使用している場合は、国ディメンションの定義に
map_layer_nameパラメータを含めて、Looker でデータが国コードとして認識され、誤って州コードとして解釈されないようにします。次に例を示します。
dimension: country {
type: string
map_layer_name: countries
sql: ${TABLE}.country ;;
}
uk_postcode_areas- 英国の郵便番号地域(例: リバプールの場合はL、レッドヒルの場合はRH、エディンバラの場合はEH)を指定できます。us_states- 完全な州名と 2 文字の州の略称を使用できます。us_counties_fips- 米国の郡の 5 文字の FIPS 郡コードである文字列フィールドで機能します。このレイヤはインタラクティブ マップでのみ機能します。us_zipcode_tabulation_areas- 5 文字の米国の郵便番号である文字列フィールドで機能します。type: zipcodeのディメンションでは、us_zipcode_tabulation_areas地図のレイヤが自動的に使用されます。郵便番号領域は、2010 年の郵便番号集計エリア(ZCTA)に基づいているため、この地図のレイヤには、私書箱に割り当てられた郵便番号など、領域に直接マッピングされない多くの郵便番号は含まれていません。
地図のレイヤを指定する
マップの場所は、ファイル名または URL を使用して指定できます。
GeoJSON ファイルを使用する場合は、file または url サブパラメータを使用する必要があります。必要に応じて、property_key と property_label_key を使用することもできます。feature_key サブパラメータは、GeoJSON ファイルではサポートされていません。GeoJSON 地図のレイヤを追加する一般的な構文は次のとおりです。
map_layer: identifier {
file: "/file_path/file_name.geojson" # or use the url subparameter
url: "string" # or use the file subparameter
property_key: "string"
property_label_key: "string"
}
TopoJSON 地図のレイヤを追加する一般的な構文は次のとおりです。
map_layer: identifier {
extents_json_url: "string"
feature_key: "string"
file: "/file_path/file_name.json" # or use the url subparameter
format: topojson | vector_tile_region
label: "string"
max_zoom_level: number
min_zoom_level: number
projection: airy # or one of many other choices
property_key: "string"
property_label_key: "string"
url: "string" # or use the file subparameter
}
ここで
| パラメータ | 型 | 説明 |
|---|---|---|
identifier |
文字列 | LookML で参照するマップの名前。 |
file |
文字列 | マップの場所。LookML プロジェクトの JSON ファイルの名前で指定します。ファイルは TopoJSON 形式または GeoJSON 形式で、拡張子は .json、.geojson、.topojson のいずれかである必要があります。JSON ファイルのフルパスを使用する必要があります(/maps/ ディレクトリ内のファイルの場合は "/maps/countryobjects.json" など)。JSON ファイルがフォルダ内ではなくルート ディレクトリにある場合は、"/countryobjects.json" のように、1 つのスラッシュでルート ディレクトリを示すことができます。プロジェクトのフォルダが有効になっていない場合は、JSON ファイルは LookML IDE ファイルリストのデータセクションに表示されます。これらの各シナリオの LookML については、このページの後半の例セクションをご覧ください。 |
extents_json_url |
文字列 | 地図のレイヤで使用可能な各領域の地理的範囲を定義した JSON ファイルの URL。このデータは、可視化のために利用可能なデータに地図を自動的にセンタリングするために使用されます。JSON ファイルは、キーが特徴のマッピング値(property_key で指定)で、値が地域の西経、南緯、東経、北緯の範囲を表す 4 つの数値の配列である JSON オブジェクトである必要があります。オブジェクトには、property_key のすべての可能な値のキーが含まれている必要があります。例: extents_json_url: "https://mycompany.com/mapserver/json-extent.js"。このパラメータを使用する場合は、url パラメータを使用して地図の場所を指定する必要があります。 |
feature_key |
文字列 | 地図のレイヤが参照する TopoJSON オブジェクトの名前。指定しない場合は、最初のオブジェクトが使用されます。 |
format |
キーワードtopojson または vector_tile_region |
領域情報のデータ形式。通常は topojson を使用します。 |
label |
文字列 | グラフ構成 UI に表示されます。 |
max_zoom_level |
数値 | ズームをサポートするビジュアリゼーションにおける、地図のレイヤのズーム操作の最大ズームレベル。 |
min_zoom_level |
数値 | ズームをサポートするビジュアリゼーションにおける、地図のレイヤのズームインの最小ズームレベル。 |
projection |
キーワード | 複数の地理投影をサポートするビジュアリゼーションに表示される場合の、地図のレイヤの優先地理投影。投影パラメータを追加すると、LookML エディタに利用可能な投影が多数表示されます。 |
property_key |
文字列 | プロットする TopoJSON データのプロパティ。TopoJSON は、各リージョンの任意のメタデータをサポートしています。デフォルトでは、最初に一致したプロパティが使用されます。プロットする特定のメタデータ プロパティがある場合は、ここで指定します。 |
property_label_key |
文字列 | 領域のラベルに使用する TopoJSON データのプロパティ。これは、マッピング値(property_key で定義)が対人可読ではない場合に便利です。 |
url |
文字列 | マップの場所。マップファイルを含む URL で指定します。 |
例
可能であれば、マップファイルをプロジェクトに追加し、file パラメータを使用してマップファイルを指定します。
JSON ファイルのフルパスを使用する必要があります。プロジェクトのフォルダが有効になっていない場合は、JSON ファイルは LookML IDE ファイルリストのデータセクションに表示されます。
たとえば、プロジェクトでフォルダが有効になっていて、maps というディレクトリに my_neighborhoods.json という近隣地域のカスタム地図がある場合は、次のようにフルパスを使用します。
map_layer: neighborhoods {
file: "/maps/my_neighborhoods.json"
}
プロジェクトでフォルダを使用していない場合、アップロードされたマップファイルはプロジェクトの [データ] セクションに表示されます。この場合は、my_neighborhoods.json ファイルの名前を指定するだけです。
map_layer: neighborhoods {
file: "my_neighborhoods.json"
}
または、カスタム neighborhoods マップが別の場所(https://wherever.com/my_neighborhoods.json など)でホストされるように指定することもできます。
map_layer: neighborhoods {
url: "https://wherever.com/my_neighborhoods.json"
}
マップレイヤを定義したら(ファイルを指定するか、url パラメータを使用)、ディメンションの値をカスタムマップ上の地理的リージョンに関連付けるように指定できます。ディメンションで、map_layer_name パラメータを使用して、map_layer パラメータで使用した名前を指定します。
dimension: neighborhood {
type: string
map_layer_name: neighborhoods # this is your map layer
sql: ${TABLE}.neighborhood_code
}
このディメンションをクエリしてビジュアリゼーション セクションを開くと、Looker は、モデルファイルの map_layer パラメータで定義されている neighborhoods JSON ファイルを使用してデータをグラフ化します。
知っておくべきこと
静的マップ(リージョン)グラフ
静的地図(地域)グラフで [地図] を [自動] に設定するには、LookML モデルで map_layer を指定して地図のレイヤを指定する必要があります。このパラメータを設定しない場合、ユーザーが [自動] を選択するとエラーが発生しますが、Looker の組み込みマップは引き続き使用できます。
GeoJSON ファイル
TopoJSON ファイルと同様に、GeoJSON ファイルは .geojson または .json のファイル拡張子を使用できますが、GeoJSON 形式の地理データが含まれている必要があります。GeoJSON ファイルを使用する場合は、file または url サブパラメータを使用する必要があります。また、必要に応じて property_key と property_label_key を使用することもできます。
IDE フォルダでの map_layer の使用
プロジェクトで IDE フォルダが有効になっている場合は、map_layer のプロジェクト ファイルを指定するときにパスを使用する必要があります。
map_layer: neighborhoods {
file: "/maps/my_neighborhoods.json"
}