ServiceOptions interface
모든 atlas 서비스 요청에 사용되는 전역 속성입니다.
- Extends
속성
auth |
맵 컨트롤이 Azure Maps 서비스에서 인증하는 방법을 사용자 지정하는 데 사용되는 인증 옵션입니다. 이러한 인증 옵션을 지정하는 경우 ServiceOptions.subscriptionKey는 지정하지 않아야 합니다. 대신 atlas.setAuthenticationOptions 함수를 사용하는 것이 좋습니다. |
disable |
원격 분석 컬렉션 사용 안 함 이 옵션은 맵을 초기화할 때만 설정할 수 있습니다. default: false(Azure Government 클라우드의 경우 true) |
domain | 맵 타일 및 기타 Azure Maps 서비스를 요청할 때 사용할 도메인입니다.
프로토콜이 지정 |
enable |
접근성 기능을 사용하도록 설정하여 웹 애플리케이션을 시각화하는 데 어려움을 겪는 사용자에게 화면 읽기 프로그램 지원을 제공합니다. 이 속성은 기본적으로 true로 설정됩니다. |
enable |
벡터 데이터에서 위치를 추출하는 데 실패할 경우 위치 접근성을 검색하기 위해 REST API 지오코더로 대체를 사용하도록 설정합니다. 이 옵션을 사용하지 않도록 설정하면 지오코드 API 요청이 생성되지 않지만 화면 읽기 프로그램에 대한 위치 정보가 부족할 수 있습니다. default: true |
fade |
레이블 충돌에 대한 페이드 인/페이드 아웃 애니메이션의 기간을 밀리초 단위로 제어합니다. 이 설정은 모든 기호 계층에 영향을 줍니다. 이 설정은 런타임 스타일 전환 또는 래스터 타일 교차 페이딩 기간에 영향을 주지 않습니다. |
local |
'CJK 통합 이디오그래프', '히라가나', '가타카나' 및 '한글 음절' 범위에서 문자 모양 생성을 로컬로 재정의하기 위한 CSS 글꼴 패밀리를 정의합니다. 이러한 범위에서는 글꼴 두께 키워드(밝은/일반/보통/굵게)를 제외하고 지도 스타일에서 글꼴 설정이 무시됩니다. 이러한 문자 모양 범위에 대해 지도 스타일에서 글꼴 설정을 사용하도록 설정하려면 false로 설정합니다. 이 옵션의 목적은 대역폭 집약적 문자 모양 서버 요청을 방지하는 것입니다. |
map |
지도 구성은 지도에 사용할 수 있는 스타일 집합을 정의합니다. |
max |
병렬로 로드할 최대 이미지 수(래스터 타일, 스프라이트, 아이콘)는 래스터가 많은 맵의 성능에 영향을 줍니다. 기본적으로 16. |
refresh |
만료될 때 벡터 및 래스터 타일을 다시 로드해야 하는지 여부를 지정하는 부울입니다(만료 헤더 기준). 이는 자주 업데이트되는 데이터 집합에 유용합니다. false로 설정하면 각 타일은 필요할 때 한 번 로드되고 만료될 때 다시 로드되지 않습니다. default: true |
session |
요청과 함께 전달할 세션 ID입니다. 대신 atlas.setSessionId를 사용하는 것이 좋습니다. |
style |
스타일 및 스타일 집합을 요청할 때 사용되는 스타일 API 버전 |
style |
styleDefinitionsPath에서 스타일을 요청할 때 요청할 스타일 정의 버전입니다. |
subscription |
요청에 권한을 부여하는 데 사용되는 고객 구독 키입니다. 이 옵션은 맵을 초기화할 때만 설정할 수 있습니다. 대신 atlas.setSubscriptionKey 함수를 사용하는 것이 좋습니다. |
transform |
정의된 transformRequest가 호출되어 타일을 로드하기 위한 사용자 지정 요청 매개 변수를 제공합니다. |
validate |
True이면 적용되기 전에 스타일의 유효성을 검사합니다. 유효성 검사는 초기 로드 중에 스타일을 처리하는 데 상당한 시간(수백 밀리초)이 걸립니다. |
worker |
페이지에서 인스턴스화된 웹 작업자 수입니다. 기본적으로 CPU 코어 수의 절반으로 설정됩니다(6으로 제한됨). |
속성 세부 정보
authOptions
맵 컨트롤이 Azure Maps 서비스에서 인증하는 방법을 사용자 지정하는 데 사용되는 인증 옵션입니다. 이러한 인증 옵션을 지정하는 경우 ServiceOptions.subscriptionKey는 지정하지 않아야 합니다. 대신 atlas.setAuthenticationOptions 함수를 사용하는 것이 좋습니다.
authOptions?: AuthenticationOptions
속성 값
disableTelemetry
원격 분석 컬렉션 사용 안 함 이 옵션은 맵을 초기화할 때만 설정할 수 있습니다. default: false(Azure Government 클라우드의 경우 true)
disableTelemetry?: boolean
속성 값
boolean
domain
맵 타일 및 기타 Azure Maps 서비스를 요청할 때 사용할 도메인입니다.
프로토콜이 지정 https
되지 않은 경우 를 가정합니다.
대신 atlas.setDomain 함수를 사용하는 것이 좋습니다.
domain?: string
속성 값
string
enableAccessibility
접근성 기능을 사용하도록 설정하여 웹 애플리케이션을 시각화하는 데 어려움을 겪는 사용자에게 화면 읽기 프로그램 지원을 제공합니다. 이 속성은 기본적으로 true로 설정됩니다.
enableAccessibility?: boolean
속성 값
boolean
enableAccessibilityLocationFallback
벡터 데이터에서 위치를 추출하는 데 실패할 경우 위치 접근성을 검색하기 위해 REST API 지오코더로 대체를 사용하도록 설정합니다. 이 옵션을 사용하지 않도록 설정하면 지오코드 API 요청이 생성되지 않지만 화면 읽기 프로그램에 대한 위치 정보가 부족할 수 있습니다. default: true
enableAccessibilityLocationFallback?: boolean
속성 값
boolean
fadeDuration
레이블 충돌에 대한 페이드 인/페이드 아웃 애니메이션의 기간을 밀리초 단위로 제어합니다. 이 설정은 모든 기호 계층에 영향을 줍니다. 이 설정은 런타임 스타일 전환 또는 래스터 타일 교차 페이딩 기간에 영향을 주지 않습니다.
fadeDuration?: number
속성 값
number
localIdeographFontFamily
'CJK 통합 이디오그래프', '히라가나', '가타카나' 및 '한글 음절' 범위에서 문자 모양 생성을 로컬로 재정의하기 위한 CSS 글꼴 패밀리를 정의합니다. 이러한 범위에서는 글꼴 두께 키워드(밝은/일반/보통/굵게)를 제외하고 지도 스타일에서 글꼴 설정이 무시됩니다. 이러한 문자 모양 범위에 대해 지도 스타일에서 글꼴 설정을 사용하도록 설정하려면 false로 설정합니다. 이 옵션의 목적은 대역폭 집약적 문자 모양 서버 요청을 방지하는 것입니다.
localIdeographFontFamily?: string
속성 값
string
mapConfiguration
지도 구성은 지도에 사용할 수 있는 스타일 집합을 정의합니다.
mapConfiguration?: string | MapConfiguration
속성 값
string | MapConfiguration
maxParallelImageRequests
병렬로 로드할 최대 이미지 수(래스터 타일, 스프라이트, 아이콘)는 래스터가 많은 맵의 성능에 영향을 줍니다. 기본적으로 16.
maxParallelImageRequests?: number
속성 값
number
refreshExpiredTiles
만료될 때 벡터 및 래스터 타일을 다시 로드해야 하는지 여부를 지정하는 부울입니다(만료 헤더 기준). 이는 자주 업데이트되는 데이터 집합에 유용합니다. false로 설정하면 각 타일은 필요할 때 한 번 로드되고 만료될 때 다시 로드되지 않습니다. default: true
refreshExpiredTiles?: boolean
속성 값
boolean
sessionId
요청과 함께 전달할 세션 ID입니다. 대신 atlas.setSessionId를 사용하는 것이 좋습니다.
sessionId?: string
속성 값
string
styleAPIVersion
스타일 및 스타일 집합을 요청할 때 사용되는 스타일 API 버전
styleAPIVersion?: string
속성 값
string
styleDefinitionsVersion
styleDefinitionsPath에서 스타일을 요청할 때 요청할 스타일 정의 버전입니다.
styleDefinitionsVersion?: string
속성 값
string
subscriptionKey
요청에 권한을 부여하는 데 사용되는 고객 구독 키입니다. 이 옵션은 맵을 초기화할 때만 설정할 수 있습니다. 대신 atlas.setSubscriptionKey 함수를 사용하는 것이 좋습니다.
subscriptionKey?: string
속성 값
string
transformRequest
정의된 transformRequest가 호출되어 타일을 로드하기 위한 사용자 지정 요청 매개 변수를 제공합니다.
transformRequest?: (url: string, resourceType: ResourceType) => RequestParameters
속성 값
(url: string, resourceType: ResourceType) => RequestParameters
validateStyle
True이면 적용되기 전에 스타일의 유효성을 검사합니다. 유효성 검사는 초기 로드 중에 스타일을 처리하는 데 상당한 시간(수백 밀리초)이 걸립니다.
validateStyle?: boolean
속성 값
boolean
workerCount
페이지에서 인스턴스화된 웹 작업자 수입니다. 기본적으로 CPU 코어 수의 절반으로 설정됩니다(6으로 제한됨).
workerCount?: number
속성 값
number