GeOnDT GeOnDT for JS

Class: U2dShpLayer

U2dShpLayer

~extends U3dOpenLayer
SHP에서 변환한 GeoJSON FeatureCollection을 브라우저 지도 렌더러인 OpenLayers의 벡터 레이어로 표시합니다.
생성 후 addFeatureCollection()에 피처를 전달하면 sourceCRS에서 crs로 변환하여 타일 레이어에 등록합니다. 피처의 채우기, 외곽선과 라벨은 생성자 style 또는 setStyle()로 지정합니다.

new U2dShpLayer(opt)

모든 옵션을 생략할 수 있으며, 생략한 스타일 속성에는 U2dShpStyle에 기록된 기본값을 적용합니다. style 객체를 전달하면 복사한 뒤 누락된 기본값을 채워 호출자의 객체와 내부 상태를 분리합니다.

Name Type Default Description
opt Partial.<U2dShpLayerCO> {} optional

레이어 이름, 좌표계, 표시 레벨과 피처 스타일 설정

Methods

addFeatureCollection(data)U2dShpLayer

현재 sourceCRS의 GeoJSON FeatureCollection을 대상 crs의 OpenLayers 피처로 변환하여 등록합니다.
기존 피처와 레이어 콜백은 새 입력으로 교체합니다.

Name Type Description
data U2dShpFeatureCollection

type이 FeatureCollection인 GeoJSON 피처 모음
Returns:
Type Description
U2dShpLayer 현재 레이어

dispose()

이 레이어가 보유한 피처 참조와 진행 중인 DXF 로드 결과를 무효화한 뒤 부모 자원을 해제합니다.

getBoundingBox()Box3|undefined

마지막으로 추가한 모든 피처의 범위를 GeOnDT 월드 좌표로 변환하여 Three.js 바운딩 박스로 반환합니다.

Returns:
Type Description
Box3 | undefined 전체 피처의 월드 좌표 범위. 피처가 없으면 undefined

getCRS()string

OpenLayers 피처가 사용하는 대상 좌표계 식별자를 반환합니다.

Returns:
Type Description
string 대상 좌표계 식별자

getLabelFunction()undefined|function

현재 피처별 라벨 생성 함수를 반환합니다.

Returns:
Type Description
undefined | function 라벨 생성 함수

getMaxLevel()number

레이어가 표시되는 마지막 지도 레벨을 반환합니다.

Returns:
Type Description
number 최대 지도 레벨

getMinLevel()number

레이어가 표시되기 시작하는 최소 지도 레벨을 반환합니다.

Returns:
Type Description
number 최소 지도 레벨

getParam()U2dShpLayerParam

이름, 표시 레벨, 좌표계와 스타일을 새 설정 객체에 담아 반환합니다.
반환 객체의 style은 복사본이므로 호출자가 변경해도 레이어 내부 스타일은 바뀌지 않습니다.

Returns:
Type Description
U2dShpLayerParam 현재 레이어 설정과 스타일 복사본을 담은 객체

getSourceCRS()string

원본 SHP 데이터 좌표계를 나타내는 EPSG 식별자를 반환합니다.

Returns:
Type Description
string EPSG:5179와 같은 원본 데이터 좌표계 식별자

getStyle()U2dShpStyle

새 피처에 적용할 현재 스타일의 복사본을 반환합니다.

Returns:
Type Description
U2dShpStyle 호출자가 안전하게 변경할 수 있는 스타일 복사본

getUrl()string|undefined

생성 옵션으로 저장한 데이터 URL을 반환합니다.

Returns:
Type Description
string | undefined 저장된 데이터 URL

parseDxfFromUrl(url)Promise.<void>

URL의 DXF 데이터를 비동기로 읽고 로드가 끝나면 반환된 Three.js 객체를 레이어 장면에 추가합니다.
SHP 레이어와의 역할 중복 때문에 새 코드에서는 U2dDxfLayer 사용을 권장합니다.

Name Type Description
url string

UDXFLoader가 요청할 DXF 파일 URL
Deprecated
  • DXF 데이터는 `U2dDxfLayer`로 로드하십시오.
    Returns:
    Type Description
    Promise.<void> 로드와 장면 등록이 끝나면 완료되고 실패 또는 dispose 시 거부되는 Promise

    setCRS(crs)U2dShpLayer

    대상 좌표계를 바꾸고 이미 등록된 GeoJSON 피처를 새 좌표계로 다시 변환합니다.

    Name Type Description
    crs string

    새 대상 좌표계 식별자
    Returns:
    Type Description
    U2dShpLayer 현재 레이어

    setLabelFunction(labelFunction)U2dShpLayer

    피처별 라벨 생성 함수를 교체하고 이미 등록된 피처의 라벨을 갱신합니다.

    Name Type Description
    labelFunction undefined | function

    새 라벨 생성 함수
    Returns:
    Type Description
    U2dShpLayer 현재 레이어

    setMaxLevel(maxLevel)U2dShpLayer

    최대 지도 레벨을 변경하고 화면을 갱신합니다.

    Name Type Description
    maxLevel number

    새 최대 지도 레벨
    Returns:
    Type Description
    U2dShpLayer 현재 레이어

    setMinLevel(minLevel)U2dShpLayer

    최소 지도 레벨을 변경하고 화면을 갱신합니다.

    Name Type Description
    minLevel number

    새 최소 지도 레벨
    Returns:
    Type Description
    U2dShpLayer 현재 레이어

    setSourceCRS(sourceCRS)U2dShpLayer

    원본 데이터 좌표계를 바꾸고 이미 등록된 GeoJSON 피처를 새 좌표계 기준으로 다시 변환합니다.

    Name Type Description
    sourceCRS string

    EPSG:5179와 같은 원본 데이터 좌표계 식별자
    Returns:
    Type Description
    U2dShpLayer 현재 레이어

    setStyle(style)U2dShpLayer

    전달한 속성을 현재 스타일과 얕게 병합하고 새 스타일 객체로 교체합니다.
    이미 등록된 피처에도 스타일을 다시 적용하고 렌더링 source를 갱신합니다.

    Name Type Description
    style Partial.<U2dShpStyle>

    현재 값에서 바꿀 채우기, 외곽선 또는 라벨 속성
    Returns:
    Type Description
    U2dShpLayer 현재 레이어

    setUrl(url)U2dShpLayer

    데이터 URL을 저장합니다. 이 메서드는 URL을 자동으로 요청하지 않습니다.

    Name Type Description
    url string | undefined

    저장할 데이터 URL
    Returns:
    Type Description
    U2dShpLayer 현재 레이어