Spatial - Post Buffer
를 사용하여 각 기능이 입력의 해당 인덱싱된 기능 주위의 버퍼인 위치를 가져옵니다 FeatureCollection
.
Post Buffer
API는 각 기능이 입력의 해당 인덱싱된 기능 주위의 버퍼인 을 반환 FeatureCollection
하는 HTTP POST
요청입니다. 버퍼는 입력에 제공된 거리에 따라 제공된 기능의 외부 또는 내부에 있을 수 있습니다. 입력에 기능 FeatureCollection
당 하나의 거리가 제공되어야 합니다. 또는 하나의 거리만 제공된 경우 해당 거리는 컬렉션의 모든 기능에 적용됩니다. 기하 도형의 양수(또는 음수) 버퍼는 버퍼 거리의 절대 값과 동일한 반지름 원을 가진 기하 도형의 Minkowski 합계(또는 차이)로 정의됩니다. 버퍼 API는 항상 다각형 결과를 반환합니다. 선과 점의 음수 또는 0거리 버퍼는 항상 빈 다각형입니다. 입력에는 Point, MultiPoint, Polygon, MultiPolygon, LineString 및 MultiLineString 컬렉션이 포함될 수 있습니다. GeometryCollection은 제공된 경우 무시됩니다.
POST https://{geography}.atlas.microsoft.com/spatial/buffer/json?api-version=2022-08-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
format
|
path | True |
원하는 응답 형식입니다. |
|
geography
|
path | True |
string |
Azure Maps 계정의 위치입니다. 유효한 값은 당사(미국 동부, 미국 중서부, 미국 서부 2) 및 eu(북유럽, 서유럽)입니다. 이 매개 변수는 요청에 가 |
api-version
|
query | True |
string |
Azure Maps API의 버전 번호. |
요청 헤더
Name | 필수 | 형식 | Description |
---|---|---|---|
x-ms-client-id |
string |
Microsoft Entra ID 보안 모델과 함께 사용할 계정을 지정합니다. Azure Maps 계정의 고유 ID를 나타내며 Azure Maps 관리 평면 계정 API에서 검색할 수 있습니다. Azure Maps Microsoft Entra ID 보안을 사용하려면 다음 문서를 참조하세요. |
요청 본문
Name | 형식 | Description |
---|---|---|
distances |
number[] |
버퍼를 계산할 거리 목록, 컬렉션의 Feature당 일대일 또는 컬렉션의 모든 Features에 대해 하나씩 나열됩니다. |
geometries |
유효한 개체 형식입니다 |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
정상 |
|
Other Status Codes |
예기치 않은 오류가 발생했습니다. |
보안
AADToken
다음은 Microsoft Entra OAuth 2.0 흐름입니다. Azure 역할 기반 액세스 제어와 쌍을 이루는 경우 Azure Maps REST API에 대한 액세스를 제어하는 데 사용할 수 있습니다. Azure 역할 기반 액세스 제어는 하나 이상의 Azure Maps 리소스 계정 또는 하위 리소스에 대한 액세스를 지정하는 데 사용됩니다. 모든 사용자, 그룹 또는 서비스 주체는 기본 제공 역할 또는 REST API를 Azure Maps 하나 이상의 권한으로 구성된 사용자 지정 역할을 통해 액세스 권한을 부여할 수 있습니다.
시나리오를 구현하려면 인증 개념을 보는 것이 좋습니다. 요약하자면, 이 보안 정의는 특정 API 및 범위에 대한 액세스 제어가 가능한 개체를 통해 애플리케이션을 모델링하는 솔루션을 제공합니다.
참고
- 이 보안 정의에서는 헤더를 사용하여 애플리케이션이
x-ms-client-id
액세스를 요청하는 Azure Maps 리소스를 나타내야 합니다. 이는 Maps 관리 API에서 가져올 수 있습니다.
Authorization URL
은 Azure 퍼블릭 클라우드 instance 관련됩니다. 소버린 클라우드에는 고유한 권한 부여 URL 및 Microsoft Entra ID 구성이 있습니다.
* Azure 역할 기반 액세스 제어는 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면에서 구성됩니다.
* Azure Maps 웹 SDK를 사용하면 여러 사용 사례에 대한 애플리케이션의 구성 기반 설정을 허용합니다.
- Microsoft ID 플랫폼 대한 자세한 내용은 Microsoft ID 플랫폼 개요를 참조하세요.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
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에 액세스할 수 있는 권한이 부여됩니다. 즉, 이러한 키는 현재 발급된 계정에 대한 master 키로 처리될 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 이 키를 안전하게 저장할 수 있는 Azure Maps REST API의 서버-서버 액세스를 사용하는 것이 좋습니다.
Type:
apiKey
In:
header
SAS Token
공유 액세스 서명 토큰은 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해 Azure Maps 리소스의 SAS 나열 작업에서 만들어집니다.
이 토큰을 사용하면 모든 애플리케이션이 Azure 역할 기반 액세스 제어 및 특정 토큰에 사용할 만료, 속도 및 지역에 대한 세분화된 제어를 사용하여 액세스할 수 있는 권한이 부여됩니다. 즉, SAS 토큰을 사용하여 애플리케이션이 공유 키보다 더 보안이 유지되는 방식으로 액세스를 제어할 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 렌더링 남용을 제한하고 정기적으로 SAS 토큰을 갱신하도록 Map 계정 리소스 에서 허용되는 특정 원본 목록을 구성하는 것이 좋습니다.
Type:
apiKey
In:
header
예제
PostBuffer
Sample Request
POST https://us.atlas.microsoft.com/spatial/buffer/json?api-version=2022-08-01
{
"geometries": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"geometryId": "ExampleId"
},
"geometry": {
"type": "Point",
"coordinates": [
-111.9267386,
33.5362475
]
}
}
]
},
"distances": [
176.3
]
}
Sample Response
{
"summary": {
"udid": null,
"information": "1 feature processed in user data"
},
"result": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"geometryId": "ExampleId",
"bufferDist": 176.3
},
"geometry": {
"type": "Polygon",
"coordinates": [
[
[
-111.92483859605078,
33.5362475
],
[
-111.92487510409389,
33.53587682761772
],
[
-111.92498322523961,
33.535520399967204
],
[
-111.92515880445296,
33.535191914363196
],
[
-111.92539509432322,
33.53490399432323
],
[
-111.92568301436319,
33.53466770445297
],
[
-111.9260114999672,
33.53449212523963
],
[
-111.9263679276177,
33.5343840040939
],
[
-111.9267386,
33.534347496050785
],
[
-111.92710927238228,
33.5343840040939
],
[
-111.92746570003278,
33.53449212523963
],
[
-111.9277941856368,
33.53466770445297
],
[
-111.92808210567676,
33.53490399432323
],
[
-111.92831839554702,
33.535191914363196
],
[
-111.92849397476037,
33.535520399967204
],
[
-111.9286020959061,
33.53587682761772
],
[
-111.92863860394921,
33.5362475
],
[
-111.9286020959061,
33.53661817238228
],
[
-111.92849397476037,
33.5369746000328
],
[
-111.92831839554702,
33.53730308563681
],
[
-111.92808210567676,
33.537591005676774
],
[
-111.9277941856368,
33.53782729554703
],
[
-111.92746570003278,
33.53800287476037
],
[
-111.92710927238228,
33.5381109959061
],
[
-111.9267386,
33.53814750394922
],
[
-111.9263679276177,
33.5381109959061
],
[
-111.9260114999672,
33.53800287476037
],
[
-111.92568301436319,
33.53782729554703
],
[
-111.92539509432322,
33.537591005676774
],
[
-111.92515880445296,
33.53730308563681
],
[
-111.92498322523961,
33.5369746000328
],
[
-111.92487510409389,
33.53661817238228
],
[
-111.92483859605078,
33.5362475
]
]
]
}
}
]
}
}
정의
Name | Description |
---|---|
Buffer |
FeatureCollection 및 거리 목록이 있는 개체입니다. 모든 기능의 속성에는 기하 도형을 식별하는 데 사용되며 대/소문자를 구분하는 가 포함되어 |
Buffer |
이 개체는 성공적인 공간 버퍼 호출에서 반환됩니다. |
Buffer |
|
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
Geo |
유효한 개체 형식입니다 |
Geo |
유효한 개체 형식입니다 |
Geo |
유효한 |
Geo |
유효한 개체 형식입니다 |
Geo |
유효한 |
Geo |
유효한 |
Geo |
유효한 |
Geo |
유효한 개체 형식입니다 |
Geo |
유효한 |
Geo |
유효한 |
Json |
원하는 응답 형식입니다. |
BufferRequestBody
FeatureCollection 및 거리 목록이 있는 개체입니다. 모든 기능의 속성에는 기하 도형을 식별하는 데 사용되며 대/소문자를 구분하는 가 포함되어 geometryId
야 합니다.
Name | 형식 | Description |
---|---|---|
distances |
number[] |
버퍼를 계산할 거리 목록, 컬렉션의 Feature당 일대일 또는 컬렉션의 모든 Features에 대해 하나씩 나열됩니다. |
geometries |
유효한 개체 형식입니다 |
BufferResult
이 개체는 성공적인 공간 버퍼 호출에서 반환됩니다.
Name | 형식 | Description |
---|---|---|
result |
입력에 대한 버퍼의 FeatureCollection입니다. |
|
summary |
BufferSummary
Name | 형식 | Description |
---|---|---|
information |
string |
통화 중에 발생한 일에 대한 정보입니다. |
udid |
string |
사용자 데이터의 udid(있는 경우) |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
Error 개체. |
GeoJsonFeature
유효한 개체 형식입니다 GeoJSON Feature
. 자세한 내용은 RFC 7946 을 참조하세요.
Name | 형식 | Description |
---|---|---|
featureType |
string |
기능의 유형입니다. 값은 현재 기능이 속한 데이터 모델에 따라 달라집니다. 일부 데이터 모델에는 빈 값이 있을 수 있습니다. |
geometry | GeoJsonGeometry: |
유효한 |
id |
string |
기능에 대한 식별자입니다. |
type |
string:
Feature |
|
GeoJsonFeatureCollection
유효한 개체 형식입니다 GeoJSON FeatureCollection
. 자세한 내용은 RFC 7946 을 참조하세요.
Name | 형식 | Description |
---|---|---|
features |
유효한 |
|
type |
string:
Feature |
|
GeoJsonGeometry
유효한 GeoJSON
geometry 개체입니다. 이 형식은 Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon 및 GeometryCollection의 7가지 유효한 GeoJSON 기하 도형 형식 중 하나여야 합니다. 자세한 내용은 RFC 7946 을 참조하세요.
Name | 형식 | Description |
---|---|---|
type |
Geo |
|
GeoJsonGeometryCollection
유효한 개체 형식입니다 GeoJSON GeometryCollection
. 자세한 내용은 RFC 7946 을 참조하세요.
Name | 형식 | Description |
---|---|---|
geometries | GeoJsonGeometry[]: |
유효한 |
type |
string:
Geometry |
|
GeoJsonLineString
유효한 GeoJSON LineString
기하 도형 형식입니다. 자세한 내용은 RFC 7946 을 참조하세요.
Name | 형식 | Description |
---|---|---|
coordinates |
number[] |
기하 도형의 |
type |
string:
Line |
|
GeoJsonMultiLineString
유효한 GeoJSON MultiLineString
기하 도형 형식입니다. 자세한 내용은 RFC 7946 을 참조하세요.
Name | 형식 | Description |
---|---|---|
coordinates |
number[] |
기하 도형의 |
type |
string:
Multi |
|
GeoJsonMultiPoint
유효한 GeoJSON MultiPoint
기하 도형 형식입니다. 자세한 내용은 RFC 7946 을 참조하세요.
Name | 형식 | Description |
---|---|---|
coordinates |
number[] |
기하 도형의 |
type |
string:
Multi |
|
GeoJsonMultiPolygon
유효한 개체 형식입니다 GeoJSON MultiPolygon
. 자세한 내용은 RFC 7946 을 참조하세요.
Name | 형식 | Description |
---|---|---|
coordinates |
number[] |
유효한 |
type |
string:
Multi |
|
GeoJsonPoint
유효한 GeoJSON Point
기하 도형 형식입니다. 자세한 내용은 RFC 7946 을 참조하세요.
Name | 형식 | Description |
---|---|---|
coordinates |
number[] |
|
type |
string:
Point |
|
GeoJsonPolygon
유효한 GeoJSON Polygon
기하 도형 형식입니다. 자세한 내용은 RFC 7946 을 참조하세요.
Name | 형식 | Description |
---|---|---|
coordinates |
number[] |
기하 도형 형식의 |
type |
string:
Polygon |
|
JsonFormat
원하는 응답 형식입니다. json
형식만 지원됩니다.
Name | 형식 | Description |
---|---|---|
json |
string |