온톨로지의 지리공간 속성과 Mapbox 경계
벡터 데이터를 표와 지리공간 속성으로 구성하면 온톨로지 객체를 지도에서 조회하고 분석할 수 있습니다. 새 파이프라인에는 Pipeline Builder의 지리공간 기능을 사용합니다. geospatial-tools는 더 이상 유지보수하지 않는 Legacy 라이브러리입니다.
점: geopoint
geopoint는 WGS 84 위치를 다음 두 문자열 형식으로 받습니다.
| 형식 | 예시 |
|---|---|
| latitude,longitude | 57.64911,10.40744 |
| Geohash | u4pruydqqvj |
Geohash는 사각 영역의 왼쪽 아래 모서리 위치를 점으로 변환합니다. geopoint를 가진 객체는 지리공간 검색을 위해 색인합니다. 좌표 참조계와 입력의 위도 및 경도 순서를 확인합니다.
선과 다각형: geoshape
geoshape에는 GeoJSON Geometry를 문자열로 저장합니다. 다음 조건을 충족해야 합니다.
- 허용 Geometry는 LineString, Polygon, MultiLineString, MultiPolygon, MultiPoint와 Point입니다. 개별 점을 모델링할 때는 geopoint를 사용합니다.
- Feature, FeatureCollection과 GeometryCollection은 속성 값으로 사용할 수 없습니다.
- RFC 7946을 따르고 WGS 84 좌표를 사용합니다.
- Polygon과 MultiPolygon은 닫힌 링이어야 하고 바깥 링은 반시계 방향이어야 하며 자기 교차가 없어야 합니다. 구멍을 나타내는 내부 링은 RFC의 오른손 규칙에 따라 시계 방향으로 구성합니다.
다음은 유효한 선 Geometry 예시입니다. GeoJSON 위치 배열은 [경도, 위도] 순서이며, 이 Geometry를 JSON 문자열로 직렬화하여 속성 열에 넣습니다.
{
"type": "LineString",
"coordinates": [[100.0, 0.0], [101.0, 1.0]]
}
geoshape를 가진 객체도 지리공간 검색을 위해 색인합니다.
지도에서 사용
Foundry Map은 위치를 중심으로 탐색하고 시계열 오버레이, 링크 분석과 시뮬레이션 등을 수행하는 앱입니다. Workshop은 운영 앱을 만들면서 지도 위젯을 포함하는 경로입니다. Slate, Quiver, Object Explorer와 Contour에서도 지리공간 기능을 사용할 수 있습니다.
외부 feature service 또는 tile server를 데이터를 모두 데이터셋으로 가져오지 않고 지도 레이어로 연결하는 기능도 있습니다. 추가 구성이 필요하므로 사용할 서비스와 접근 조건을 Palantir 담당자에게 확인합니다.
Mapbox Boundaries v4
Mapbox Boundaries는 행정구역, 우편구역 등 관리된 경계 도형과 데이터셋 또는 온톨로지 값을 연결합니다. 경계의 유형, 레벨과 worldview를 선택하며, 경계 도형은 서로 맞닿도록 관리되어 지역별 색칠 지도에 사용할 수 있습니다.
지원되는 경계는 Boundaries Explorer와 Mapbox 경계 유형 및 레벨에서 확인합니다.
경계 정의 설치
- Foundry 환경의
/workspace/marketplace/discovery를 엽니다. - Mapbox를 검색하거나 Store 필터에서 Foundry Store를 선택합니다.
- Mapbox Boundary Definitions v4 상품을 고릅니다.
- Install을 선택합니다. 이미 설치되어 있으면 Open으로 기존 설치본을 엽니다.
설치할 공간(Space)을 고릅니다. 이 상품은 데이터셋만 포함하므로 온톨로지를 지정할 필요가 없습니다. Installation suffix를 켜면 설치할 프로젝트 이름을 바꿀 수 있습니다. 왼쪽 패널 아래 Install을 선택하고 작업이 끝나면 상품 이름 오른쪽 View installation을 엽니다.
오른쪽의 위치 링크에서 경계 데이터셋을 찾습니다. 기본 프로젝트 접근 권한은 설치한 사용자에게만 있으므로 필요한 사용자와 그룹은 프로젝트 상세 패널에서 추가합니다.
새 마이너 버전이 나오면 설치본 위의 배너에서 업그레이드할 수 있습니다. 메이저 버전은 별도 데이터 원천 상품으로 제공됩니다.
안전한 업그레이드를 위해 설치 프로젝트는 기본적으로 편집이 잠겨 있습니다. 경계 데이터를 사용하는 분석과 파이프라인은 다른 프로젝트에 저장하는 것이 권장됩니다. 설치 프로젝트 자체를 편집해야 한다면 Settings에서 Unlock을 선택합니다.
데이터에 mapbox_id 연결
선택한 경계 유형과 레벨의 지역을 식별하는 mapbox_id가 필요합니다. 설치 상품에 포함된 경계 메타데이터 표에는 지역 ID와 이름 등 조인에 사용할 열이 있습니다.
자신의 데이터에 이 메타데이터를 조인하여 mapbox_id 열을 추가합니다. 같은 지역명이라도 유형이나 레벨이 다른 경계를 연결하지 않도록 합니다. 이 열을 온톨로지 속성 또는 하위 앱의 경계 식별자 입력으로 사용합니다.
하위 앱 구성
Mapbox 경계는 Workshop, Contour, Foundry Map, 객체 뷰, Object Explorer와 Quiver에서 사용할 수 있습니다. 각 앱에서 다음 항목을 맞춥니다.
- mapbox_id를 가진 열 또는 속성
- 표시할 worldview
- 경계 유형과 레벨
앱별 색상 등 스타일은 데이터 값으로 구성합니다. Contour Map 보드는 지역 집계, 색상 구간과 선택 필터를 제공합니다.
이전 버전에서 v4로 이전
v2 또는 v3를 사용하는 경우 v4로 이전하면 경계 갱신과 지역 이름 툴팁, 경계 레이어의 자동 화면 맞춤 등의 개선을 사용할 수 있습니다. v3의 숫자 ID를 문자열로 바꾸는 것만으로는 v4 ID가 되지 않습니다.
| 항목 | v3 | v4 |
|---|---|---|
| 지역 식별 열 | feature_id | mapbox_id |
| 자료형 | integer | string |
| 식별 범위 | Boundaries 상품 안 | Mapbox 상품 전체 |
v3에서 옮기는 방법은 두 가지입니다.
- 상품에 포함된 v3에서 v4로의 ID 매핑표를 기존 데이터와 조인합니다. Mapbox 제공 CSV의 v3_feature_id와 v4_mapbox_id를 연결하여 출력의 mapbox_id를 만듭니다.
- v4 경계 메타데이터의 지역 ID나 이름 등으로 자신의 데이터를 처음부터 다시 조인합니다.
매핑표에는 국가, 경계 유형과 레벨의 이전 및 신규 값도 있습니다. 경계가 나뉘거나 레벨이 바뀐 경우 일대일 대응이 아닐 수 있습니다. v4에 없는 지역은 매핑표의 v4 값이 비어 있을 수 있으므로 새 경계 정의에 맞게 처리해야 합니다. Mapbox의 변경 목록을 확인합니다.
v4 lookup 표는 CSV로 제공됩니다. 이전 JSON lookup을 사용하던 파이프라인은 입력 형식과 바뀐 필드 이름도 맞춥니다. 이전된 mapbox_id를 파이프라인과 온톨로지에 반영한 뒤, 모든 하위 앱에서 v4 경계와 새 열 및 해당 유형과 레벨을 다시 선택합니다.