Traffic - Get Traffic Flow Tile

Service:

Maps

API Version:

1.0

트래픽 흐름을 보여 주는 256 x 256 픽셀 타일을 가져오는 데 사용합니다.

Traffic Flow Tile API는 트래픽 흐름을 표시하는 256 x 256 픽셀 타일의 트래픽 조건에 대한 실시간 정보를 반환하는 HTTP GET 요청입니다. 모든 타일은 동일한 그리드 시스템을 사용합니다. 트래픽 타일은 투명한 이미지를 사용하므로 지도 타일 위에 계층화하여 복합 디스플레이를 만들 수 있습니다. Flow 타일은 색을 사용하여 다른 도로 세그먼트의 교통 속도 또는 해당 속도와 해당 도로 세그먼트의 자유 흐름 속도 간의 차이를 나타냅니다.

GET https://atlas.microsoft.com/traffic/flow/tile/{format}?api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}

With optional parameters:

GET https://atlas.microsoft.com/traffic/flow/tile/{format}?api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}&thickness={thickness}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
format	path	True	TileFormat	원하는 응답 형식입니다. 가능한 값은 png & pbf입니다.
api-version	query	True	string	Azure Maps API의 버전 번호.
style	query	True	TrafficFlowTileStyle	타일을 렌더링하는 데 사용할 스타일입니다.
x	query	True	integer int32	확대/축소 그리드에 있는 타일의 X 좌표입니다. 값은 [0, 2zoom -1] 범위에 있어야 합니다. 자세한 내용은 확대/축소 수준 및 타일 그리드 를 참조하세요.
y	query	True	integer int32	확대/축소 그리드에서 타일의 Y 좌표입니다. 값은 [0, 2zoom -1] 범위에 있어야 합니다. 자세한 내용은 확대/축소 수준 및 타일 그리드 를 참조하세요.
zoom	query	True	integer int32	원하는 타일의 확대/축소 수준입니다. 래스터 타일의 경우 값은 0-22(포함) 범위에 있어야 합니다. 벡터 타일의 경우 값은 0-22(포함) 범위에 있어야 합니다. 자세한 내용은 확대/축소 수준 및 타일 그리드 를 참조하세요.
thickness	query		integer int32	트래픽을 나타내는 선의 너비 값입니다. 이 값은 승수이며 허용되는 값의 범위는 1~20입니다. 기본값은 10입니다. 형식이 pbf인 경우 이 매개 변수는 유효하지 않습니다.

요청 헤더

Name	필수	형식	Description
x-ms-client-id		string	Microsoft Entra ID 보안 모델과 함께 사용할 계정을 지정합니다. Azure Maps 계정의 고유 ID를 나타내며 Azure Maps 관리 평면 계정 API에서 검색할 수 있습니다. Azure Maps Microsoft Entra ID 보안을 사용하려면 다음 문서를 참조하세요.

응답

Name	형식	Description
200 OK	object	이 이미지는 성공적인 트래픽 흐름 타일 호출에서 반환됩니다. Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile" Headers Content-Type: string
Other Status Codes	ErrorResponse	예기치 않은 오류가 발생했습니다. Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

보안

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 리소스를 나타내기 위해 헤더를 사용해야 합니다. 이는 지도 관리 API에서 가져올 수 있습니다.

Authorization URL 은 Azure 퍼블릭 클라우드 instance 관련됩니다. 소버린 클라우드에는 고유한 권한 부여 URL 및 Microsoft Entra ID 구성이 있습니다. * Azure 역할 기반 액세스 제어는 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면에서 구성됩니다. * Azure Maps Web 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 Azure Maps 계정을 만들거나 PowerShell, CLI, Azure SDK 또는 REST API를 사용할 때 프로비전되는 공유 키입니다.

이 키를 사용하면 모든 애플리케이션이 모든 REST API에 액세스할 수 있습니다. 즉, 이 키는 발급된 계정에서 master 키로 사용할 수 있습니다.

공개적으로 노출된 애플리케이션의 경우 기밀 클라이언트 애플리케이션 접근 방식을 사용하여 키를 안전하게 저장할 수 있도록 Azure Maps REST API에 액세스하는 것이 좋습니다.

Type: apiKey
In: query

SAS Token

공유 액세스 서명 토큰은 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해 Azure Maps 리소스의 SAS 나열 작업에서 만들어집니다.

이 토큰을 사용하면 모든 애플리케이션이 특정 토큰에 사용할 만료, 속도 및 지역에 대한 Azure 역할 기반 액세스 제어 및 세분화된 제어를 사용하여 액세스할 수 있는 권한이 부여됩니다. 즉, SAS 토큰을 사용하여 애플리케이션이 공유 키보다 더 보안이 유지되는 방식으로 액세스를 제어할 수 있습니다.

공개적으로 노출된 애플리케이션의 경우 렌더링 남용을 제한하고 정기적으로 SAS 토큰을 갱신하도록 맵 계정 리소스 에서 허용되는 특정 원본 목록을 구성하는 것이 좋습니다.

Type: apiKey
In: header

예제

Request tile depicting the traffic flow

Sample Request

HTTP

GET https://atlas.microsoft.com/traffic/flow/tile/png?api-version=1.0&style=absolute&zoom=12&x=2044&y=1360

Sample Response

Status code:

200

"binary string image"

정의

Name	Description
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
TileFormat	원하는 응답 형식입니다. 가능한 값은 png & pbf입니다.
TrafficFlowTileStyle	타일을 렌더링하는 데 사용할 스타일입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

오류 응답

Name	형식	Description
error	ErrorDetail	Error 개체.

TileFormat

원하는 응답 형식입니다. 가능한 값은 png & pbf입니다.

Name	형식	Description
pbf	string	pbf 형식의 벡터 그래픽입니다. 확대/축소 수준 0~22를 지원합니다.
png	string	png 형식의 이미지입니다. 확대/축소 수준 0~18을 지원합니다.

TrafficFlowTileStyle

타일을 렌더링하는 데 사용할 스타일입니다.

Name	형식	Description
absolute	string	색은 측정된 절대 속도를 반영합니다. 절대 속도는 전체 속도에 액세스하는 기능입니다.
reduced-sensitivity	string	상대 색을 표시하지만 세그먼트가 색을 변경하려면 자유 흐름과 더 큰 차이가 필요합니다. 이 모드는 형식이 png인 경우에만 유효합니다.
relative	string	이는 트래픽 흐름을 시각화하는 혼잡 영역을 강조 표시하는 자유 흐름에 상대적인 속도입니다. 자유 흐름은 혼잡이 없고 트래픽이 속도 제한을 따를 수 있는 조건을 나타냅니다. 맵에서 트래픽 흐름을 시각화하는 데 가장 많이 사용되는 옵션입니다.
relative-delay	string	자유 흐름 속도와 다른 경우에만 상대 색을 표시합니다. 이 옵션은 혼잡 영역만 강조 표시합니다.