GIS 클라우드(미리 보기)
이 커넥터를 사용하면 사용자가 GIS Cloud에서 생성된 유효한 권한 부여 키를 사용하여 지도 프로젝트 목록, 정의된 계층 및 해당 계층에 포함된 기능에 액세스할 수 있습니다. 기능 스키마의 동적 특성을 수용하기 위해 커넥터는 지정된 계층의 기능 스키마에 대한 서비스를 동적으로 쿼리합니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | GIS 클라우드 프리미엄 지원 |
| URL | https://docs.giscloud.com/rest |
| 전자 메일 | premiumsupport@giscloud.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | HandyGeo 솔루션 |
| 웹 사이트 | http://www.giscloud.com |
| 개인 정보 보호 정책 | https://www.giscloud.com/privacy-policy/ |
| 카테고리 | 데이터; 비즈니스 인텔리전스 |
GIS Cloud는 모든 공동 작업 매핑 요구 사항을 용이하게 하기 위해 강력한 양식 엔진과 함께 동급 최고의 웹 및 모바일 맵 렌더링을 제공하는 SaaS 플랫폼입니다. GIS 클라우드 커넥터는 자동화가 Map 프로젝트에 대한 대부분의 일반적인 사용 사례를 구동할 수 있도록 하는 광범위하고 강력한 REST API의 하위 집합을 제공합니다. 이 커넥터는 GIS 클라우드 맵, 계층, 사용자를 나열, 업데이트 및 상호 연결하고 기능 및 파일도 만들 수 있습니다. 이 하위 집합을 사용하여 사용자는 검사를 위한 새 기능 만들기, 보고서 만들기, 대시보드용 데이터 내보내기 등과 같은 많은 데이터 기반 작업을 자동화할 수 있습니다.
필수 조건
GIS 클라우드 커넥터를 사용하려면 맵 편집기 구독이 있는 GIS 클라우드 사용자 계정이 있어야 합니다. 그렇지 않으면 많은 작업이 작동하지 않습니다.
자격 증명을 가져오는 방법
GIS Cloud REST API는 API 키를 통해 보호됩니다. 대부분의 REST 엔드포인트는 유효한 API 키가 없으면 작동하지 않습니다.
유효한 API 키를 가져오려면 GIS Cloud 계정으로 이동하여 https://manager.giscloud.com 로그인합니다.
오른쪽 위에서 사용자 이름을 클릭하고 드롭다운 메뉴에서 "내 계정"을 선택합니다.
팝업 모달에서 "API 액세스" 탭을 선택합니다. "새 API 키 설명" 상자에 키에 대한 설명이 포함된 이름을 입력하고 "키 추가"를 클릭합니다. 새 모달은 다시 표시되지 않으므로 안전하게 복사하고 저장해야 하는 새 API 키를 표시합니다.
추가 참조는 다음을 참조하세요. https://docs.giscloud.com/rest#creating-an-api-key
이 작업이 완료되면 커넥터를 만들고 테스트할 수 있습니다.
커넥터 시작
커넥터를 처음 설정할 때 GetCurrentUser 작업을 통해 테스트하면 API 키가 유효한지 확인하고 API 키와 연결된 계정 세부 정보를 반환합니다.
대부분의 사용자는 자동화에서 GetFeatures, CreateFeature, UpdateFeature 및 DeleteFeature 작업을 활용합니다. 포함된 다른 작업은 주로 지정된 자동화 시나리오의 상황별 조정에 사용됩니다.
일반적인 자동화 시나리오는 Power BI 대시보드를 만들기 위해 SaaS 데이터베이스의 GIS Cloud 기능을 Dataverse 테이블 또는 Excel 시트로 동기화하는 것입니다. 데이터 구조에 따라 사용자 지정 Dataverse 엔터티를 만들어야 할 수 있습니다. 자동화는 GetFeatures 작업의 매개 변수를 활용하여 where 지난 며칠 동안 수정된 기능으로 제한하고 동기화하는 것이 좋습니다. 이렇게 하면 자동화의 성능이 최적화됩니다.
또 다른 일반적인 자동화 시나리오는 Dynamics, SalesForce, HTTP 요청 또는 GIS Cloud 자체와 같은 보조 데이터 원본을 기반으로 자동으로 새 GIS Cloud 기능을 만드는 것입니다. 이를 위해 사용자는 보조 데이터 원본을 필터링하여 기능 생성을 트리거하는 방법을 신중하게 고려하고 자동화를 만들기 전에 GIS 클라우드 대상 계층 스키마를 완료한 후 개발을 간소화하는 것이 좋습니다.
마지막 일반적인 자동화 시나리오는 특정 조건(예: 열에 설정된 특정 상태)을 충족하는 기능을 다른 계층으로 복사한 다음 원래 GIS 클라우드 기능을 성공적으로 삭제하여 GIS 클라우드 기능을 자동으로 "보관"하는 것입니다. 이렇게 하면 중요한 데이터가 손실되지 않고 활성 맵 프로젝트를 시각적으로 깨끗하게 유지할 수 있습니다.
알려진 문제 및 제한 사항
PowerApps에 대한 인증 호환성
HandyGeo Services에서 게시한 PCF 맵 구성 요소와의 호환성을 돕고 사용자에게 친숙하지 않은 API 키에 대한 PowerApps 사용자에게 메시지를 표시하지 않도록 하기 위해 모든 요청에 API 키를 지정하도록 커넥터를 만들었습니다.
기능 엔드포인트에 대한 동적 데이터 스키마
사용자가 업로드한 데이터에서 시작된 GIS Cloud의 지리적 기능으로 인해 스키마는 항상 데이터 세트에 따라 다릅니다. 따라서 모든 기능 엔드포인트의 페이로드 및 응답에 대한 스키마는 항상 동적이며 사용 중인 Office 365 제품의 동적 스키마에 대한 지원이 필요합니다. 이는 일반적으로 PowerAutomate에서 잘 지원되지만 PowerApps에서 문제를 제시할 수 있습니다.
일반적인 오류 및 해결
엔드포인트 페이지 매김
GIS 클라우드 엔드포인트는 단일 요청에서 반환되는 최대 5,000개의 레코드로 제한됩니다. REST API는 페이지 매김을 지원하지만 현재 커넥터 동작에 이를 자동으로 포함할 수 있는 방법은 없습니다.
서비스 보호를 위한 REST API 속도 제한
프로덕션 REST API 서비스에서 예상한 대로 GIS Cloud API에 대한 과도한 요청 수가 짧은 시간 안에 이루어지면 응답은 5xx 코드가 됩니다. 특정 속도 제한이 명시적으로 정의되지는 않았지만 REST API는 제한된 병렬 루프 속도(예: 약 20)를 지원하지만 높은 비율은 상당한 실패를 초래할 수 있습니다. 실패한 응답은 재시도 정책으로 관리할 수 있지만 과도한 속도로 인해 문제가 발생합니다.
동적 기능 데이터 스키마가 없습니다.
커넥터가 스키마 정의를 조회해야 하기 때문에 계층 ID 및/또는 API 키 매개 변수가 동적으로 전달되면 Action은 사용자가 반환된 JSON을 수동으로 관리해야 하는 계층 스키마를 캐시할 수 없습니다. 동적 매개 변수를 매개 변수 상자에 입력하여 정적 값으로 바꾸고 스키마가 적절하게 캐시됩니다.
자주 묻는 질문(FAQ)
GetFeatures 작업은 너무 많은 기능을 반환합니다. 원하는 기능만 어떻게 얻을 수 있나요?
가능한 경우 사용자가 GetFeatures 작업에서 사용할 수 있는 절을 활용하는 where 것이 좋습니다. 대부분의 SQL 규격 WHERE 절을 수용할 수 있습니다. 플랫폼에서 관리하는 레코드 수정 날짜와 같은 필드의 경우 사용자가 GetColumns 작업을 테스트하여 시스템 열의 실제 논리적 이름을 보는 것이 좋습니다.
내 스토리지가 아닌 Map 프로젝트 소유자 스토리지에 파일을 업로드하려면 어떻게 해야 하나요?
UploadFileToPath 작업의 경우 매개 변수가 채워진 Map 프로젝트 소유자 계정에 Destination Map ID (destination_map) 대한 API 키가 아닌 경우 반드시 필요합니다. 그러면 업로드된 파일이 인증된 사용자가 아니라 지정된 맵 프로젝트의 소유자에 대한 파일임을 GIS Cloud REST API에 알릴 수 있습니다. 사용자에게 지도에 액세스할 수 있는 권한이 없는 경우 업로드가 맵 오웬어 계정으로 라우팅되지 않습니다.
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| ID로 사용자 개체 가져오기 |
사용자 ID로 GIS 클라우드 사용자 개체를 가져옵니다. |
| 계층에 대한 열 가져오기 |
레이어에 대한 열 목록 가져오기 |
| 계층의 기능 가져오기 |
계층 개체의 모든 GIS 클라우드 기능 개체를 가져옵니다. |
| 기능 가져오기 |
계층 개체에서 하나의 GIS 클라우드 기능 개체를 가져옵니다. |
| 기능 필드에서 미디어 파일 가져오기 |
계층 개체의 GIS 클라우드 기능 개체 필드에서 미디어 파일을 하나 가져옵니다. |
| 레이어에서 새 기능 만들기 |
계층 개체의 모든 GIS 클라우드 기능 개체를 가져옵니다. |
| 맵 캐시 삭제 |
API를 통해 변경된 내용을 반영하도록 맵 타일 캐시를 삭제합니다. |
| 모든 계층 가져오기 |
모든 GIS 클라우드 계층 개체를 가져옵니다. |
| 모든 맵 가져오기 |
모든 GIS 클라우드 맵 개체를 가져옵니다. |
| 업데이트 기능 |
계층 개체에서 하나의 GIS 클라우드 기능 개체를 업데이트합니다. |
| 지도의 모든 레이어 가져오기 |
단일 GIS 클라우드 맵 개체에 대한 모든 계층 개체를 가져옵니다. |
| 파일 하나 가져오기 |
GIS Cloud Storage에서 하나의 파일을 다운로드합니다. |
| 파일 하나 업로드 |
GIS Cloud Storage에 파일을 업로드합니다. |
| 파일 하나 제거 |
GIS Cloud Storage에서 파일을 제거합니다. |
| 피쳐 삭제 |
계층에서 지정된 GIS Cloud 기능 개체를 삭제합니다. |
| 하나의 레이어 가져오기 |
모든 GIS 클라우드 계층 개체를 가져옵니다. |
| 하나의 맵 가져오기 |
하나의 GIS 클라우드 맵 개체를 가져옵니다. |
| 하나의 맵 렌더링 |
하나의 GIS 클라우드 맵 개체의 이미지를 렌더링합니다. |
| 하나의 맵 삭제 |
GIS 클라우드 맵 프로젝트 하나 삭제 |
| 하나의 맵 업데이트 |
하나의 GIS 클라우드 맵 프로젝트 업데이트 |
| 한 계층 삭제 |
하나의 GIS 클라우드 계층 개체를 삭제합니다. |
| 한 계층 업데이트 |
하나의 GIS 클라우드 계층 개체를 업데이트합니다. |
| 현재 사용자 개체 가져오기 |
현재 GIS 클라우드 사용자 개체를 가져옵니다. |
ID로 사용자 개체 가져오기
사용자 ID로 GIS 클라우드 사용자 개체를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
사용자 ID
|
user_id | True | integer |
특정 사용자를 식별하는 데 사용되는 내부 사용자 ID |
|
특성 확장
|
expand | string |
열거형 옵션 중 하나로 응답 확장 |
반환
- 몸
- User
계층에 대한 열 가져오기
레이어에 대한 열 목록 가져오기
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
계층 ID
|
layer_id | True | integer |
특정 계층을 식별하는 데 사용되는 내부 계층 ID |
계층의 기능 가져오기
계층 개체의 모든 GIS 클라우드 기능 개체를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
계층 ID
|
layer_id | True | integer |
특정 계층을 식별하는 데 사용되는 내부 계층 ID |
|
기하 도형 포함
|
geometry | string |
기하 도형이 압축되는 형식입니다. 가능한 값: 'wkt', 'kml' 및 'gml' |
|
|
EPSG 프로젝션
|
epsg | integer |
출력 프로젝션에 대한 EPSG 코드입니다. 지정하지 않으면 기본 맵 프로젝션이 사용됩니다. |
|
|
공간 범위
|
bounds | string |
공간 필터링에 사용되는 경계 상자 |
|
|
SQL 위치
|
where | string |
특성 필터링에 사용되는 SQL 형식 where 절 |
|
|
주문 기준
|
order_by | string |
대상 GIS Cloud 개체에 있는 열을 참조해야 합니다. 기본적으로 열은 Acending으로 정렬되지만 :d esc를 포함하면 순서가 반대로 바뀝니다. 주문 기준, "{created|modified|created}:[asc|desc]" 형식(예: order_by=accessed:desc) |
|
|
항목 Per-Page
|
perpage | integer |
표시할 페이지당 결과 수(기본값: 100, 최대: 5000) |
|
|
페이지 번호
|
page | integer |
응답의 페이지 번호 |
|
|
합계 없음
|
nototal | integer |
총 결과는 계산되지 않고 표시되지 않습니다. 응답 시간을 개선합니다. 응답을 더 빠르게 가져오는 데 사용됩니다. |
반환
기능 가져오기
계층 개체에서 하나의 GIS 클라우드 기능 개체를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
기능 ID
|
feature_id | True | integer |
특정 기능을 식별하는 데 사용되는 내부 기능 ID |
|
계층 ID
|
layer_id | True | integer |
특정 계층을 식별하는 데 사용되는 내부 계층 ID |
|
기하 도형 포함
|
geometry | string |
기하 도형이 압축되는 형식입니다. 가능한 값: 'wkt', 'kml' 및 'gml' |
|
|
EPSG 프로젝션
|
epsg | integer |
출력 프로젝션에 대한 EPSG 코드입니다. 지정하지 않으면 기본 맵 프로젝션이 사용됩니다. |
반환
기능 필드에서 미디어 파일 가져오기
계층 개체의 GIS 클라우드 기능 개체 필드에서 미디어 파일을 하나 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
파일 다운로드
|
download | boolean |
검색된 미디어 파일을 직접 다운로드해야 합니다. |
|
|
파일 경로
|
path_to_a_file | True | string |
특정 파일에 대한 상대 경로 |
|
필드 이름
|
field_name | True | string |
지정된 계층의 기능 필드 이름 |
|
기능 ID
|
feature_id | True | integer |
특정 기능을 식별하는 데 사용되는 내부 기능 ID |
|
계층 ID
|
layer_id | True | integer |
특정 계층을 식별하는 데 사용되는 내부 계층 ID |
반환
- response
- file
레이어에서 새 기능 만들기
계층 개체의 모든 GIS 클라우드 기능 개체를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
계층 ID
|
layer_id | True | integer |
특정 계층을 식별하는 데 사용되는 내부 계층 ID |
|
payload
|
payload | dynamic |
새 기능을 만들 데이터는 비어 있는 모든 항목이 null로 만들어집니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
location
|
location | string |
맵 캐시 삭제
API를 통해 변경된 내용을 반영하도록 맵 타일 캐시를 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
맵 ID
|
map_id | True | integer |
특정 맵을 식별하는 데 사용되는 내부 맵 ID |
|
트리거 다시 초기화
|
init_trigger | True | integer |
작업을 수행하기 전에 맵을 다시 초기화해야 합니다. |
|
레이어 목록
|
layers | string |
포함할 계층 ID의 CSV 목록 |
모든 계층 가져오기
모든 GIS 클라우드 계층 개체를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
특성 확장
|
expand | string |
열거형 옵션 중 하나로 응답 확장 |
|
|
표시 유형
|
type | string |
표시 유형별로 필터링: 'public', 'private', 'shared' 또는 'private,shared' |
|
|
주문 기준
|
order_by | string |
대상 GIS Cloud 개체에 있는 열을 참조해야 합니다. 기본적으로 열은 Acending으로 정렬되지만 :d esc를 포함하면 순서가 반대로 바뀝니다. 주문 기준, "{created|modified|created}:[asc|desc]" 형식(예: order_by=accessed:desc) |
|
|
항목 Per-Page
|
perpage | integer |
표시할 페이지당 결과 수(기본값: 100, 최대: 5000) |
|
|
페이지 번호
|
page | integer |
응답의 페이지 번호 |
|
|
합계 없음
|
nototal | True | integer |
총 결과는 계산되지 않고 표시되지 않습니다. 응답 시간을 개선합니다. 응답을 더 빠르게 가져오는 데 사용됩니다. |
반환
- 몸
- Layers
모든 맵 가져오기
모든 GIS 클라우드 맵 개체를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
표시 유형
|
type | string |
표시 유형별로 필터링: 'public', 'private', 'shared' 또는 'private,shared' |
|
|
특성 확장
|
expand | string |
열거형 옵션 중 하나로 응답 확장 |
|
|
주문 기준
|
order_by | string |
대상 GIS Cloud 개체에 있는 열을 참조해야 합니다. 기본적으로 열은 Acending으로 정렬되지만 :d esc를 포함하면 순서가 반대로 바뀝니다. 주문 기준, "{created|modified|created}:[asc|desc]" 형식(예: order_by=accessed:desc) |
|
|
항목 Per-Page
|
perpage | integer |
표시할 페이지당 결과 수(기본값: 100, 최대: 5000) |
|
|
페이지 번호
|
page | integer |
응답의 페이지 번호 |
|
|
합계 없음
|
nototal | integer |
총 결과는 계산되지 않고 표시되지 않습니다. 응답 시간을 개선합니다. 응답을 더 빠르게 가져오는 데 사용됩니다. |
반환
- 몸
- Maps
업데이트 기능
계층 개체에서 하나의 GIS 클라우드 기능 개체를 업데이트합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
기능 ID
|
feature_id | True | integer |
특정 기능을 식별하는 데 사용되는 내부 기능 ID |
|
계층 ID
|
layer_id | True | integer |
특정 계층을 식별하는 데 사용되는 내부 계층 ID |
|
payload
|
payload | dynamic |
업데이트할 새 기능 데이터 |
지도의 모든 레이어 가져오기
단일 GIS 클라우드 맵 개체에 대한 모든 계층 개체를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
맵 ID
|
map_id | True | integer |
특정 맵을 식별하는 데 사용되는 내부 맵 ID |
|
특성 확장
|
expand | string |
열거형 옵션 중 하나로 응답 확장 |
|
|
주문 기준
|
order_by | string |
대상 GIS Cloud 개체에 있는 열을 참조해야 합니다. 기본적으로 열은 Acending으로 정렬되지만 :d esc를 포함하면 순서가 반대로 바뀝니다. 주문 기준, "{created|modified|created}:[asc|desc]" 형식(예: order_by=accessed:desc) |
|
|
항목 Per-Page
|
perpage | integer |
표시할 페이지당 결과 수(기본값: 100, 최대: 5000) |
|
|
페이지 번호
|
page | integer |
응답의 페이지 번호 |
|
|
합계 없음
|
nototal | integer |
총 결과는 계산되지 않고 표시되지 않습니다. 응답 시간을 개선합니다. 응답을 더 빠르게 가져오는 데 사용됩니다. |
반환
- 몸
- Layers
파일 하나 가져오기
GIS Cloud Storage에서 하나의 파일을 다운로드합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
파일 경로
|
path_to_a_file | True | string |
특정 파일에 대한 상대 경로 |
|
파일 이름
|
file_name | True | string |
SaaS 스토리지에 저장되는 특정 미디어 파일의 이름 |
반환
- response
- file
파일 하나 업로드
GIS Cloud Storage에 파일을 업로드합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
파일 데이터
|
filedata | True | file |
업로드할 파일입니다. |
|
대상 맵 ID
|
destination_map | integer |
공유 맵의 지도 ID입니다. 설정되면 파일을 업로드하여 소유자 스토리지를 매핑합니다. |
|
|
파일 경로
|
path_to_a_file | True | string |
특정 파일에 대한 상대 경로 |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
location
|
location | string |
파일 하나 제거
GIS Cloud Storage에서 파일을 제거합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
파일 이름
|
file_name | True | string |
SaaS 스토리지에 저장되는 특정 미디어 파일의 이름 |
|
파일 경로
|
path_to_a_file | True | string |
특정 파일에 대한 상대 경로 |
피쳐 삭제
계층에서 지정된 GIS Cloud 기능 개체를 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
기능 ID
|
feature_id | True | integer |
특정 기능을 식별하는 데 사용되는 내부 기능 ID |
|
계층 ID
|
layer_id | True | integer |
특정 계층을 식별하는 데 사용되는 내부 계층 ID |
하나의 레이어 가져오기
모든 GIS 클라우드 계층 개체를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
계층 ID
|
layer_id | True | integer |
특정 계층을 식별하는 데 사용되는 내부 계층 ID |
|
특성 확장
|
expand | string |
열거형 옵션 중 하나로 응답 확장 |
반환
- 몸
- Layer
하나의 맵 가져오기
하나의 GIS 클라우드 맵 개체를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
맵 ID
|
map_id | True | integer |
특정 맵을 식별하는 데 사용되는 내부 맵 ID |
|
특성 확장
|
expand | string |
열거형 옵션 중 하나로 응답 확장 |
반환
- 몸
- Map
하나의 맵 렌더링
하나의 GIS 클라우드 맵 개체의 이미지를 렌더링합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
맵 ID
|
map_id | True | integer |
특정 맵을 식별하는 데 사용되는 내부 맵 ID |
|
이미지 너비
|
width | number |
이미지 너비(픽셀) |
|
|
이미지 높이
|
height | number |
이미지 높이(픽셀) |
|
|
캐시 무효화
|
invalidate | number |
캐시 무효화 |
|
|
레이어 목록 표시
|
layerlist | number |
이미지에 표시되도록 계층 목록 설정 |
|
|
저장된 이미지
|
justgenerate | number |
저장하지 않고 이미지 생성 |
반환
- response
- file
하나의 맵 삭제
GIS 클라우드 맵 프로젝트 하나 삭제
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
맵 ID
|
map_id | True | integer |
특정 맵을 식별하는 데 사용되는 내부 맵 ID |
하나의 맵 업데이트
하나의 GIS 클라우드 맵 프로젝트 업데이트
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
맵 ID
|
map_id | True | integer |
특정 맵을 식별하는 데 사용되는 내부 맵 ID |
|
이름
|
name | string |
맵 이름 |
한 계층 삭제
하나의 GIS 클라우드 계층 개체를 삭제합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
계층 ID
|
layer_id | True | integer |
특정 계층을 식별하는 데 사용되는 내부 계층 ID |
한 계층 업데이트
하나의 GIS 클라우드 계층 개체를 업데이트합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
계층 ID
|
layer_id | True | integer |
특정 계층을 식별하는 데 사용되는 내부 계층 ID |
|
이름
|
name | string |
레이어 이름 |
현재 사용자 개체 가져오기
현재 GIS 클라우드 사용자 개체를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
API 키
|
API-Key | True | password |
작업 권한을 부여하는 데 사용되는 GIS Cloud API 키 |
|
특성 확장
|
expand | string |
열거형 옵션 중 하나로 응답 확장 |
반환
- 몸
- User
정의
Maps
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
총 레코드
|
total | integer |
검색할 수 있는 총 레코드 수 |
|
현재 페이지
|
page | integer |
반환되는 페이지 수입니다. |
|
개체 매핑
|
data | array of Map |
반환된 지도 개체의 배열 |
Map
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
지도 ID
|
id | integer |
이 맵의 내부 ID |
|
이름
|
name | string |
맵 이름 |
|
Owner 개체
|
owner | array of string |
지도 소유자 개체입니다. 이 값은 expand 매개 변수에 'owner' 키가 포함된 경우에만 나타납니다. |
|
Active
|
active | string |
맵이 활성 상태인가요? |
|
저작권
|
copyright | string |
Copyright 문 문자열 |
|
Proj4
|
proj4 | string |
Proj4 맵 프로젝션 |
|
Proj4 단위
|
units_proj4 | string |
Proj4 정의 단위 |
|
EPSG 코드
|
epsg | string |
EPSG 맵 프로젝션 코드 |
|
지도 단위
|
units | string |
지도 단위(미터, 발 또는 foot_us) |
|
최대 확대/축소
|
maxzoom | string |
최대 확대/축소 |
|
배경색
|
bgcolor | string |
지도 배경색 |
|
수정 날짜
|
modified | integer |
마지막으로 맵을 수정한 시간(UNIX 타임스탬프) |
|
Accessed At
|
accessed | integer |
마지막으로 맵에 액세스한 시간(UNIX 타임스탬프) |
|
만든 위치에서
|
created | integer |
맵이 만들어진 시간(UNIX 타임스탬프) |
|
보기 개수
|
visited | string |
지도 보기 수 |
|
Archived
|
archived | string |
맵이 보관되어 있는지 |
|
리소스 ID
|
resource_id | string |
resource_id |
|
측정 단위
|
measure_unit | string |
measure_unit |
|
Visible
|
visible | string |
보이는 |
|
Resource 개체
|
resource | Resource |
리소스 개체 매핑 |
|
Description
|
description | string |
지도 설명 |
|
mobileacess
|
mobileacess | string |
mobileacess |
|
wmsaccess
|
wmsaccess | string |
wmsaccess |
|
maptype
|
maptype | string |
maptype |
|
assets
|
assets | string |
assets |
|
등급
|
rating | string |
등급 |
|
share
|
share | string |
share |
|
경계 xMin
|
bounds.xmin | float |
xmin |
|
경계 xMax
|
bounds.xmax | float |
xmax |
|
Bounds yMin
|
bounds.ymin | float |
ymin |
|
Bounds yMax
|
bounds.ymax | float |
ymax |
|
경계
|
bound | string |
경계 |
Resource
리소스 개체 매핑
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
리소스 ID
|
id | integer |
이 리소스의 내부 ID |
|
리소스 종류
|
type | string |
열거된 리소스 형식 |
|
리소스 위치
|
location | string |
Null 값이 있는 TBC |
|
리소스 ID
|
target_resource_id | string |
resource_id |
|
리소스 소유자 ID
|
owner_id | string |
이 리소스를 소유하는 사용자의 사용자 ID |
|
리소스 부모 ID
|
parent_id | string |
Null 값이 있는 TBC |
|
리소스 결제 구독 ID
|
payment_subscription_id | string |
Null 값이 있는 TBC |
|
리소스 지불 ID
|
payment_id | string |
Null 값이 있는 TBC |
|
리소스 지불 ID Obs
|
payment_id_obs | string |
Null 값이 있는 TBC |
|
보관된 리소스
|
archived | string |
리소스가 보관되었는지를 나타냅니다. |
|
리소스 사용 안 함
|
disabled | string |
Null 값이 있는 TBC |
|
리소스 액세스 시간
|
access_time | object |
리소스에 마지막으로 액세스한 시간 |
|
수정 날짜
|
modified | integer |
마지막으로 리소스를 수정한 시간(UNIX 타임스탬프) |
|
만든 위치에서
|
created | integer |
리소스가 만들어진 시간(UNIX 타임스탬프) |
레이어
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
총 레코드
|
total | integer |
검색할 수 있는 총 레코드 수 |
|
현재 페이지
|
page | integer |
반환되는 페이지 수입니다. |
|
레이어 개체
|
data | array of Layer |
반환된 레이어 개체의 배열 |
레이어
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
계층 ID
|
id | integer |
계층의 내부 ID |
|
레이어 이름
|
name | string |
사용자 정의 계층 이름 |
|
Owner 개체
|
owner | array of string |
계층 소유자 개체, EXPANDABLE |
|
레이어 원본 유형
|
source.type | string |
제공된 데이터 형식 |
|
계층 원본 URI
|
source.src | string |
데이터가 있는 위치를 정의하는 URI 문자열 |
|
OnScale
|
onscale | string |
표시되는 레이어에 대한 배율 설정 |
|
OffScale
|
offscale | string |
숨겨진 레이어에 대한 크기 조정 설정 |
|
레이어 레이블
|
label | string |
줄 레이블에 사용할 데이터 원본의 특성 이름 |
|
x 최소
|
x_min | string |
레이어 바인딩 X 최소 좌표 |
|
x Max
|
x_max | string |
레이어 바인딩 X 최대 좌표 |
|
y Min
|
y_min | string |
레이어 바인딩된 Y 최소 좌표 |
|
y Max
|
y_max | string |
레이어 바인딩된 Y 최대 좌표 |
|
레이어 텍스트 필드
|
textfield | string |
텍스트 필드로 사용할 데이터 원본의 특성 이름 |
|
수정 날짜
|
modified | integer |
마지막으로 맵을 수정한 시간(UNIX 타임스탬프) |
|
만든 위치에서
|
created | integer |
맵이 만들어진 시간(UNIX 타임스탬프) |
|
레이어 스타일
|
styles | string |
레이어 스타일 지정을 위한 복합 레이어 스타일 개체 |
|
계층 알파
|
alpha | string |
레이어 투명도 |
|
계층 데이터 원본 인코딩
|
encoding | string |
계층 데이터 원본 인코딩 |
|
레이어 텍스트 여백
|
margin | string |
텍스트 필드 여백 |
|
레이어 표시 유형
|
visible | string |
컨트롤 계층 표시 유형, 't' 또는 'f' |
|
레이어 잠금
|
lock | string |
계층 대화형 작업, 't' 또는 'f'를 제어합니다. |
|
래스터 계층
|
raster | string |
계층은 래스터 데이터 원본인 't' 또는 'f'입니다. |
|
내보낼 수 있는 계층
|
exportable | string |
계층을 내보낼 수 있는지 여부 설정, 't' 또는 'f' |
|
병합된 계층
|
merged | string |
레이어가 병합됨 |
|
계층 부모 폴더
|
parent | string |
부모 폴더 계층 ID |
|
계층 도구 설명
|
tooltip | string |
레이어에 나타나는 도구 설명은 마우스 가리키기를 특징으로 합니다. |
|
기하 도형 숨기기
|
hidegeometry | string |
레이어 기하 도형을 숨깁니다. 't' 또는 'f' 레이블만 표시하려는 경우 유용할 수 있습니다. |
|
정보 팝업 사용
|
use_info_window | string |
지도 팝업에 레이어 기능 정보 표시, 't' 또는 'f' |
|
계층 데이터 원본 ID
|
datasource_id | string |
계층 데이터 원본의 데이터 원본 ID |
|
계층 EPSG
|
epsg | string |
데이터 원본 EPSG 코드 |
|
계층이 열렸습니다.
|
opened | string |
폴더 계층 열기/닫기 부울 값의 경우 't' 또는 'f' |
|
계층 리소스 ID
|
resource_id | string |
계층의 리소스 ID |
|
레이어 맵 ID
|
map_id | string |
계층이 속한 지도 ID |
|
계층 지오름 유형
|
type | string |
레이어 기하 도형 유형입니다. 가능한 값은 'point', 'line', 'polygon', 'tile' 및 'wms'입니다. |
|
레이어 순서
|
order | integer |
계층 Z 인덱스 |
|
Layer Options 개체
|
options | object |
이 리소스에 연결된 옵션 목록입니다. 이 값은 expand 매개 변수에 'options' 키가 포함된 경우에만 나타납니다. |
|
양식 이름
|
form.name | string |
연결된 양식의 사용자 정의 이름 |
|
레이어 양식 정의
|
form.definition | string |
레이어에 연결된 양식의 정의 |
|
데이터 원본 리소스 ID
|
datasource.resource_id | string |
데이터 원본의 리소스 ID |
|
데이터 원본 형식
|
datasource.type | string |
계층의 데이터 원본 형식 |
|
데이터 원본 소유자 ID
|
datasource.owner_id | string |
owner_id |
|
permissions
|
datasource.permissions | array of string |
이름 |
|
계층 열 스키마
|
columns | object |
계층 데이터 원본 열 표시, EXPANDABLE |
|
하위 계층
|
sublayers | array of Layer |
이 계층 내에 중첩된 Layer 개체의 배열 |
사용자
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
사용자 ID
|
id | integer |
고유 사용자 ID |
|
사용자 유형
|
type | string |
지정된 유형의 사용자 |
|
사용자 활성
|
active | string |
사용자가 활성 상태인 경우 't' 또는 'f'입니다. |
|
사용자 이름
|
username | string |
사용자 이름 |
|
사용자 이름
|
firstname | string |
사용자 이름 |
|
사용자 성
|
lastname | string |
사용자 성 |
|
사용자 소유자 ID
|
owner_id | string |
이 사용자를 소유한 사용자의 사용자 ID |
|
사용자 전화
|
phone | string |
사용자 전화 번호 |
|
User Mobile
|
mobile | string |
사용자 휴대폰 번호 |
|
만든 위치에서
|
created | integer |
맵이 만들어진 시간(UNIX 타임스탬프) |
|
마지막 로그인
|
lastlog | integer |
맵이 만들어진 시간(UNIX 타임스탬프) |
|
사용자 회사
|
company | string |
사용자 회사 이름 |
|
사용자 웹 URL
|
web | string |
사용자 프로필 웹 사이트 |
|
사용자 Email
|
string |
사용자 이메일 주소 |
|
|
사용자 아바타
|
avatar | string |
사용자 아바타를 검색하는 URL |
|
사용자 언어
|
language | string |
사용자가 선택한 언어 |
|
파일 기능 수
|
file_feature_count | string |
파일 시스템의 지리적 기능 수 |
|
DB 기능 수
|
db_feature_count | string |
데이터베이스의 지리적 기능 수 |
|
사용자 래스터 저장됨
|
storage_raster | string |
래스터 타일에서 사용하는 파일 스토리지 |
|
사용자 스토리지 용량
|
storage_total | string |
사용된 총 파일 스토리지 |
|
사용자 기능 제한
|
feature_count_limit | string |
라이선스가 있는 최대 기능 수 |
|
사용자 래스터 제한
|
storage_raster_limit | string |
라이선스가 있는 최대 스토리지 용량 |
|
구독 시작
|
subscription_begins | string |
사용자 구독이 시작되는 경우 |
|
구독 만료
|
subscription_expires | string |
사용자 구독이 종료되는 경우 |
|
사용자 리소스 ID
|
resource_id | string |
이 사용자의 내부 리소스 ID |
|
마지막으로 수정한 사용자
|
modified | integer |
마지막으로 수정한 날짜 시간(UNIX 형식) |
|
사용자 조직
|
organization_id | string |
이 사용자의 조직 ID |
|
사용자 OIDC
|
oidc | string |
OpenID Connect (오픈아이디 커넥트) |
|
사용자 옵션
|
options | string |
사용자에 연결된 옵션 목록입니다. 이 값은 'expand' 매개 변수에 'options' 키가 포함된 경우에만 나타납니다. |
|
consents
|
consents | array of object |
사용자 동의 계약 개체 |
|
동의 목적
|
consents.purpose | string |
요청된 동의의 목적 |
|
동의 버전
|
consents.version | string |
부여된 동의의 버전 |
|
동의함
|
consents.agreed | string |
동의가 부여되었나요? |
file
기본 데이터 형식 'file'입니다.