를 확장합니다.
타일 오버레이는 기본 지도 타일 위에 표시되는 이미지 집합입니다. 이 타일 가 투명하여 기존 지도에 지형지물을 추가할 수 있습니다. 타일 오버레이에는 다음 속성이 포함됩니다.
- 타일 제공자
TileProvider
는 타일 오버레이에 사용되는 이미지를 제공합니다. 다음을 수행해야 합니다. 는 지도에 추가하기 전에 타일 제공자를 지정해야 합니다. 타일 제공자는 추가된 후에는 변경됩니다. 하지만 타일 제공자의 동작을 수정하여 를 사용하여 특정 좌표에 대해 다른 이미지를 반환할 수 있습니다. 타일에서 제공한 타일이 나중에clearTileCache()
를 호출하여 이전 타일은 더 이상 렌더링되지 않습니다.- Z-색인
- 다른 오버레이(
GroundOverlay
,Circle
,Polyline
,Polygon
(포함되지 않음)Marker
)을 입력합니다. Z-색인이 큰 오버레이는 작은 크기의 오버레이 위에 그려집니다. z-색인입니다. 동일한 Z-인덱스를 가진 오버레이의 순서는 무작위입니다. 기본 zIndex: 0. - 투명성
[0..1]
범위에 있는 타일 오버레이의 투명도입니다. 여기서0
는 오버레이는 불투명하고1
는 오버레이가 완전히 투명함을 의미합니다. 지정된 비트맵이 이미 부분적으로 투명하면 각 픽셀의 투명도는 예를 들어 비트맵의 픽셀의 알파 값이 200이고 타일 오버레이의 투명도를 0.25로 지정하면 픽셀이 알파 값이 150인 화면). 이 속성의 사양은 선택사항이며 기본 투명도는 0 (불투명)입니다.- 공개 상태
- 타일 오버레이의 표시 여부를 나타냅니다(예: 타일 오버레이가
있습니다. 보이지 않는 타일 오버레이는 그려지지 않지만, 다른 속성은 모두 유지합니다. 이
기본값은
true
, 즉 표시됩니다.
기본 스레드에서 이 클래스의 메서드만 호출해야 합니다. 그렇지 않을 경우
IllegalStateException
타일 좌표
세계는 왼쪽 (서쪽)을 포함하는 메르카토르 투영법 (위키백과 참조)을 사용하여 투영됩니다. 경도 -180도에 해당하는 지도의 오른쪽 (동쪽) 경도 180도에 해당합니다. 지도를 정사각형으로 만들려면 지도의 상단 (북쪽)을 지도는 위도 85.0511도에 해당하며 지도의 하단 (남쪽)에 해당합니다. -85.0511도까지 설정할 수 있습니다. 이 위도 범위를 벗어난 지역은 렌더링되지 않습니다.
각 확대/축소 수준에서 지도는 타일로 나뉘며 화면에 겹치는 타일만 표시됩니다. 다운로드 및 렌더링됩니다 각 타일은 정사각형이며 지도는 다음과 같은 타일로 나뉩니다.
- 확대/축소 수준 0에서는 타일 한 개가 전 세계를 나타냅니다. 해당 타일의 좌표는 (x, y) = (0, 0)으로 계산됩니다.
- 확대/축소 수준 1에서 세계는 2x2 그리드로 정렬된 4개의 타일로 나뉩니다.
- ...
- 확대/축소 수준 N에서 세계는 2N으로 정렬된 4N개의 타일로 나뉩니다. x 2N 그리드.
GoogleMap.getMinZoomLevel
및
최대 확대/축소 수준은 GoogleMap.getMaxZoomLevel
입니다.
타일의 좌표는 지도의 왼쪽 상단 (북서쪽)으로부터 측정됩니다. 위치
확대/축소 수준 N, 타일 좌표의 x
값 범위는 0~2N - 1이며
서쪽에서 동쪽으로 증가하고 y
값 범위는 0에서 2N - 1 사이이며
북쪽에서 남쪽으로 증가할 것입니다.
예
GoogleMap map; // ... get a map.
TileProvider tileProvider; // ... create a tile provider.
TileOverlay tileOverlay = map.addTileOverlay(
new TileOverlayOptions().tileProvider(tileProvider));
공개 메서드 요약
void |
clearTileCache()
모든 타일이
TileProvider 에서 다시 요청되도록 카드 캐시를 지웁니다. |
부울 |
같음(기타 객체)
이
TileOverlay 가 다른 TileOverlay 와 같은지 테스트합니다. |
부울 |
getFadeIn()
오버레이 타일의 페이드 인 여부를 가져옵니다.
|
문자열 |
getId()
이 타일 오버레이의 ID를 가져옵니다.
|
float |
getTransparency()
이 타일 오버레이의 투명도를 가져옵니다.
|
float |
getZIndex()
이 타일 오버레이의 zIndex를 가져옵니다.
|
int |
hashCode()
|
부울 |
isVisible()
이 타일 오버레이의 가시성을 가져옵니다.
|
void |
remove()
지도에서 이 타일 오버레이를 삭제합니다.
|
void |
setFadeIn(boolean fadeIn)
오버레이 타일의 페이드 인 여부를 설정합니다.
|
void |
setTransparency(플로팅 투명도)
이 타일 오버레이의 투명도를 설정합니다.
|
void |
setVisible(boolean visible)
이 타일 오버레이의 가시성을 설정합니다.
|
void |
setZIndex(부동 소수점 수 zIndex)
타일 오버레이의 zIndex를 설정합니다.
|
상속받은 메서드 요약
공개 메서드
<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. clearTileCache ()
모든 타일이 TileProvider
에서 다시 요청되도록 카드 캐시를 지웁니다.
이 타일 오버레이의 현재 타일도
메서드를 사용하여 축소하도록 요청합니다. API는 카드의 작은 인메모리 캐시를 유지합니다. 다음에 대한 타일을 캐시하려는 경우
디스크 상의 캐시를 구현해야 합니다.
<ph type="x-smartling-placeholder"></ph> 공개 불리언 를 통해 개인정보처리방침을 정의할 수 있습니다. 같음 (객체 기타)
이 TileOverlay
가 다른 TileOverlay
와 같은지 테스트합니다.
매개변수
기타 | Object |
---|
반환 값
- 두 객체가 동일한 객체라면 true, 즉 이 == other입니다.
<ph type="x-smartling-placeholder"></ph> 공개 불리언 를 통해 개인정보처리방침을 정의할 수 있습니다. getFadeIn ()
오버레이 타일의 페이드 인 여부를 가져옵니다.
반환 값
- 타일이 페이드 인되는 경우
true
, 그렇지 않은 경우false
입니다.
<ph type="x-smartling-placeholder"></ph> 공개 문자열 를 통해 개인정보처리방침을 정의할 수 있습니다. getId ()
이 타일 오버레이의 ID를 가져옵니다.
<ph type="x-smartling-placeholder"></ph> 공개 부동 소수점 수 를 통해 개인정보처리방침을 정의할 수 있습니다. getTransparency ()
이 타일 오버레이의 투명도를 가져옵니다.
반환 값
- 이 타일 오버레이의 투명도를 나타냅니다.
<ph type="x-smartling-placeholder"></ph> 공개 부동 소수점 수 를 통해 개인정보처리방침을 정의할 수 있습니다. getZIndex ()
이 타일 오버레이의 zIndex를 가져옵니다.
반환 값
- 타일 오버레이의 zIndex입니다.
<ph type="x-smartling-placeholder"></ph> 공개 정수 를 통해 개인정보처리방침을 정의할 수 있습니다. hashCode ()
<ph type="x-smartling-placeholder"></ph> 공개 불리언 를 통해 개인정보처리방침을 정의할 수 있습니다. isVisible ()
이 타일 오버레이의 가시성을 가져옵니다. 이 메서드는 타일의 오버레이는 실제로 화면의 표시 영역 내에 있으며, 표시 영역 내에 있는 경우 이미지 및 동영상 광고입니다.
반환 값
- 이 타일 오버레이의 가시성을 설정할 수 있습니다.
<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. 삭제 ()
지도에서 이 타일 오버레이를 삭제합니다.
<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setFadeIn (불리언 페이드인)
오버레이 타일의 페이드 인 여부를 설정합니다.
매개변수
fadeIn | true : 타일 페이드 인 false : 즉시 렌더링합니다.
|
---|
<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setTransparency (플로팅 투명도)
이 타일 오버레이의 투명도를 설정합니다. 자세한 내용은 이 클래스 상단에 있는 문서를 참조하세요. 자세히 알아보세요.
매개변수
투명도 | [0..1] 범위의 부동 소수점 수로, 0 은 타일을
오버레이는 불투명하고 1 는 타일 오버레이가 투명함을 의미합니다.
|
---|
<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setVisible (불리언 표시)
이 타일 오버레이의 가시성을 설정합니다. 타일 오버레이가 표시되지 않으면 그려지지 않지만 다른 모든 속성을 유지합니다. 타일 오버레이는 기본적으로 표시됩니다.
매개변수
표시 | true : 이 오버레이를 표시합니다. false 하여 보이지 않게 만듭니다.
|
---|
<ph type="x-smartling-placeholder"></ph> 공개 무효 를 통해 개인정보처리방침을 정의할 수 있습니다. setZIndex (부동 소수점 수 zIndex)
타일 오버레이의 zIndex를 설정합니다. 자세한 내용은 이 클래스 상단에 있는 문서를 참조하세요. 확인할 수 있습니다
매개변수
zIndex | 타일 오버레이의 zIndex입니다. |
---|