사용
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 파일을 허용할 수 있습니다.
맞춤 지도 레이어 파일 만들기에 대한 자세한 내용은 맞춤 지도 영역 만들기 권장사항 페이지를 참고하세요.
사용자의 브라우저 탭이 과부하되지 않도록 맞춤 지도 레이어 파일의 크기를 5MB 미만으로 유지하는 것이 좋습니다.
기본 제공 지도 레이어
Looker에는 여러 기본 제공 지도 레이어가 포함되어 있습니다. 자체 지도 레이어를 만들기 전에 내장 지도 레이어를 사용할 수 있는지 확인하세요.
countries및us_states기본 제공 지도 레이어는 국가 및 주 이름에 적절한 대문자를 사용합니다. 데이터는 대소문자를 구분하여 지도 레이어에 표시되므로 이러한 내장 지도 레이어를 사용하려면 데이터에도 적절한 대소문자를 사용해야 합니다. 예를 들어 데이터 세트에서 소문자 'new delhi'를 사용하는 경우 'New Delhi'을 사용하는 내장 지도 레이어에 데이터가 올바르게 표시되지 않습니다.
countries- 전체 국가 이름, ISO 3166-1 alpha-3 세 자리 국가 코드 또는 ISO 3166-1 alpha-2 두 자리 국가 코드를 허용합니다. 데이터 세트에서는 이 세 가지 옵션 중 하나만 사용해야 합니다. 이러한 옵션을 혼합하여 사용할 수는 없습니다.데이터에 ISO 3166-1 alpha-2가 사용되는 경우에는 Looker에서 데이터를 국가 코드로 인식하고 상태 코드로 잘못 해석하는 일이 없도록 국가 측정기준의 정의에
map_layer_name매개변수를 포함해야 합니다. 예를 들면 다음과 같습니다.
dimension: country {
type: string
map_layer_name: countries
sql: ${TABLE}.country ;;
}
uk_postcode_areas- 영국 우편번호 지역을 허용합니다 (예: 리버풀의 경우L, 레드힐의 경우RH, 에든버러의 경우EH).us_states- 전체 주 이름과 두 글자 주 약어를 허용합니다.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를 선택적으로 사용할 수도 있습니다. GeoJSON 파일에는 feature_key 하위 매개변수가 지원되지 않습니다. 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 확장자 중 하나를 사용해야 합니다. /maps/ 디렉터리의 파일의 경우 "/maps/countryobjects.json"와 같이 JSON 파일의 전체 경로를 사용해야 합니다. JSON 파일이 루트 디렉터리에 있고 폴더에 없는 경우 다음과 같이 슬래시 하나로 루트 디렉터리를 나타낼 수 있습니다. "/countryobjects.json" 프로젝트에서 폴더가 사용 설정되지 않은 경우 Looker는 LookML IDE의 파일 목록에 있는 데이터 섹션에 JSON 파일을 표시합니다. 각 시나리오의 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 파일의 전체 경로를 사용해야 합니다. 프로젝트에서 폴더가 사용 설정되지 않은 경우 Looker는 LookML IDE의 파일 목록에 있는 데이터 섹션에 JSON 파일을 표시합니다.
예를 들어 프로젝트에서 폴더가 사용 설정되어 있고 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"
}