Looker 22.16 문서를 보고 있습니다. 최신 문서는 여기에서 확인할 수 있습니다.

지도 레이어

용도

map_layer: company_regions {
feature_key: 'ISO_A3"level_labelminlabely1

_

"
"
"

프로젝트 이미지

계층 구조

모델 파일

map_layer

기본값

없음

결제 가능

지도 레이어의 식별자 및 지도 레이어 속성을 정의하는 하위 매개변수입니다.

정의

map_layer 매개변수를 사용하면 Looker에서 카운티 데이터 또는 우편번호와 같은 지역 데이터를 표시하고 지도 차트를 생성할 수 있는 맞춤 지도 레이어를 정의할 수 있습니다.

지도 레이어가 있는 경우 일반적으로 대화형 지도 시각화가 기본 지도 시각화로 선택됩니다. 한 가지 예외는 미국 지도로, Looker에서 기본적으로 정적 지도 지역 차트를 사용합니다. 알래스카 및 하와이의 인셋을 사용하기 때문입니다.

지도 레이어는 TopoJSON 또는 GeoJSON 파일을 사용할 수 있습니다. 하지만 기존 대시보드는 GeoJSON 파일을 사용하는 지도를 지원하지 않습니다.

맞춤 지도 레이어 파일 만들기에 대한 자세한 내용은 맞춤 지도 지역 만들기 고객센터 도움말을 참조하세요.

사용자의 브라우저 탭에 과부하가 걸리지 않도록 맞춤 지도 레이어 파일을 5MB 미만으로 유지하는 것이 좋습니다.

기본 제공되는 지도 레이어

Looker에는 몇 가지 기본 지도 레이어가 포함되어 있습니다. 자체 지도 레이어를 만들기 전에 기본 제공되는 지도 레이어 중 하나를 사용할 수 있는지 확인하세요.

기본 제공 countries 및 us_states 지도 레이어에서는 국가 및 시/도 이름에 적절한 대문자를 사용합니다. 데이터는 대소문자를 구분하는 방식으로 지도 레이어에 표시됩니다. 따라서 기본 제공되는 지도 레이어를 사용하려면 데이터에 적절한 대문자를 사용해야 합니다. 예를 들어 데이터 세트가 소문자 '뉴델리'를 사용하는 경우 '뉴델리'를 사용하는 기본 지도 레이어에 데이터가 올바르게 표시되지 않습니다.

countries — 전체 국가 이름, ISO 3166-1 alpha-3 3자리 국가 코드 또는 ISO 3166-1 alpha-2 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 하위 매개변수만 참조하면 됩니다. GeoJSON 지도 레이어를 추가하는 일반적인 구문은 다음과 같습니다.

map_layer: identifier {
  file: "/file_path/file_name.geojson"
}

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"` 프로젝트에 폴더가 사용 설정되지 않은 경우 Looker는 LookML IDE 파일 목록의 데이터 섹션에 JSON 파일을 표시합니다. 이러한 시나리오의 경우 이 페이지의 후반부에 나오는 예시 섹션에서 LookML을 참조하세요.
`extents_json_url`	문자열	지도 레이어에서 사용할 수 있는 각 지역의 지리적 범위를 정의하는 JSON 파일의 URL입니다. 이 데이터는 시각화를 위해 사용 가능한 데이터에 자동으로 지도의 중심을 맞추는 데 사용됩니다. JSON 파일은 JSON 객체여야 하며 키는 특성의 매핑 값 (`property_key`로 지정)이고 값은 해당 지역의 서쪽 경도, 남쪽 위도, 동쪽 경도, 북쪽 위도 범위를 나타내는 4개의 숫자 배열입니다. 객체에는 가능한 모든 `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로 지정된 지도의 위치입니다.

Examples

가능하면 프로젝트에 지도 파일을 추가한 다음 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"
}

또는 https://wherever.com/my_neighborhoods.json와 같은 다른 위치에서 맞춤 neighborhoods 지도가 호스팅되도록 지정할 수 있습니다.

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 하위 매개변수만 참조하면 됩니다.

기존 대시보드는 GeoJSON 파일을 사용하는 지도를 지원하지 않습니다.