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,위도 |
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 흐름입니다. Azure 역할 기반 액세스 제어와 페어링하면 Azure Maps REST API에 대한 액세스를 제어하는 데 사용할 수 있습니다. Azure 역할 기반 액세스 제어는 하나 이상의 Azure Maps 리소스 계정 또는 하위 리소스에 대한 액세스를 지정하는 데 사용됩니다. 모든 사용자, 그룹 또는 서비스 주체는 Azure Maps REST API에 대한 하나 이상의 권한으로 구성된 기본 제공 역할 또는 사용자 지정 역할을 통해 액세스 권한을 부여할 수 있습니다.
시나리오를 구현하려면 인증 개념을 보는 것이 좋습니다. 요약하자면, 이 보안 정의는 특정 API 및 범위에 대한 액세스 제어가 가능한 개체를 통해 애플리케이션을 모델링하기 위한 솔루션을 제공합니다.
참고
- 이 보안 정의 에서는 헤더를 사용하여 애플리케이션이
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 웹 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 관리 평면을 통해 Azure Maps 리소스 를 만들 때 프로비전되는 공유 키입니다.
이 키를 사용하면 모든 애플리케이션이 모든 REST API에 액세스할 수 있는 권한이 부여됩니다. 즉, 이러한 키는 현재 발급된 계정의 마스터 키로 처리될 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 이 키를 안전하게 저장할 수 있는 Azure Maps REST API의 서버-서버 액세스를 사용하는 것이 좋습니다.
형식:
apiKey
In(다음 안에):
header
SAS Token
Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해 Azure Maps 리소스 의 SAS 나열 작업에서 생성된 공유 액세스 서명 토큰입니다.
이 토큰을 사용하면 모든 애플리케이션이 Azure 역할 기반 액세스 제어 및 특정 토큰에 사용할 만료, 속도 및 지역에 대한 세분화된 제어를 사용하여 액세스할 수 있는 권한이 부여됩니다. 즉, SAS 토큰을 사용하여 애플리케이션이 공유 키보다 더 보안이 유지되는 방식으로 액세스를 제어할 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 렌더링 남용을 제한하고 정기적으로 SAS 토큰을 갱신하도록 Map 계정 리소스 에서 허용되는 특정 원본 목록을 구성하는 것이 좋습니다.
형식:
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 |
이 서비스는 일반적으로 Polygon 또는 MultiPolygon 하위 형식이 있는 GeometryCollection을 반환합니다. |
Boundary |
경계를 반환할 지정학적 개념입니다. 지정하지 않으면 기본값은 결과 형식입니다 |
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
Geo |
유효한 |
Geo |
유효한 개체 형식입니다 |
Geo |
유효한 |
Geo |
유효한 |
Geo |
유효한 |
Geo |
유효한 개체 형식입니다 |
Geo |
유효한 |
Geo |
유효한 |
Geometry |
Boundary 개체의 기하 도형에 대한 저작권 정보입니다. |
Resolution |
해상도는 다시 보낼 포인트의 양을 결정합니다. 지정하지 않으면 기본값은 중간 해상도입니다. |
Boundary
GeoJSON GeocodingFeature
지리적 영역의 경계를 설명하는 개체입니다. 기능의 기하 도형은 로 설명됩니다 GeoJSON GeometryCollection
.
이 서비스는 일반적으로 Polygon 또는 MultiPolygon 하위 형식이 있는 GeometryCollection을 반환합니다.
Name | 형식 | Description |
---|---|---|
bbox |
number[] |
경계 상자. 사용된 프로젝션 - EPSG:3857. 자세한 내용은 RFC 7946 을 참조하세요. |
copyright |
string |
저작권 문자열입니다. |
copyrightURL |
string |
Azure Maps에 대한 많은 데이터 공급자와 관련 저작권 정보를 나열하는 URL입니다. |
featureType |
string |
기능의 유형입니다. 값은 현재 기능이 속한 데이터 모델에 따라 달라집니다. 일부 데이터 모델에는 빈 값이 있을 수 있습니다. |
geometriesCopyright |
경계 개체의 각 기하 도형에 대해 표시되는 순서와 동일한 순서로 저작권 정보의 컬렉션입니다. |
|
geometry | GeoJsonGeometry: |
유효한 |
id |
string |
기능에 대한 식별자입니다. |
name |
string |
지리적 영역과 연결된 이름입니다. |
type |
string:
Feature |
|
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 |
Error 개체. |
GeoJsonGeometry
유효한 GeoJSON
geometry 개체입니다. 이 형식은 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
Boundary 개체의 기하 도형에 대한 저작권 정보입니다.
Name | 형식 | Description |
---|---|---|
copyright |
string |
데이터 공급자에 대한 저작권 문자열 |
sourceName |
string |
데이터 공급자의 이름 |
ResolutionEnum
해상도는 다시 보낼 포인트의 양을 결정합니다. 지정하지 않으면 기본값은 중간 해상도입니다.
Name | 형식 | Description |
---|---|---|
huge |
string |
점의 양이 크거나 같은 경계 기하 도형을 반환합니다. |
large |
string |
중간 정도의 포인트가 많거나 같은 경계 기하 도형을 반환합니다. |
medium |
string |
더 많거나 같은 양의 포인트가 작은 경계 기하 도형을 반환합니다. |
small |
string |
점의 양이 가장 적은 경계 기하 도형을 반환합니다. |