Search - Get Polygon
도시 또는 국가 지역과 같은 지리적 영역 셰이프의 다각형 데이터를 가져오는 데 사용합니다.
Get Polygon
API는 도시 또는 국가 지역과 같은 지리적 영역 개요의 다각형 데이터를 제공하는 HTTP GET
요청입니다.
GET https://atlas.microsoft.com/search/polygon?api-version=2023-06-01&coordinates={coordinates}
GET https://atlas.microsoft.com/search/polygon?api-version=2023-06-01&coordinates={coordinates}&view={view}&resultType={resultType}&resolution={resolution}
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
api-version
|
query | True |
string |
Azure Maps API의 버전 번호입니다. |
coordinates
|
query | True |
number[] |
경도 및 위도로 지정된 지구의 점입니다. 예: &좌표=lon,lat |
resolution
|
query |
해결 방법은 다시 보낼 지점의 양을 결정합니다. 지정하지 않으면 기본값은 중간 해상도입니다. |
||
result
|
query |
경계를 반환할 지정학적 개념입니다. 지정하지 않으면 기본값은 |
||
view
|
query |
string |
ISO 3166-1 Alpha-2 지역/국가 코드나타내는 문자열입니다. 이렇게 하면 지정학적으로 분쟁이 있는 테두리 및 레이블이 지정된 사용자 지역에 맞게 변경됩니다. 기본적으로 View 매개 변수는 요청에서 정의하지 않은 경우에도 "자동"으로 설정됩니다. 자세한 내용은 지원되는 뷰 참조하고 사용 가능한 보기를 확인하세요. |
요청 헤더
Name | 필수 | 형식 | Description |
---|---|---|---|
x-ms-client-id |
string |
Azure AD 보안 모델과 함께 사용할 계정을 지정합니다. Azure Maps 계정에 대한 고유 ID를 나타내며 Azure Maps 관리 평면 계정 API에서 검색할 수 있습니다. Azure Maps에서 Azure AD 보안을 사용하려면 지침에 대한 다음 |
|
Accept-Language |
string |
검색 결과를 반환해야 하는 언어입니다. 자세한 내용은 지원되는 언어 참조하세요. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
그래 Media Types: "application/geo+json" |
|
Other Status Codes |
예기치 않은 오류가 발생했습니다. Media Types: "application/geo+json" |
보안
AADToken
다음은 Microsoft Entra OAuth 2.0 흐름에
시나리오를 구현하려면
메모
- 이 보안 정의
x-ms-client-id
헤더를 사용하여 애플리케이션이 액세스를 요청하는 Azure Maps 리소스를 나타내야 합니다. 이는 Maps 관리 API가져올 수 있습니다. -
Authorization URL
Azure 퍼블릭 클라우드 인스턴스와 관련이 있습니다. 소버린 클라우드에는 고유한 권한 부여 URL 및 Microsoft Entra ID 구성이 있습니다. - Azure 역할 기반 액세스 제어는 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해
Azure 관리 평면에서 구성됩니다. - Azure Maps Web SDK 사용하면 여러 사용 사례에 대한 애플리케이션의 구성 기반 설정을 사용할 수 있습니다.
- Microsoft ID 플랫폼에 대한 자세한 내용은 Microsoft ID 플랫폼 개요참조하세요.
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
Name | Description |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해
이 키를 사용하면 모든 애플리케이션이 모든 REST API에 액세스할 수 있는 권한이 부여됩니다. 즉, 이러한 키는 현재 발급된 계정의 마스터 키로 처리될 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 이 키를 안전하게 저장할 수 있는 Azure Maps REST API의 서버-서버 액세스를 사용하는 것이 좋습니다.
형식:
apiKey
In(다음 안에):
header
SAS Token
공유 액세스 서명 토큰은 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해
이 토큰을 사용하면 모든 애플리케이션이 Azure 역할 기반 액세스 제어를 사용하여 액세스하고 특정 토큰에 사용할 만료, 속도 및 지역에 대한 세분화된 제어 권한을 부여받습니다. 즉, SAS 토큰을 사용하여 애플리케이션이 공유 키보다 더 보안이 유지되는 방식으로 액세스를 제어할 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 렌더링 남용을 제한하고 정기적으로 SAS 토큰을 갱신하도록 맵 계정 리소스 허용된 원본의 특정 목록을 구성하는 것이 좋습니다.
형식:
apiKey
In(다음 안에):
header
예제
Get polygon for a city at coordinates -122.204141,47.612560
샘플 요청
GET https://atlas.microsoft.com/search/polygon?api-version=2023-06-01&coordinates=-122.204141,47.61256&resultType=locality&resolution=small
샘플 응답
Content-Type: application/geo+json
{
"type": "Feature",
"geometry": {
"type": "GeometryCollection",
"geometries": [
{
"type": "Polygon",
"coordinates": [
[
[
-122.13035,
47.53502
],
[
-122.12882,
47.53567
],
[
-122.12638000000001,
47.535140000000006
],
[
-122.12378000000001,
47.53717
],
[
-122.12068000000001,
47.537620000000004
],
[
-122.12028000000001,
47.538000000000004
],
[
-122.11682,
47.537940000000006
],
[
-122.11527000000001,
47.53609
],
[
-122.11119000000001,
47.536080000000005
],
[
-122.11103000000001,
47.539280000000005
],
[
-122.10832,
47.539530000000006
],
[
-122.10830000000001,
47.54057
],
[
-122.11006,
47.54055
],
[
-122.10999000000001,
47.542640000000006
],
[
-122.11185,
47.54298000000001
],
[
-122.11183000000001,
47.54426
],
[
-122.1114,
47.543800000000005
],
[
-122.10936000000001,
47.54379
],
[
-122.10912,
47.54462
],
[
-122.10745000000001,
47.544830000000005
],
[
-122.10808000000002,
47.545190000000005
],
[
-122.10808000000002,
47.54656000000001
],
[
-122.10665000000002,
47.546580000000006
],
[
-122.10711,
47.544700000000006
],
[
-122.10530000000001,
47.54473
],
[
-122.1054,
47.546910000000004
],
[
-122.10434000000001,
47.54693
],
[
-122.10433,
47.544830000000005
],
[
-122.10056000000002,
47.544940000000004
],
[
-122.1007,
47.548500000000004
],
[
-122.10194000000001,
47.54849
],
[
-122.10194000000001,
47.54883
],
[
-122.10194000000001,
47.549510000000005
],
[
-122.10071,
47.54883
],
[
-122.10048,
47.54849
],
[
-122.10047000000002,
47.54883
],
[
-122.10038000000002,
47.55904
],
[
-122.09796000000001,
47.55923000000001
],
[
-122.09870000000001,
47.560570000000006
],
[
-122.09818000000001,
47.56248
],
[
-122.10011000000002,
47.56839
],
[
-122.09876000000001,
47.56884
],
[
-122.09942000000001,
47.569900000000004
],
[
-122.09782000000001,
47.56983
],
[
-122.09672,
47.58019
],
[
-122.09885000000001,
47.58666
],
[
-122.09796000000001,
47.59503
],
[
-122.09664000000001,
47.602230000000006
],
[
-122.09411000000001,
47.607240000000004
],
[
-122.09104,
47.610240000000005
],
[
-122.08366000000001,
47.615660000000005
],
[
-122.08008000000001,
47.61939
],
[
-122.07904,
47.62201
],
[
-122.07959000000001,
47.627520000000004
],
[
-122.08008000000001,
47.627520000000004
],
[
-122.09181000000001,
47.627520000000004
],
[
-122.09221000000001,
47.62717000000001
],
[
-122.09256,
47.627520000000004
],
[
-122.11094000000001,
47.62765
],
[
-122.11091,
47.636720000000004
],
[
-122.11091,
47.64609
],
[
-122.11431,
47.646060000000006
],
[
-122.11437000000001,
47.64533
],
[
-122.11597,
47.64374
],
[
-122.12254000000001,
47.638510000000004
],
[
-122.12542,
47.636720000000004
],
[
-122.12809000000001,
47.635200000000005
],
[
-122.13241000000001,
47.63515
],
[
-122.13234000000001,
47.63268
],
[
-122.13407000000001,
47.63156000000001
],
[
-122.13484000000001,
47.62935
],
[
-122.13626000000001,
47.62820000000001
],
[
-122.1372,
47.627860000000005
],
[
-122.14184000000002,
47.62787
],
[
-122.14321000000001,
47.62713
],
[
-122.14312000000001,
47.636720000000004
],
[
-122.14335000000001,
47.660590000000006
],
[
-122.1641,
47.66077000000001
],
[
-122.16453000000001,
47.646370000000005
],
[
-122.16797000000001,
47.64621
],
[
-122.19629,
47.64643
],
[
-122.19629,
47.64289
],
[
-122.19846000000001,
47.642860000000006
],
[
-122.19846000000001,
47.64242
],
[
-122.19982000000002,
47.6424
],
[
-122.20169000000001,
47.644600000000004
],
[
-122.20341,
47.643190000000004
],
[
-122.20818000000001,
47.6435
],
[
-122.21014000000001,
47.643130000000006
],
[
-122.20962000000002,
47.642920000000004
],
[
-122.20974000000001,
47.636720000000004
],
[
-122.21005000000001,
47.62107
],
[
-122.22268000000001,
47.62106000000001
],
[
-122.22268000000001,
47.62066
],
[
-122.22203,
47.620470000000005
],
[
-122.22282000000001,
47.619890000000005
],
[
-122.22142000000001,
47.618570000000005
],
[
-122.22248,
47.61838
],
[
-122.22271,
47.617200000000004
],
[
-122.22136,
47.617180000000005
],
[
-122.21985000000001,
47.61643
],
[
-122.22044000000001,
47.614470000000004
],
[
-122.22033,
47.603840000000005
],
[
-122.22043000000001,
47.59682
],
[
-122.21702,
47.59038
],
[
-122.21653,
47.59042
],
[
-122.21572,
47.588240000000006
],
[
-122.21067000000001,
47.58375
],
[
-122.20153,
47.57887
],
[
-122.20227000000001,
47.57864000000001
],
[
-122.20132000000001,
47.578770000000006
],
[
-122.20034000000001,
47.57822
],
[
-122.19901000000002,
47.57592
],
[
-122.19923000000001,
47.567460000000004
],
[
-122.20034000000001,
47.55962
],
[
-122.20072,
47.55966
],
[
-122.20114000000001,
47.557520000000004
],
[
-122.20119000000001,
47.54943
],
[
-122.20160000000001,
47.549440000000004
],
[
-122.20167000000001,
47.54883
],
[
-122.20200000000001,
47.54609000000001
],
[
-122.19676000000001,
47.54621
],
[
-122.19545000000001,
47.54609000000001
],
[
-122.19545000000001,
47.545750000000005
],
[
-122.19091000000002,
47.54580000000001
],
[
-122.1907,
47.54216
],
[
-122.18581,
47.542100000000005
],
[
-122.18116,
47.541140000000006
],
[
-122.17142000000001,
47.54086
],
[
-122.16987,
47.54008
],
[
-122.16797000000001,
47.540060000000004
],
[
-122.16554000000001,
47.54005
],
[
-122.16439000000001,
47.54281
],
[
-122.16433,
47.545480000000005
],
[
-122.15356000000001,
47.54538
],
[
-122.15359000000001,
47.541760000000004
],
[
-122.14280000000001,
47.541520000000006
],
[
-122.14288,
47.539370000000005
],
[
-122.13645000000001,
47.53826
],
[
-122.13035,
47.53502
]
],
[
[
-122.19957000000001,
47.58372000000001
],
[
-122.20448,
47.583830000000006
],
[
-122.20585000000001,
47.586780000000005
],
[
-122.19654000000001,
47.586740000000006
],
[
-122.19655000000002,
47.58379
],
[
-122.19957000000001,
47.58372000000001
]
]
]
}
]
},
"properties": {
"name": "Bellevue",
"copyright": "© 2022 Microsoft and its suppliers. This API and any results cannot be used or accessed without Microsoft's express written permission.",
"copyrightURL": "https://azure.microsoft.com/en-us/support/legal/preview-supplemental-terms/",
"geometriesCopyright": [
{
"sourceName": "TOM",
"copyright": "TomTom"
}
]
}
}
정의
Name | Description |
---|---|
Boundary |
이 서비스는 일반적으로 다각형 또는 MultiPolygon 하위 형식을 사용하여 GeometryCollection을 반환합니다. |
Boundary |
Boundary 개체의 속성입니다. |
Boundary |
경계를 반환할 지정학적 개념입니다. 지정하지 않으면 기본값은 |
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
Feature |
기능 유형은 기능이어야 합니다. |
Geo |
유효한 |
Geo |
유효한 |
Geo |
유효한 |
Geo |
유효한 |
Geo |
유효한 |
Geo |
유효한 |
Geo |
유효한 |
Geo |
유효한 |
Geometry |
경계 개체의 기하 도형에 대한 저작권 정보입니다. |
Resolution |
해결 방법은 다시 보낼 지점의 양을 결정합니다. 지정하지 않으면 기본값은 중간 해상도입니다. |
Boundary
GeoJSON GeocodingFeature
지리적 영역의 경계를 설명하는 개체입니다. 기능의 기하 도형은 GeoJSON GeometryCollection
설명합니다.
이 서비스는 일반적으로 다각형 또는 MultiPolygon 하위 형식을 사용하여 GeometryCollection을 반환합니다.
Name | 형식 | Description |
---|---|---|
geometry |
유효한 |
|
properties |
Boundary 개체의 속성입니다. |
|
type |
기능 유형은 기능이어야 합니다. |
BoundaryProperties
Boundary 개체의 속성입니다.
Name | 형식 | Description |
---|---|---|
copyright |
string |
저작권 문자열입니다. |
copyrightURL |
string |
Azure Maps 및 관련 저작권 정보에 대한 많은 데이터 공급자를 나열하는 URL입니다. |
geometriesCopyright |
경계 개체의 각 기하 도형에 대해 표시되는 순서와 동일한 순서로 저작권 정보의 컬렉션입니다. |
|
name |
string |
지리적 영역과 연결된 이름입니다. |
BoundaryResultTypeEnum
경계를 반환할 지정학적 개념입니다. 지정하지 않으면 기본값은 countryRegion
결과 형식입니다.
Name | 형식 | Description |
---|---|---|
adminDistrict |
string |
국가/지역 수준 내의 첫 번째 관리 수준(예: 주 또는 지방)입니다. |
adminDistrict2 |
string |
국가/지역 수준 내의 두 번째 관리 수준(예: 카운티)입니다. |
countryRegion |
string |
국가 또는 지역. |
locality |
string |
도시, 마을 또는 마을과 같은 인간 정착지의 집중된 지역입니다. |
neighborhood |
string |
일반적으로 잘 알려져 있지만 종종 무분별한 경계가 있는 채워진 장소의 섹션입니다. |
postalCode |
string |
우편 번호와 같은 가장 작은 우편 번호 범주입니다. |
postalCode2 |
string |
postalCode 영역을 집계하여 만든 postalCode 다음으로 큰 우편 번호 범주입니다. |
postalCode3 |
string |
postalCode2 영역을 집계하여 만든 postalCode2 다음으로 큰 우편 번호 범주입니다. |
postalCode4 |
string |
postalCode3 영역을 집계하여 만든 postalCode3 다음으로 큰 우편 번호 범주입니다. |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
오류 개체입니다. |
FeatureTypeEnum
기능 유형은 기능이어야 합니다.
Name | 형식 | Description |
---|---|---|
Feature |
string |
GeoJsonGeometry
유효한 GeoJSON
기하 도형 개체입니다. 이 형식은 Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon 및 GeometryCollection의 7가지 유효한 GeoJSON 기하 도형 형식 중 하나여야 합니다. 자세한 내용은 RFC 7946 참조하세요.
Name | 형식 | Description |
---|---|---|
bbox |
number[] |
경계 상자. 사용된 프로젝션 - EPSG:3857. 자세한 내용은 RFC 7946 참조하세요. |
type |
Geo |
|
GeoJsonGeometryCollection
유효한 GeoJSON GeometryCollection
개체 형식입니다. 자세한 내용은 RFC 7946 참조하세요.
Name | 형식 | Description |
---|---|---|
bbox |
number[] |
경계 상자. 사용된 프로젝션 - EPSG:3857. 자세한 내용은 RFC 7946 참조하세요. |
geometries | GeoJsonGeometry[]: |
유효한 |
type |
string:
Geometry |
|
GeoJsonLineString
유효한 GeoJSON LineString
기하 도형 형식입니다. 자세한 내용은 RFC 7946 참조하세요.
Name | 형식 | Description |
---|---|---|
bbox |
number[] |
경계 상자. 사용된 프로젝션 - EPSG:3857. 자세한 내용은 RFC 7946 참조하세요. |
coordinates |
number[] |
|
type |
string:
Line |
|
GeoJsonMultiLineString
유효한 GeoJSON MultiLineString
기하 도형 형식입니다. 자세한 내용은 RFC 7946 참조하세요.
Name | 형식 | Description |
---|---|---|
bbox |
number[] |
경계 상자. 사용된 프로젝션 - EPSG:3857. 자세한 내용은 RFC 7946 참조하세요. |
coordinates |
number[] |
|
type |
string:
Multi |
|
GeoJsonMultiPoint
유효한 GeoJSON MultiPoint
기하 도형 형식입니다. 자세한 내용은 RFC 7946 참조하세요.
Name | 형식 | Description |
---|---|---|
bbox |
number[] |
경계 상자. 사용된 프로젝션 - EPSG:3857. 자세한 내용은 RFC 7946 참조하세요. |
coordinates |
number[] |
|
type |
string:
Multi |
|
GeoJsonMultiPolygon
유효한 GeoJSON MultiPolygon
개체 형식입니다. 자세한 내용은 RFC 7946 참조하세요.
Name | 형식 | Description |
---|---|---|
bbox |
number[] |
경계 상자. 사용된 프로젝션 - EPSG:3857. 자세한 내용은 RFC 7946 참조하세요. |
coordinates |
number[] |
유효한 |
type |
string:
Multi |
|
GeoJsonPoint
유효한 GeoJSON Point
기하 도형 형식입니다. 자세한 내용은 RFC 7946 참조하세요.
Name | 형식 | Description |
---|---|---|
bbox |
number[] |
경계 상자. 사용된 프로젝션 - EPSG:3857. 자세한 내용은 RFC 7946 참조하세요. |
coordinates |
number[] |
|
type |
string:
Point |
|
GeoJsonPolygon
유효한 GeoJSON Polygon
기하 도형 형식입니다. 자세한 내용은 RFC 7946 참조하세요.
Name | 형식 | Description |
---|---|---|
bbox |
number[] |
경계 상자. 사용된 프로젝션 - EPSG:3857. 자세한 내용은 RFC 7946 참조하세요. |
coordinates |
number[] |
|
type |
string:
Polygon |
|
GeometryCopyright
경계 개체의 기하 도형에 대한 저작권 정보입니다.
Name | 형식 | Description |
---|---|---|
copyright |
string |
데이터 공급자에 대한 저작권 문자열 |
sourceName |
string |
데이터 공급자의 이름 |
ResolutionEnum
해결 방법은 다시 보낼 지점의 양을 결정합니다. 지정하지 않으면 기본값은 중간 해상도입니다.
Name | 형식 | Description |
---|---|---|
huge |
string |
점 크기가 크거나 같은 경계 기하 도형을 반환합니다. |
large |
string |
중간 정도의 포인트가 더 많거나 같은 경계 기하 도형을 반환합니다. |
medium |
string |
점의 양이 작거나 같은 경계 기하 도형을 반환합니다. |
small |
string |
점이 가장 적은 경계 기하 도형을 반환합니다. |