OpenPLZ(독립 게시자)(미리 보기)

이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.

서비스	클래스	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)

연락처
이름	OpenPLZ API
URL	https://www.openplzapi.org

커넥터 메타데이터
게시자	LowCodeInvestigator
웹 사이트	https://www.openplzapi.org
개인 정보 보호 정책	https://www.openplzapi.org/legal/privacy-policy
카테고리	데이터
가시성	중요합니다

OpenPLZ API 커넥터

OpenPLZ API 커넥터는 독일, 스위스, 오스트리아 및 리히텐슈타인의 우편 번호, 거리, 관리 부서 및 지역 데이터에 대한 구조적 액세스를 제공합니다. 이를 통해 Microsoft Power Platform 솔루션은 안정적이고 정규화된 위치 데이터 세트를 REST 기반 형식으로 쿼리할 수 있습니다.

이 커넥터는 연방 주, 주, 지구, 지방 자치 단체, 지방 자치 단체, 우편 번호 및 거리와 같은 계층적 정보를 검색할 수 있는 여러 읽기 전용 작업을 노출합니다.

게시자

OpenPLZ API

---

지원되는 기능

OpenPLZ API 커넥터는 다음 기능을 지원합니다.

• 행정 계층 (연방 주, 주, 지구, 지방 자치 단체, 지방 자치 단체, 지방 자치 단체) 검색
• 우편 번호 조회 수행
• 거리 디렉터리 쿼리
• 크로스컨트리 적용 범위 사용(독일, 스위스, 오스트리아, 리히텐슈타인)
• 자동화 및 유효성 검사에 적합한 일관된 JSON 응답 형식 사용

---

필수 조건

이 커넥터를 사용하는 데 필요한 필수 구성 요소는 없습니다.

• API 키 없음
• OAuth 없음
• 인증 없음
• 구독 없음

API는 공개적으로 액세스할 수 있습니다.

---

커넥터를 사용하는 방법

1. Power App 또는 Power Automate 흐름에 OpenPLZ API 커넥터를 추가합니다.
2. 사용 가능한 작업 중 하나를 선택합니다.
3. 필요한 매개 변수를 제공합니다.
4. 워크플로 또는 앱에서 반환된 JSON 데이터를 사용합니다(예: 드롭다운 목록을 채우거나 주소의 유효성을 검사하거나 구조적 위치 데이터를 저장).

---

연결 정보

커넥터는 단일 익명 연결을 사용합니다. 자격 증명이 필요하지 않습니다.

---

알려진 제한 사항

• 읽기 전용 API(GET 작업만 사용할 수 있음)
• 과도한 요청 또는 고주파 요청에 대한 잠재적 속도 제한
• 지오코디네이트 또는 다각형 경계 데이터 없음
• 관리 및 지역 이름은 독일어 명명 규칙을 따릅니다.

---

API 문서

• 일반 설명서
• 독일 설명서
• 스위스 설명서
• 오스트리아 설명서
• 리히텐슈타인은 스위스 설명서에 포함되어 있습니다.

---

국가별 권장 API 호출 주문

다음 섹션에서는 각 국가에 대한 논리적 순서로 계층적 관리 구조를 검색하는 권장되는 API 호출 시퀀스에 대해 설명합니다.

독일(DE)

독일 – 기본 데이터

• GET /de/FederalStates(모든 연방 주 나열(독일)

독일 – 연방 주 수준(federalStateKey 사용)

• GET /de/FederalStates/{federalStateKey}/GovernmentRegions(연방 주(독일)의 정부 지역 나열)
• GET /de/FederalStates/{federalStateKey}/Districts(독일 연방 주의 구역 나열)
• GET /de/FederalStates/{federalStateKey}/Municipalities (List municipalities of a federal state (Germany))
• GET /de/FederalStates/{federalStateKey}/MunicipalAssociations(연방 주(독일)의 시/도 협회 나열)
• GET /de/FederalStates/{federalStateKey}/Localities(연방 주(독일)의 지역 나열)

독일 – 정부 지역 수준(governmentRegionKey 사용)

• GET /de/GovernmentRegions/{governmentRegionKey}/Districts(정부 지역의 구역 나열(독일)
• GET /de/GovernmentRegions/{governmentRegionKey}/Municipalities(정부 지역(독일)의 지방자치단체 나열)
• GET /de/GovernmentRegions/{governmentRegionKey}/MunicipalAssociations(정부 지역의 시/도 협회 나열(독일)
• GET /de/GovernmentRegions/{governmentRegionKey}/Localities(정부 지역의 지역 나열(독일))

독일 – 구역 수준(districtKey 사용)

• GET /de/Districts/{districtKey}/Municipalities(구역의 지방자치단체 나열(독일)
• GET /de/Districts/{districtKey}/MunicipalAssociations(구역의 시/도 협회 나열(독일))
• GET /de/Districts/{districtKey}/Localities (List localities of a District (Germany))

독일 – 엔드포인트 검색

• GET /de/Localities(지역 및 우편 번호 검색(독일))
• GET /de/Streets(검색 거리(독일))
• GET /de/FullTextSearch(거리, 우편 번호 및 지역(독일)에 대한 전체 텍스트 검색)

---

리히텐슈타인(LI)

Liechtenstein – 기본 데이터

• GET /li/Communes(모든 공동체 나열(리히텐슈타인))

Liechtenstein – 엔드포인트 검색

• GET /li/Localities(지역 및 우편 번호 검색(Liechtenstein))
• GET /li/Streets(검색 거리(리히텐슈타인))
• GET /li/FullTextSearch(거리에서 전체 텍스트 검색(리히텐슈타인))

---

스위스(CH)

스위스 – 기본 데이터

• GET /ch/Cantons(모든 주 나열(스위스))

스위스 – Canton Level(cantonKey 사용)

• GET /ch/Cantons/{cantonKey}/Districts(주(스위스) 구역 나열)
• GET /ch/Cantons/{cantonKey}/Communes(주(스위스)의 공동체 나열)
• GET /ch/Cantons/{cantonKey}/Localities(주(스위스)의 지역 나열)

스위스 – 구역 수준(districtKey 사용)

• GET /ch/Districts/{districtKey}/Communes(구역의 공동체 나열(스위스))
• GET /ch/Districts/{districtKey}/Localities (List localities of a District (Switzerland))

스위스 – 엔드포인트 검색

• GET /ch/Localities(지역 및 우편 번호 검색(스위스))
• GET /ch/Streets(검색 거리(스위스))
• GET /ch/FullTextSearch(거리에서 전체 텍스트 검색(스위스))

---

오스트리아(AT)

오스트리아 – 기본 데이터

• GET /at/FederalProvinces(모든 연방 주 나열(오스트리아)

오스트리아 – 연방 지방 수준(federalProvinceKey 사용)

• GET /at/FederalProvinces/{federalProvinceKey}/Districts(연방 지방의 구역 나열(오스트리아)
• GET /at/FederalProvinces/{federalProvinceKey}/Municipalities(연방 지방의 지방자치단체 나열(오스트리아)
• GET /at/FederalProvinces/{federalProvinceKey}/Localities (List localities of a federal province (Austria))

오스트리아 – 구역 수준(districtKey 사용)

• GET /at/Districts/{districtKey}/Municipalities(구역의 지방자치단체 나열(오스트리아)
• GET /at/Districts/{districtKey}/Localities (List localities of a District (Austria))

오스트리아 – 엔드포인트 검색

• GET /at/Localities(지역 및 우편 번호 검색(오스트리아))
• GET /at/Streets(검색 거리(오스트리아))
• GET /at/FullTextSearch(거리에 대한 전체 텍스트 검색(오스트리아))

제한 한도

Name	호출	갱신 기간
연결당 API 호출	100	60초

동작

거리, 우편 번호 및 지방에 대한 전체 텍스트 검색(독일)	독일의 거리 이름, 우편 번호 및 지역 이름을 전체 텍스트로 검색합니다.
거리에 대한 전체 텍스트 검색(리히텐슈타인)	리히텐슈타인의 거리 이름, 우편 번호 및 지역 이름에서 전체 텍스트 검색
거리에 대한 전체 텍스트 검색(스위스)	스위스의 거리 이름, 우편 번호 및 지역 이름을 전체 텍스트로 검색합니다.
거리에 대한 전체 텍스트 검색(오스트리아)	오스트리아 데이터 디렉터리의 거리 이름, 우편 번호 및 지역 이름에서 전체 텍스트 검색
검색 거리(독일)	도로 이름 및/또는 우편 번호 및/또는 지역 이름으로 독일의 거리를 검색합니다. 모든 매개 변수는 정규식을 지원합니다.
검색 거리(리히텐슈타인)	거리 이름 및/또는 우편 번호 및/또는 지역별로 리히텐슈타인의 거리를 검색합니다. 정규식이 지원됩니다.
검색 거리(스위스)	거리 이름 및/또는 우편 번호 및/또는 지역 이름으로 스위스의 거리를 검색합니다. 모든 매개 변수는 정규식을 지원합니다.
검색 거리(오스트리아)	오스트리아의 거리를 거리 이름 및/또는 우편 번호 및/또는 지역 이름으로 검색합니다. 모든 매개 변수는 정규식을 지원합니다.
구역의 공동체 나열(스위스)	스위스 지역 내의 모든 공동체를 반환합니다.
구역의 시/도 협회 나열(독일)	독일 지역 내의 모든 시립 협회를 반환합니다.
구역의 지방자치단체 나열(독일)	독일 지역 내의 모든 지방 자치 단체를 반환합니다.
구역의 지방자치단체 나열(오스트리아)	오스트리아 지역 내의 모든 지방자치단체를 반환합니다.
구역의 지역 나열(독일)	독일 지역 내의 모든 지역을 반환합니다.
구역의 지역 나열(스위스)	스위스 지역 내의 모든 지역을 반환합니다.
구역의 지역 나열(오스트리아)	오스트리아 지역 내의 모든 지역을 반환합니다.
모든 공동체 나열(리히텐슈타인)	리히텐슈타인 공국 11개 공동체를 모두 반환합니다.
모든 연방 주 나열(독일)	모든 독일 연방 주를 반환합니다.
모든 연방 지방 나열(오스트리아)	오스트리아의 9개 연방 지방을 모두 반환합니다.
모든 주 나열(스위스)	스위스의 26개 주 모두를 반환합니다.
연방 국가의 정부 지역 나열(독일)	독일 연방 주 내의 모든 정부 지역을 반환합니다.
연방 주(독일)의 구역 나열	독일 연방 주 내의 모든 구역을 반환합니다.
연방 주(독일)의 시립 협회 나열	독일 연방 주 내의 모든 시립 협회를 반환합니다.
연방 주(독일)의 지방자치단체 나열	독일 연방 주 내의 모든 지방 자치 단체를 반환합니다.
연방 주(독일)의 지역 나열	독일 연방 주 내의 모든 지방을 반환합니다.
연방 지방의 구역 나열(오스트리아)	오스트리아 연방 주 내의 모든 구역을 반환합니다.
연방 지방의 지방자치단체 나열(오스트리아)	오스트리아 연방 지방 내의 모든 지방 자치 단체를 반환합니다.
연방 지방의 지역 나열(오스트리아)	오스트리아 연방 지방 내의 모든 지방을 반환합니다.
정부 지역의 구역 나열(독일)	독일 정부 지역 내의 모든 구역을 반환합니다.
정부 지역의 시/도 협회 나열(독일)	독일 정부 지역 내의 모든 시립 협회를 반환합니다.
정부 지역의 지방자치단체 나열(독일)	독일 정부 지역 내의 모든 지방 자치 단체를 반환합니다.
정부 지역의 지역 나열(독일)	독일 정부 지역 내의 모든 지방을 반환합니다.
주(스위스) 구역 나열	스위스 주 내의 모든 구역을 반환합니다.
주(스위스)의 공동체 나열	스위스 주 내의 모든 공동체를 반환합니다.
주(스위스)의 지역 나열	스위스 주 내의 모든 지방을 반환합니다.
지역 및 우편 번호 검색(독일)	우편 번호 및/또는 지역 이름으로 독일의 지방을 검색합니다. 두 매개 변수 모두 정규식을 지원합니다.
지역 및 우편 번호 검색(리히텐슈타인)	우편 번호 및/또는 지역 이름으로 리히텐슈타인의 지방을 검색합니다. 정규식이 지원됩니다.
지역 및 우편 번호 검색(스위스)	우편 번호 및/또는 지역 이름으로 스위스의 지방을 검색합니다. 두 매개 변수 모두 정규식을 지원합니다.
지역 및 우편 번호 검색(오스트리아)	우편 번호 및/또는 지역 이름으로 오스트리아의 지방을 검색합니다. 두 매개 변수 모두 정규식을 지원합니다.

거리, 우편 번호 및 지방에 대한 전체 텍스트 검색(독일)

거리에 대한 전체 텍스트 검색(리히텐슈타인)

거리에 대한 전체 텍스트 검색(스위스)

거리에 대한 전체 텍스트 검색(오스트리아)

검색 거리(독일)

검색 거리(리히텐슈타인)

검색 거리(스위스)

검색 거리(오스트리아)

구역의 공동체 나열(스위스)

구역의 시/도 협회 나열(독일)

구역의 지방자치단체 나열(독일)

구역의 지방자치단체 나열(오스트리아)

구역의 지역 나열(독일)

구역의 지역 나열(스위스)

구역의 지역 나열(오스트리아)

모든 공동체 나열(리히텐슈타인)

모든 연방 주 나열(독일)

모든 연방 지방 나열(오스트리아)

모든 주 나열(스위스)

연방 국가의 정부 지역 나열(독일)

연방 주(독일)의 구역 나열

연방 주(독일)의 시립 협회 나열

연방 주(독일)의 지방자치단체 나열

연방 주(독일)의 지역 나열

연방 지방의 구역 나열(오스트리아)

연방 지방의 지방자치단체 나열(오스트리아)

연방 지방의 지역 나열(오스트리아)

정부 지역의 구역 나열(독일)

정부 지역의 시/도 협회 나열(독일)

정부 지역의 지방자치단체 나열(독일)

정부 지역의 지역 나열(독일)

주(스위스) 구역 나열

주(스위스)의 공동체 나열

주(스위스)의 지역 나열

지역 및 우편 번호 검색(독일)

지역 및 우편 번호 검색(리히텐슈타인)

지역 및 우편 번호 검색(스위스)

지역 및 우편 번호 검색(오스트리아)

정의

FederalState

GovernmentRegion

GovernmentRegionSummary

FederalStateSummary

지구

DistrictSummary

MunicipalAssociation

MunicipalAssociationSummary

자치 도시

MunicipalitySummary

지역

거리

CommuneLI

LocalityLI

StreetLI

캔톤치 주

CantonCHSummary

DistrictCH

DistrictCHSummary

CommuneCH

CommuneCHSummary

LocalityCH

StreetCH

FederalProvinceAT

FederalProvinceATSummary

DistrictAT

DistrictATSummary

지방 자치 단체AT

MunicipalityATSummary

LocalityAT

StreetAT