OpenPLZ（獨立出版商）（預覽）

OpenPLZ API – 德國、列支敦士登、瑞士及奧地利的公共街道與郵遞區號 API。

文檔： https://www.openplzapi.org/de/germany/

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部（DoD）
Power Apps	進階	除下列區域外的所有 Power Apps 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

連絡人
名稱	OpenPLZ API
URL	https://www.openplzapi.org

連接器中繼資料
Publisher	低代碼調查員
網站	https://www.openplzapi.org
隱私策略	https://www.openplzapi.org/legal/privacy-policy
類別	資料
可見度	這很重要

OpenPLZ API 連接器

OpenPLZ API 連接器提供德國、瑞士、奧地利及列支敦士登的郵遞區號、街道、行政區劃及地區資料的結構化存取。它使 Microsoft Power Platform 解決方案能以基於 REST 格式查詢可靠且正規化的位置資料集。

此連接器可開放多種唯讀操作，允許檢索聯邦州、州、區、市、地方、郵遞區號及街道等階層資訊。

Publisher

OpenPLZ API

支援的功能

OpenPLZ API 連接器支援以下功能：

取得行政階層（聯邦州、州、區、市鎮、市鎮、市鎮協會、地方）
執行郵遞區號查詢
查詢街道目錄
跨國覆蓋工作（德國、瑞士、奧地利、列支敦士登）
使用適合自動化與驗證的一致 JSON 回應格式

先決條件

使用此連接器無需額外條件：

沒有 API 金鑰
沒有 OAuth
無驗證
沒有訂閱

API 對外開放。

連接器的使用方法

將 OpenPLZ API 連接器加入你的 Power App 或 Power Automate 流程中。
從可用行動中選擇一個。
提供所需的參數。
在你的工作流程或應用程式中使用回傳的 JSON 資料（例如，填充下拉選單、驗證地址或儲存結構化位置資料）。

轉乘資訊

該連接器使用單一匿名連接。不需要任何證件。

已知限制

唯讀 API（僅提供 GET 操作）
對於過度或高頻請求的潛在速率限制
沒有地理座標或多邊形邊界資料
行政區名與地方名稱遵循德語命名慣例

API 文件

一般文件
德國文件
瑞士文件
奧地利文件
列支敦士登被列入瑞士文件中

各國推薦的 API 呼叫順序

以下章節描述建議的 API 呼叫序列，以依邏輯順序為各國檢索階層行政結構。

德國 (德意志)

德國 – 基礎資料

GET /de/FederalStates（列出所有聯邦州（德國））

德國-聯邦州級（使用 federalStateKey）

GET /de/FederalStates/{federalStateKey}/GovernmentRegions（列出聯邦州政府區域（德國））
GET /de/FederalStates/{federalStateKey}/Districts（聯邦州的選區列表（德國））
GET /de/FederalStates/{federalStateKey}/Municipalities（聯邦州市鎮列表（德國））
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（列出區的地區（德國））

德國 – 搜尋端點

GET /de/Localities（搜尋地區及郵遞區號（德國））
GET /de/街道（搜尋街道（德國））
GET /de/FullTextSearch（全文搜尋街道、郵遞區號及地區（德國））

列支敦士登（LI）

列支敦士登 – 基礎資料

GET /li/Communes（列出所有市鎮（列支敦士登））

列支敦士登 – 搜尋端點

GET /li/Localities（搜尋地區及郵遞區號（列支敦士登））
GET /li/街道（搜尋街道（列支敦士登））
GET /li/FullTextSearch（列支敦士登街道全文搜尋）

瑞士（CH）

瑞士 – 基礎資料

GET /ch/州（列出所有州（瑞士））

瑞士 – 州級（使用 cantonKey）

GET /ch/Cantons/{cantonKey}/Districts（瑞士州區列表）
GET /ch/州/{cantonKey}/市鎮（瑞士州的市鎮列表）
GET /ch/州/{cantonKey}/Localities（瑞士州的地區列表）

瑞士 – 區域層級（使用 districtKey）

GET /ch/Districts/{districtKey}/Communes（瑞士區的市鎮列表）
GET /ch/Districts/{districtKey}/Localities（瑞士區的地區列表）

瑞士 – 搜尋端點

GET /ch/Localities（搜尋瑞士地區及郵遞區號）
GET /ch/街道（搜尋街道（瑞士））
取得 /ch/FullTextSearch（瑞士街道全文搜尋）

奧地利（AT）

奧地利 – 基礎資料

GET /at/FederalProvinces（列出所有聯邦省份（奧地利））

奧地利-聯邦省級（使用 federalProvinceKey）

GET /at/FederalProvinces/{federalProvinceKey}/Districts（聯邦省份區列表（奧地利））
GET /at/FederalProvinces/{federalProvinceKey}/Municipalities（列出聯邦省份的市鎮（奧地利））
GET /at/FederalProvinces/{federalProvinceKey}/Localities（列出聯邦省份的地區（奧地利））

奧地利 – 區級（使用 districtKey）

GET /at/Districts/{districtKey}/Municipalities（奧地利區內市鎮列表）
GET /at/Districts/{districtKey}/Localities（列出區的地區（奧地利））

奧地利 – 搜尋端點

GET /at/Localities（搜尋地區及郵遞區號（奧地利））
GET /at/街道（搜尋街道（奧地利））
GET /at/FullTextSearch（奧地利街道全文搜尋）

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	100	60 秒

動作

列出所有市鎮（列支敦士登）	列支敦士登公國所有11個市鎮。
列出所有聯邦州（德國）	返回所有德國聯邦州。
列出所有聯邦省份（奧地利）	恢復奧地利所有9個聯邦省份。
列支敦士登街道全文搜尋	全文搜尋列支敦士登的街道名稱、郵遞區號及地區名稱。
奧地利區市鎮列表	匯出奧地利區內所有市鎮。
奧地利區的列表地區	返回奧地利區域內的所有地點。
奧地利聯邦省份市鎮列表	匯報奧地利聯邦省內所有市鎮。
奧地利聯邦省份的列表地方	申報奧地利聯邦省內所有地方。
奧地利聯邦省份選區列表	返回奧地利聯邦省內的所有選區。
奧地利街道全文搜尋	全文搜尋奧地利資料目錄的街道名稱、郵遞區號及地區名稱。
德國區市政協會列表	返回德國區內所有市政協會。
德國區市鎮列表	匯報德國區內所有市鎮。
德國區的地區列表	返回德國區內的所有地區。
德國政府區區列表	返回德國政府區域內的所有選區。
德國政府區域的地區列表	返回德國政府區域內的所有地方。
德國政府區市政協會列表	報告德國政府區域內所有市鎮協會。
德國政府區市鎮列表	返回德國政府區域內的所有市鎮。
德國聯邦州市鎮協會列表	申報德國聯邦州內所有市政協會。
德國聯邦州的列表地方	申報德國聯邦州內所有地方。
德國聯邦州的市鎮列表	申報德國聯邦州內所有市鎮。
搜尋地區與郵遞區號（列支敦士登）	依郵遞區號及/或地區名稱搜尋列支敦士登的地區。支援正則表達式。
搜尋地區與郵遞區號（德國）	依郵遞區號和/或地區名稱搜尋德國各地。這兩個參數都支援正規表達式。
搜尋地點與郵遞區號（瑞士）	依郵遞區號和/或地區名稱搜尋瑞士地區。這兩個參數都支援正規表達式。
搜尋街道（列支敦士登）	依街道名稱及/或郵遞區號及/或地區搜尋列支敦士登的街道。支援正則表達式。
搜尋街道（奧地利）	可依街道名稱及/或郵遞區號及/或地區名稱搜尋奧地利的街道。所有參數都支援正規表達式。
搜尋街道（德國）	可依街道名稱及/或郵遞區號及/或地區名稱搜尋德國街道。所有參數都支援正規表達式。
搜尋街道（瑞士）	可依街道名稱及/或郵遞區號及/或地區名稱搜尋瑞士街道。所有參數都支援正規表達式。
查詢地區與郵遞區號（奧地利）	依郵遞區號和/或地區名稱搜尋奧地利的地區。這兩個參數都支援正規表達式。
瑞士區市鎮列表	申報瑞士區域內所有市鎮。
瑞士區的地區列表	回報瑞士區內的所有地點。
瑞士州的區列表	匯出瑞士州內所有選區。
瑞士州的地區列表	返回瑞士州內所有地區。
瑞士州的市鎮列表	返回瑞士州內所有市鎮。
瑞士所有州列表	返回瑞士所有26個州。
瑞士街道全文搜尋	全文搜尋瑞士的街道名稱、郵遞區號及地區名稱。
聯邦州（德國）政府區域列表	返回德國聯邦州內所有政府區域。
聯邦州（德國）選區列表	申報德國聯邦州內所有選區。
街道、郵遞區號及地區的全文搜尋（德國）	全文搜尋，涵蓋德國的街道名稱、郵遞區號及地區名稱。

列出所有市鎮（列支敦士登）

作業識別碼：: GetCommunesLI

列支敦士登公國所有11個市鎮。

傳回

response: array of CommuneLI

列出所有聯邦州（德國）

作業識別碼：: GetFederalStatesDE

返回所有德國聯邦州。

傳回

response: array of FederalState

列出所有聯邦省份（奧地利）

作業識別碼：: GetFederalProvincesAT

恢復奧地利所有9個聯邦省份。

傳回

response: array of FederalProvinceAT

列支敦士登街道全文搜尋

作業識別碼：: FullTextSearchLI

全文搜尋列支敦士登的街道名稱、郵遞區號及地區名稱。

參數

名稱	機碼	必要	類型	Description
搜尋字詞	searchTerm	True	string	搜尋詞，例如「9490 Alte Landstrasse」。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of StreetLI

奧地利區市鎮列表

作業識別碼：: GetMunicipalitiesByDistrictAT

匯出奧地利區內所有市鎮。

參數

名稱	機碼	必要	類型	Description
區域重點	districtKey	True	string	學區識別碼或學區代碼（三位數）。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of MunicipalityAT

奧地利區的列表地區

作業識別碼：: GetLocalitiesByDistrictAT

返回奧地利區域內的所有地點。

參數

名稱	機碼	必要	類型	Description
區域重點	districtKey	True	string	學區識別碼或學區代碼（三位數）。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of LocalityAT

奧地利聯邦省份市鎮列表

作業識別碼：: GetMunicipalitiesByFederalProvinceAT

匯報奧地利聯邦省內所有市鎮。

參數

名稱	機碼	必要	類型	Description
聯邦省份關鍵	federalProvinceKey	True	string	聯邦省份識別碼（1 位數）。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of MunicipalityAT

奧地利聯邦省份的列表地方

作業識別碼：: GetLocalitiesByFederalProvinceAT

申報奧地利聯邦省內所有地方。

參數

名稱	機碼	必要	類型	Description
聯邦省份關鍵	federalProvinceKey	True	string	聯邦省份識別碼（1 位數）。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of LocalityAT

奧地利聯邦省份選區列表

作業識別碼：: GetDistrictsByFederalProvinceAT

返回奧地利聯邦省內的所有選區。

參數

名稱	機碼	必要	類型	Description
聯邦省份關鍵	federalProvinceKey	True	string	聯邦省份識別碼（1 位數）。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of DistrictAT

奧地利街道全文搜尋

作業識別碼：: FullTextSearchAT

全文搜尋奧地利資料目錄的街道名稱、郵遞區號及地區名稱。

參數

名稱	機碼	必要	類型	Description
搜尋字詞	searchTerm	True	string	搜尋詞，例如「Wien Alfred Dallinger Platz」。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of StreetAT

德國區市政協會列表

作業識別碼：: GetMunicipalAssociationsByDistrictDE

返回德國區內所有市政協會。

參數

名稱	機碼	必要	類型	Description
區域重點	districtKey	True	string	區域鑰匙（5位數）。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of MunicipalAssociation

德國區市鎮列表

作業識別碼：: GetMunicipalitiesByDistrictDE

匯報德國區內所有市鎮。

參數

名稱	機碼	必要	類型	Description
區域重點	districtKey	True	string	區域鑰匙（5位數）。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of Municipality

德國區的地區列表

作業識別碼：: GetLocalitiesByDistrictDE

返回德國區內的所有地區。

參數

名稱	機碼	必要	類型	Description
區域重點	districtKey	True	string	區域鑰匙（5位數）。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of Locality

德國政府區區列表

作業識別碼：: GetDistrictsByGovernmentRegionDE

返回德國政府區域內的所有選區。

參數

名稱	機碼	必要	類型	Description
政府區域說明	governmentRegionKey	True	string	政府區域的區域鑰匙（三位數）。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of District

德國政府區域的地區列表

作業識別碼：: GetLocalitiesByGovernmentRegionDE

返回德國政府區域內的所有地方。

參數

名稱	機碼	必要	類型	Description
政府區域說明	governmentRegionKey	True	string	政府區域的區域鑰匙（三位數）。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of Locality

德國政府區市政協會列表

作業識別碼：: GetMunicipalAssociationsByGovernmentRegionDE

報告德國政府區域內所有市鎮協會。

參數

名稱	機碼	必要	類型	Description
政府區域說明	governmentRegionKey	True	string	政府區域的區域鑰匙（三位數）。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of MunicipalAssociation

德國政府區市鎮列表

作業識別碼：: GetMunicipalitiesByGovernmentRegionDE

返回德國政府區域內的所有市鎮。

參數

名稱	機碼	必要	類型	Description
政府區域說明	governmentRegionKey	True	string	政府區域的區域鑰匙（三位數）。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of Municipality

德國聯邦州市鎮協會列表

作業識別碼：: GetMunicipalAssociationsByFederalStateDE

申報德國聯邦州內所有市政協會。

參數

名稱	機碼	必要	類型	Description
聯邦州鑰匙	federalStateKey	True	string	聯邦州的區域鍵（兩位數）。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of MunicipalAssociation

德國聯邦州的列表地方

作業識別碼：: GetLocalitiesByFederalStateDE

申報德國聯邦州內所有地方。

參數

名稱	機碼	必要	類型	Description
聯邦州鑰匙	federalStateKey	True	string	聯邦州的區域鍵（兩位數）。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of Locality

德國聯邦州的市鎮列表

作業識別碼：: GetMunicipalitiesByFederalStateDE

申報德國聯邦州內所有市鎮。

參數

名稱	機碼	必要	類型	Description
聯邦州鑰匙	federalStateKey	True	string	聯邦州的區域鍵（兩位數）。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of Municipality

搜尋地區與郵遞區號（列支敦士登）

作業識別碼：: SearchLocalitiesLI

依郵遞區號及/或地區名稱搜尋列支敦士登的地區。支援正則表達式。

參數

名稱	機碼	類型	Description
郵遞區號	postalCode	string	郵遞區號或正則表達式，例如 '^94'。
地點名稱	name	string	地點名稱或正則表達式。
頁面索引	page	integer	頁面索引（預設：1）。
頁面大小	pageSize	integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of LocalityLI

搜尋地區與郵遞區號（德國）

作業識別碼：: SearchLocalitiesDE

依郵遞區號和/或地區名稱搜尋德國各地。這兩個參數都支援正規表達式。

參數

名稱	機碼	類型	Description
郵遞區號	postalCode	string	郵遞區號或正則表達式（例如 '^13'）。
地點名稱	name	string	地點名稱或正則表達式。
頁面索引	page	integer	頁面索引（預設：1）。
頁面大小	pageSize	integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of Locality

搜尋地點與郵遞區號（瑞士）

作業識別碼：: SearchLocalitiesCH

依郵遞區號和/或地區名稱搜尋瑞士地區。這兩個參數都支援正規表達式。

參數

名稱	機碼	類型	Description
郵遞區號	postalCode	string	郵遞區號或正則表達式（例如 '^80'）。
地點名稱	name	string	地點名稱或正則表達式。
頁面索引	page	integer	頁面索引（預設：1）。
頁面大小	pageSize	integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of LocalityCH

搜尋街道（列支敦士登）

作業識別碼：: SearchStreetsLI

依街道名稱及/或郵遞區號及/或地區搜尋列支敦士登的街道。支援正則表達式。

參數

名稱	機碼	類型	Description
街道名稱	name	string	街道名稱或正則表達式。
郵遞區號	postalCode	string	郵遞區號或正則表達式。
地點名稱	locality	string	地點名稱或正則表達式。
頁面索引	page	integer	頁面索引（預設：1）。
頁面大小	pageSize	integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of StreetLI

搜尋街道（奧地利）

作業識別碼：: SearchStreetsAT

可依街道名稱及/或郵遞區號及/或地區名稱搜尋奧地利的街道。所有參數都支援正規表達式。

參數

名稱	機碼	類型	Description
街道名稱	name	string	街道名稱或正則表達式。
郵遞區號	postalCode	string	郵遞區號或正則表達式。
地點名稱	locality	string	地點名稱或正則表達式。
頁面索引	page	integer	頁面索引（預設：1）。
頁面大小	pageSize	integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of StreetAT

搜尋街道（德國）

作業識別碼：: SearchStreetsDE

可依街道名稱及/或郵遞區號及/或地區名稱搜尋德國街道。所有參數都支援正規表達式。

參數

名稱	機碼	類型	Description
街道名稱	name	string	街道名稱或正則表達式。
郵遞區號	postalCode	string	郵遞區號或正則表達式。
地點名稱	locality	string	地點名稱或正則表達式。
頁面索引	page	integer	頁面索引（預設：1）。
頁面大小	pageSize	integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of Street

搜尋街道（瑞士）

作業識別碼：: SearchStreetsCH

可依街道名稱及/或郵遞區號及/或地區名稱搜尋瑞士街道。所有參數都支援正規表達式。

參數

名稱	機碼	類型	Description
街道名稱	name	string	街道名稱或正則表達式。
郵遞區號	postalCode	string	郵遞區號或正則表達式。
地點名稱	locality	string	地點名稱或正則表達式。
頁面索引	page	integer	頁面索引（預設：1）。
頁面大小	pageSize	integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of StreetCH

查詢地區與郵遞區號（奧地利）

作業識別碼：: SearchLocalitiesAT

依郵遞區號和/或地區名稱搜尋奧地利的地區。這兩個參數都支援正規表達式。

參數

名稱	機碼	類型	Description
郵遞區號	postalCode	string	郵遞區號或正則表達式（例如 '^10'）。
地點名稱	name	string	地點名稱或正則表達式。
頁面索引	page	integer	頁面索引（預設：1）。
頁面大小	pageSize	integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of LocalityAT

瑞士區市鎮列表

作業識別碼：: GetCommunesByDistrictCH

申報瑞士區域內所有市鎮。

參數

名稱	機碼	必要	類型	Description
區域重點	districtKey	True	string	學區的BFS號碼（最多4位數）。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of CommuneCH

瑞士區的地區列表

作業識別碼：: GetLocalitiesByDistrictCH

回報瑞士區內的所有地點。

參數

名稱	機碼	必要	類型	Description
區域重點	districtKey	True	string	學區的BFS號碼（最多4位數）。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of LocalityCH

瑞士州的區列表

作業識別碼：: GetDistrictsByCantonCH

匯出瑞士州內所有選區。

參數

名稱	機碼	必要	類型	Description
廣東鑰匙	cantonKey	True	string	該州的BFS號碼（最多2位數），例如弗里堡的「10」。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of DistrictCH

瑞士州的地區列表

作業識別碼：: GetLocalitiesByCantonCH

返回瑞士州內所有地區。

參數

名稱	機碼	必要	類型	Description
廣東鑰匙	cantonKey	True	string	該州的BFS號碼（最多2位數）。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of LocalityCH

瑞士州的市鎮列表

作業識別碼：: GetCommunesByCantonCH

返回瑞士州內所有市鎮。

參數

名稱	機碼	必要	類型	Description
廣東鑰匙	cantonKey	True	string	該州的BFS號碼（最多2位數）。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of CommuneCH

瑞士所有州列表

作業識別碼：: GetCantonsCH

返回瑞士所有26個州。

傳回

response: array of CantonCH

瑞士街道全文搜尋

作業識別碼：: FullTextSearchCH

全文搜尋瑞士的街道名稱、郵遞區號及地區名稱。

參數

名稱	機碼	必要	類型	Description
搜尋字詞	searchTerm	True	string	搜尋詞，例如「Zürich Bederstrasse」。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of StreetCH

聯邦州（德國）政府區域列表

作業識別碼：: GetGovernmentRegionsByFederalStateDE

返回德國聯邦州內所有政府區域。

參數

名稱	機碼	必要	類型	Description
聯邦州鑰匙	federalStateKey	True	string	聯邦州的區域鍵（兩位數），例如巴伐利亞州的「09」。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of GovernmentRegion

聯邦州（德國）選區列表

作業識別碼：: GetDistrictsByFederalStateDE

申報德國聯邦州內所有選區。

參數

名稱	機碼	必要	類型	Description
聯邦州鑰匙	federalStateKey	True	string	聯邦州的區域鍵（兩位數）。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of District

街道、郵遞區號及地區的全文搜尋（德國）

作業識別碼：: FullTextSearchDE

全文搜尋，涵蓋德國的街道名稱、郵遞區號及地區名稱。

參數

名稱	機碼	必要	類型	Description
搜尋字詞	searchTerm	True	string	搜尋詞，例如「柏林巴黎廣場」。
頁面索引	page		integer	頁面索引（預設：1）。
頁面大小	pageSize		integer	每頁項目數量（預設：50，最多：50）。

傳回

response: array of Street

定義

聯邦州

德國聯邦州

名稱	路徑	類型	Description
Key	key	string	區域鍵（兩位數）。
名稱	name	string	聯邦州的名稱。
政府所在地	seatOfGovernment	string	聯邦州政府所在地。

政府區域

名稱	路徑	類型	Description
Key	key	string	區域鑰匙（三位數）。
名稱	name	string	政府區域名稱。
行政總部	administrativeHeadquarters	string	政府區域的行政總部。
聯邦州	federalState	FederalStateSummary	聯邦州的摘要

政府區域摘要

名稱	路徑	類型	Description
Key	key	string	區域鑰匙（三位數）。
名稱	name	string	政府區域名稱。

聯邦州摘要

聯邦州的摘要

名稱	路徑	類型	Description
Key	key	string	區域鍵（兩位數）。
名稱	name	string	聯邦州的名稱。

區

名稱	路徑	類型	Description
Key	key	string	區域鑰匙（5位數）。
名稱	name	string	該區名稱。
型別	type	string	區的類型（例如「Landkreis」、「Kreisfreie Stadt」）。
行政總部	administrativeHeadquarters	string	該區的行政總部。
政府區域	governmentRegion	GovernmentRegionSummary	政府區域摘要
聯邦州	federalState	FederalStateSummary	聯邦州的摘要

區域摘要

選區概要

名稱	路徑	類型	Description
Key	key	string	區域鑰匙（5位數）。
名稱	name	string	該區名稱。

市政協會

名稱	路徑	類型	Description
Key	key	string	市政協會的鑰匙（9位數）。
名稱	name	string	市政協會名稱。
型別	type	string	市政協會的法典（例如「Amt」、「Verbandsgemeinde」）。
行政總部	administrativeHeadquarters	string	市政協會的行政總部。
區	district	DistrictSummary	選區概要
政府區域	governmentRegion	GovernmentRegionSummary	政府區域摘要
聯邦州	federalState	FederalStateSummary	聯邦州的摘要

市政協會摘要

名稱	路徑	類型
Key	key	string
名稱	name	string
型別	type	string

自治區

名稱	路徑	類型	Description
Key	key	string	該市的區域鑰匙（8 位數）。
名稱	name	string	市鎮名稱。
型別	type	string	市政代碼（例如城市、集鎮、無區城市等）。
postalCode	postalCode	string	市政管理的郵遞區號。
多郵遞區號	multiplePostalCodes	boolean	市政府是否涵蓋多個郵遞區號？
關聯	association	MunicipalAssociationSummary	市政協會摘要
區	district	DistrictSummary	選區概要
政府區域	governmentRegion	GovernmentRegionSummary	政府區域摘要
聯邦州	federalState	FederalStateSummary	聯邦州的摘要

市政區摘要

市鎮概述

名稱	路徑	類型
Key	key	string
名稱	name	string
型別	type	string

地區

名稱	路徑	類型	Description
名稱	name	string	該地名稱。
postalCode	postalCode	string	當地郵遞區號。
自治區	municipality	MunicipalitySummary	市鎮概述
區	district	DistrictSummary	選區概要
政府區域	governmentRegion	GovernmentRegionSummary	政府區域摘要
聯邦州	federalState	FederalStateSummary	聯邦州的摘要

街道

名稱	路徑	類型	Description
名稱	name	string	街道名稱。
postalCode	postalCode	string	郵遞區號。
地區	locality	string	地區名稱。
borough	borough	string	市自治市（如有）。
郊區	suburb	string	郊區或四分之一區（如果有的話）。
自治區	municipality	MunicipalitySummary	市鎮概述
區	district	DistrictSummary	選區概要
政府區域	governmentRegion	GovernmentRegionSummary	政府區域摘要
聯邦州	federalState	FederalStateSummary	聯邦州的摘要

公社

列支敦士登的公社

名稱	路徑	類型	Description
Key	key	string	市鎮編號（4位數）。
名稱	name	string	該市鎮的官方名稱。
選區	electoralDistrict	string	選區 – 奧伯蘭或下蘭。

地方性LI

列支敦士登的地理位置

名稱	路徑	類型	Description
名稱	name	string	該地名稱。
postalCode	postalCode	string	當地郵遞區號。
Key	commune.key	string	市鎮編號（4位數）。
名稱	commune.name	string	該市鎮的官方名稱。

StreetLI

列支敦士登的街道

名稱	路徑	類型	Description
Key	key	string	街道鑰匙。
名稱	name	string	街道名稱。
狀態	status	string	街道狀態（規劃中、真實中、過時）。
postalCode	postalCode	string	郵遞區號。
地區	locality	string	該地名稱。
Key	commune.key	string	市鎮編號（4位數）。
名稱	commune.name	string	該市鎮的官方名稱。

廣東CH

瑞士州

名稱	路徑	類型	Description
Key	key	string	該州的BFS號碼（最多2位數）。
歷史代碼	historicalCode	string	州的歷史法典。
名稱	name	string	該州名稱。
短名稱	shortName	string	州名縮寫（兩個字母）。

廣州大學

瑞士州的概述

名稱	路徑	類型	Description
Key	key	string	該州的BFS號碼（最多2位數）。
名稱	name	string	該州名稱。
短名稱	shortName	string	州名縮寫（兩個字母）。

區CH

瑞士的區域

名稱	路徑	類型	Description
Key	key	string	學區的BFS號碼（最多4位數）。
歷史代碼	historicalCode	string	該區的歷史代碼。
名稱	name	string	該區名稱。
短名稱	shortName	string	該區的簡稱。
坎頓	canton	CantonCHSummary	瑞士州的概述

區CHSumary

瑞士區的概述

名稱	路徑	類型	Description
Key	key	string	學區的BFS號碼（最多4位數）。
名稱	name	string	該區名稱。
短名稱	shortName	string	該區的簡稱。

公社

瑞士的公社

名稱	路徑	類型	Description
Key	key	string	該市鎮的BFS號碼（最多4位數）。
歷史代碼	historicalCode	string	公社的歷史代碼。
名稱	name	string	該市鎮的官方名稱。
短名稱	shortName	string	市鎮的簡稱。
區	district	DistrictCHSummary	瑞士區的概述
坎頓	canton	CantonCHSummary	瑞士州的概述

公社

瑞士市鎮概述

名稱	路徑	類型	Description
Key	key	string	該市鎮的BFS號碼（最多4位數）。
名稱	name	string	公社名稱。
短名稱	shortName	string	市鎮的簡稱。

地方CH

瑞士地區

名稱	路徑	類型	Description
Key	key	string	地點識別碼。
名稱	name	string	該地名稱。
郵遞區號	postalcode	string	當地郵遞區號。
市鎮	commune	CommuneCHSummary	瑞士市鎮概述
區	district	DistrictCHSummary	瑞士區的概述
坎頓	canton	CantonCHSummary	瑞士州的概述

StreetCH

瑞士的街道

名稱	路徑	類型	Description
Key	key	string	街道鑰匙。
名稱	name	string	街道名稱。
狀態	status	string	街道狀況。可能的價值觀：計劃性、真實性、過時性。
郵遞區號	postalcode	string	當地郵遞區號。
地區	locality	string	該地名稱。
市鎮	commune	CommuneCHSummary	瑞士市鎮概述
區	district	DistrictCHSummary	瑞士區的概述
坎頓	canton	CantonCHSummary	瑞士州的概述

聯邦省AT

奧地利的聯邦省

名稱	路徑	類型	Description
Key	key	string	聯邦省份識別碼（1 位數）。
名稱	name	string	聯邦省的名稱。

聯邦省省 ATSumary

奧地利聯邦省份概要

名稱	路徑	類型	Description
Key	key	string	聯邦省份識別碼（1 位數）。
名稱	name	string	聯邦省的名稱。

DistrictAT

奧地利的區

名稱	路徑	類型	Description
Key	key	string	區域識別碼（3位數）。
字碼	code	string	區碼（三位數）。
名稱	name	string	該區名稱。
聯邦省份	federalProvince	FederalProvinceATSummary	奧地利聯邦省份概要

DistrictATSumary

奧地利一個地區的摘要

名稱	路徑	類型	Description
Key	key	string	區域識別碼（3位數）。
字碼	code	string	區碼（三位數）。
名稱	name	string	該區名稱。

市政AT

奧地利的市鎮

名稱	路徑	類型	Description
Key	key	string	市鎮識別碼（5 位數）。
字碼	code	string	市政區碼（5位數）。
名稱	name	string	市鎮名稱。
狀態	status	string	市政地位（例如城市、集鎮等）。
postalCode	postalCode	string	市政廳郵遞區號。
多郵遞區號	multiplePostalCodes	boolean	市政府是否涵蓋多個郵遞區號？
區	district	DistrictATSummary	奧地利一個地區的摘要
聯邦省份	federalProvince	FederalProvinceATSummary	奧地利聯邦省份概要

市政ATSummary

奧地利市鎮概述

名稱	路徑	類型	Description
Key	key	string	市鎮識別碼（5 位數）。
字碼	code	string	市政區碼（5位數）。
名稱	name	string	市鎮名稱。

LocalityAT

奧地利的地理位置

名稱	路徑	類型	Description
Key	key	string	地點識別碼。
名稱	name	string	該地名稱。
郵遞區號	postalcode	string	當地郵遞區號。
自治區	municipality	MunicipalityATSummary	奧地利市鎮概述
區	district	DistrictATSummary	奧地利一個地區的摘要
聯邦省份	federalProvince	FederalProvinceATSummary	奧地利聯邦省份概要

StreetAT

奧地利的街道

名稱	路徑	類型	Description
Key	key	string	街道識別碼。
名稱	name	string	街道名稱。
郵遞區號	postalcode	string	當地郵遞區號。
地區	locality	string	該地名稱。
自治區	municipality	MunicipalityATSummary	奧地利市鎮概述
區	district	DistrictATSummary	奧地利一個地區的摘要
聯邦省份	federalProvince	FederalProvinceATSummary	奧地利聯邦省份概要

共用方式為