다음을 통해 공유


ServiceOptions interface

모든 atlas 서비스 요청에 사용되는 전역 속성입니다.

Extends

속성

authOptions

맵 컨트롤이 Azure Maps 서비스에서 인증하는 방법을 사용자 지정하는 데 사용되는 인증 옵션입니다. 이러한 인증 옵션을 지정하는 경우 ServiceOptions.subscriptionKey는 지정하지 않아야 합니다. 대신 atlas.setAuthenticationOptions 함수를 사용하는 것이 좋습니다.

disableTelemetry

원격 분석 컬렉션 사용 안 함 이 옵션은 맵을 초기화할 때만 설정할 수 있습니다. default: false(Azure Government 클라우드의 경우 true)

domain

맵 타일 및 기타 Azure Maps 서비스를 요청할 때 사용할 도메인입니다. 프로토콜이 지정 https 되지 않은 경우 를 가정합니다. 대신 atlas.setDomain 함수를 사용하는 것이 좋습니다.

enableAccessibility

접근성 기능을 사용하도록 설정하여 웹 애플리케이션을 시각화하는 데 어려움을 겪는 사용자에게 화면 읽기 프로그램 지원을 제공합니다. 이 속성은 기본적으로 true로 설정됩니다.

enableAccessibilityLocationFallback

벡터 데이터에서 위치를 추출하는 데 실패할 경우 위치 접근성을 검색하기 위해 REST API 지오코더로 대체를 사용하도록 설정합니다. 이 옵션을 사용하지 않도록 설정하면 지오코드 API 요청이 생성되지 않지만 화면 읽기 프로그램에 대한 위치 정보가 부족할 수 있습니다. default: true

fadeDuration

레이블 충돌에 대한 페이드 인/페이드 아웃 애니메이션의 기간을 밀리초 단위로 제어합니다. 이 설정은 모든 기호 계층에 영향을 줍니다. 이 설정은 런타임 스타일 전환 또는 래스터 타일 교차 페이딩 기간에 영향을 주지 않습니다.

localIdeographFontFamily

'CJK 통합 이디오그래프', '히라가나', '가타카나' 및 '한글 음절' 범위에서 문자 모양 생성을 로컬로 재정의하기 위한 CSS 글꼴 패밀리를 정의합니다. 이러한 범위에서는 글꼴 두께 키워드(밝은/일반/보통/굵게)를 제외하고 지도 스타일에서 글꼴 설정이 무시됩니다. 이러한 문자 모양 범위에 대해 지도 스타일에서 글꼴 설정을 사용하도록 설정하려면 false로 설정합니다. 이 옵션의 목적은 대역폭 집약적 문자 모양 서버 요청을 방지하는 것입니다.

mapConfiguration

지도 구성은 지도에 사용할 수 있는 스타일 집합을 정의합니다.

maxParallelImageRequests

병렬로 로드할 최대 이미지 수(래스터 타일, 스프라이트, 아이콘)는 래스터가 많은 맵의 성능에 영향을 줍니다. 기본적으로 16.

refreshExpiredTiles

만료될 때 벡터 및 래스터 타일을 다시 로드해야 하는지 여부를 지정하는 부울입니다(만료 헤더 기준). 이는 자주 업데이트되는 데이터 집합에 유용합니다. false로 설정하면 각 타일은 필요할 때 한 번 로드되고 만료될 때 다시 로드되지 않습니다. default: true

sessionId

요청과 함께 전달할 세션 ID입니다. 대신 atlas.setSessionId를 사용하는 것이 좋습니다.

styleAPIVersion

스타일 및 스타일 집합을 요청할 때 사용되는 스타일 API 버전

styleDefinitionsVersion

styleDefinitionsPath에서 스타일을 요청할 때 요청할 스타일 정의 버전입니다.

subscriptionKey

요청에 권한을 부여하는 데 사용되는 고객 구독 키입니다. 이 옵션은 맵을 초기화할 때만 설정할 수 있습니다. 대신 atlas.setSubscriptionKey 함수를 사용하는 것이 좋습니다.

transformRequest

정의된 transformRequest가 호출되어 타일을 로드하기 위한 사용자 지정 요청 매개 변수를 제공합니다.

validateStyle

True이면 적용되기 전에 스타일의 유효성을 검사합니다. 유효성 검사는 초기 로드 중에 스타일을 처리하는 데 상당한 시간(수백 밀리초)이 걸립니다.

workerCount

페이지에서 인스턴스화된 웹 작업자 수입니다. 기본적으로 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