Render - Get Copyright Caption
타일을 렌더링할 때 사용할 저작권 정보를 가져오는 데 사용합니다.
비고
Azure Maps Render v1 서비스 사용 중지
Azure Maps Render v1 서비스는 이제 더 이상 사용되지 않으며 9/17/26에 사용 중지됩니다. 서비스 중단을 방지하려면 9/17/26까지 최신 버전의 Render API를 사용하도록 Render v1 API에 대한 모든 호출을 업데이트해야 합니다.
Copyrights API는 렌더링 타일 서비스에 대한 저작권 정보를 제공하도록 설계되었습니다. 전체 지도에 대한 기본 저작권 외에도 API는 일부 국가에 대한 특정 저작권 그룹을 제공하고 있습니다.
지도 요청에 대한 저작권 대신 지도 공급자 정보를 지도에 표시하기 위한 캡션을 받을 수 있습니다.
GET https://atlas.microsoft.com/map/copyright/caption/{format}?api-version=1.0
URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
format
|
path | True |
원하는 응답 형식입니다. 값은 json 또는 xml 수 있습니다. |
|
|
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 보안을 사용하는 방법에 대한 자세한 내용은 Azure Maps에서 인증 관리를 참조하세요. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
그래 |
|
| Other Status Codes |
예기치 않은 오류가 발생했습니다. |
보안
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에서 Azure Maps 계정 만들거나 PowerShell, CLI, Azure SDK 또는 REST API를 사용할 때 프로비전되는 공유 키입니다.
이 키를 사용하면 모든 애플리케이션이 모든 REST API에 액세스할 수 있습니다. 즉, 이 키를 발급된 계정에서 마스터 키로 사용할 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 키를 안전하게 저장할 수 있도록 기밀 클라이언트 애플리케이션 접근 방식을 사용하여 Azure Maps REST API에 액세스하는 것이 좋습니다.
형식:
apiKey
In(다음 안에):
query
SAS Token
공유 액세스 서명 토큰은 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해
이 토큰을 사용하면 모든 애플리케이션이 Azure 역할 기반 액세스 제어를 사용하여 액세스하고 특정 토큰에 사용할 만료, 속도 및 지역에 대한 세분화된 제어 권한을 부여받습니다. 즉, SAS 토큰을 사용하여 애플리케이션이 공유 키보다 더 보안이 유지되는 방식으로 액세스를 제어할 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 렌더링 남용을 제한하고 정기적으로 SAS 토큰을 갱신하도록 맵 계정 리소스 허용된 원본의 특정 목록을 구성하는 것이 좋습니다.
형식:
apiKey
In(다음 안에):
header
예제
Successful Copyright Caption Request
샘플 요청
GET https://atlas.microsoft.com/map/copyright/caption/json?api-version=1.0
샘플 응답
{
"formatVersion": "0.0.1",
"copyrightsCaption": "© 1992 - 2017 TomTom."
}
정의
| Name | Description |
|---|---|
|
Copyright |
이 개체는 성공적인 저작권 호출에서 반환됩니다. |
|
Error |
리소스 관리 오류 추가 정보입니다. |
|
Error |
오류 세부 정보입니다. |
|
Error |
오류 응답 |
|
Response |
원하는 응답 형식입니다. 값은 json 또는 xml 수 있습니다. |
CopyrightCaption
이 개체는 성공적인 저작권 호출에서 반환됩니다.
| Name | 형식 | Description |
|---|---|---|
| copyrightsCaption |
string |
Copyrights Caption 속성 |
| formatVersion |
string |
Format Version 속성 |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| info |
object |
추가 정보입니다. |
| type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
| Name | 형식 | Description |
|---|---|---|
| additionalInfo |
오류 추가 정보입니다. |
|
| code |
string |
오류 코드입니다. |
| details |
오류 세부 정보입니다. |
|
| message |
string |
오류 메시지입니다. |
| target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
| Name | 형식 | Description |
|---|---|---|
| error |
오류 개체입니다. |
ResponseFormat
원하는 응답 형식입니다. 값은 json 또는 xml 수 있습니다.
| 값 | Description |
|---|---|
| json | |
| xml |