를 확장합니다.
타일 오버레이는 기본 지도 타일 위에 표시되는 이미지 집합입니다. 이러한 타일은 투명하여 기존 지도에 지형지물을 추가할 수 있습니다. 타일 오버레이에는 다음과 같은 속성이 있습니다.
- 타일 제공자
TileProvider
는 타일 오버레이에 사용되는 이미지를 제공합니다. 타일 제공자를 지정해야 지도에 추가할 수 있습니다. 추가된 카드 제공자는 변경할 수 없습니다. 그러나 타일 제공자의 동작을 수정하여 특정 좌표에 다른 이미지를 반환할 수 있습니다. 카드 제공자가 제공한 타일이 변경되면 이전 타일이 더 이상 렌더링되지 않도록 나중에clearTileCache()
를 호출해야 합니다.- Z-색인
- 다른 오버레이 (
Marker
는 포함되지만GroundOverlay
,Circle
,Polyline
,Polygon
포함)와 관련하여 이 타일 오버레이가 그려지는 순서입니다. Z-색인 값이 큰 오버레이는 Z-색인 값이 작은 오버레이 위에 그려집니다. 동일한 Z-인덱스를 가진 오버레이의 순서는 무작위입니다. 기본 zIndex는 0입니다. - 투명성
[0..1]
범위에 있는 타일 오버레이의 투명도입니다. 여기서0
는 오버레이가 불투명함을 의미하고1
는 오버레이가 완전히 투명함을 의미합니다. 지정된 비트맵이 이미 부분적으로 투명한 경우 각 픽셀의 투명도가 적절하게 조정됩니다. 예를 들어 비트맵의 픽셀의 알파 값이 200이고 타일 오버레이의 투명도를 0.25로 지정하면 픽셀은 알파 값 150으로 화면에서 렌더링됩니다. 이 속성의 지정은 선택사항이며 기본 투명도는 0 (불투명)입니다.- 공개 상태
- 타일 오버레이가 표시되는지 여부(예: 지도에 그려지는지 여부)를
나타냅니다. 보이지 않는 타일 오버레이는 그려지지 않지만 다른 모든 속성은 유지합니다. 기본값은
true
, 즉 visible입니다.
기본 스레드에서 이 클래스의 메서드만 호출해야 합니다. 그렇지 않으면 IllegalStateException
이 발생합니다.
타일 좌표
세계는 메르카토르 투영법 (위키백과 참고)을 사용해 투영됩니다. 지도의 왼쪽 (서쪽)은 경도 -180도에 해당하고 지도의 오른쪽 (동쪽)은 경도 180도에 해당합니다. 지도를 정사각형으로 만들기 위해 지도의 상단 (북쪽)은 위도 85.0511도에 해당하고 지도의 하단 (남쪽)은 위도 -85.0511도에 해당합니다. 이 위도 범위 밖에 있는 영역은 렌더링되지 않습니다.
각 확대/축소 수준에서 지도는 타일로 나뉘며, 화면과 겹치는 타일만 다운로드되고 렌더링됩니다. 각 타일은 정사각형이며 지도는 다음과 같이 타일로 나뉩니다.
- 확대/축소 수준 0에서는 타일 한 개가 전 세계를 나타냅니다. 타일의 좌표는 (x, y) = (0, 0)입니다.
- 확대/축소 수준 1에서 세계는 2x2 그리드로 배열된 4개의 타일로 나뉩니다.
- ...
- 확대/축소 수준이 N일 때 세계는 2Nx2N 그리드로 배열된 4N개의 타일로 나뉩니다.
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 에서 모든 타일이 다시 요청되도록 카드 캐시를 지웁니다. |
boolean |
같음(기타 객체)
이
TileOverlay 가 다른 것과 같은지 테스트합니다. |
boolean |
getFadeIn()
오버레이 타일을 페이드 인할지 여부를 가져옵니다.
|
문자열 |
getId()
이 타일 오버레이의 ID를 가져옵니다.
|
float |
getTransparency()
이 타일 오버레이의 투명도를 가져옵니다.
|
float |
getZIndex()
이 타일 오버레이의 zIndex를 가져옵니다.
|
int |
hashCode()
|
boolean |
isVisible()
이 타일 오버레이의 가시성을 가져옵니다.
|
void |
remove()
지도에서 이 타일 오버레이를 제거합니다.
|
void |
setFadeIn(불리언 fadeIn)
오버레이 타일을 페이드 인할지 여부를 설정합니다.
|
void |
setTransparency(플로팅 투명도)
이 타일 오버레이의 투명도를 설정합니다.
|
void |
setVisible(불리언 표시)
이 타일 오버레이의 가시성을 설정합니다.
|
void |
setZIndex(부동 소수점 수 zIndex)
이 타일 오버레이의 zIndex를 설정합니다.
|
상속받은 메서드 요약
공개 메서드
public void clearTileCache ()
TileProvider
에서 모든 타일이 다시 요청되도록 카드 캐시를 지웁니다.
이 메서드를 호출하면 이 타일 오버레이의 현재 타일도 지도에서 지워집니다. API는 카드의 작은 메모리 내 캐시를 유지합니다. 타일을 더 오래 캐시하려면 디스크 상의 캐시를 구현해야 합니다.
공개 부울 같음 (기타 객체)
공개 불리언 getFadeIn ()
오버레이 타일을 페이드 인할지 여부를 가져옵니다.
반환 값
- 타일이 페이드 인하려면
true
, 그렇지 않으면false
입니다.
공개 문자열 getId ()
이 타일 오버레이의 ID를 가져옵니다.
public float getTransparency ()
이 타일 오버레이의 투명도를 가져옵니다.
반환 값
- 이 타일 오버레이의 투명도입니다.
public float getZIndex ()
이 타일 오버레이의 zIndex를 가져옵니다.
반환 값
- 타일 오버레이의 zIndex.
public int hashCode ()
공개 불리언 isVisible ()
이 타일 오버레이의 가시성을 가져옵니다. 이 메서드는 타일 오버레이가 실제로 화면의 표시 영역 내에 있는지 여부를 반환하지 않고 화면의 표시 영역에 포함된 경우 그려질지 여부를 반환합니다.
반환 값
- 이 타일 오버레이의 가시성
public void remove ()
지도에서 이 타일 오버레이를 제거합니다.
public void setFadeIn (boolean fadeIn)
오버레이 타일을 페이드 인할지 여부를 설정합니다.
매개변수
fadeIn | true : 타일 페이드 인, false : 즉시 렌더링
|
---|
public void setTransparency (플로팅 투명도)
이 타일 오버레이의 투명도를 설정합니다. 자세한 내용은 이 클래스 상단에 있는 문서를 참조하세요.
매개변수
투명성 | [0..1] 범위의 부동 소수점입니다. 여기서 0 는 타일 오버레이가
불투명임을 나타내고 1 은 타일 오버레이가 투명함을 의미합니다.
|
---|
public void setVisible (boolean visible)
이 타일 오버레이의 가시성을 설정합니다. 타일 오버레이가 표시되지 않으면 그리지 않지만 다른 모든 속성은 유지됩니다. 타일 오버레이는 기본적으로 표시됩니다.
매개변수
표시 | 이 오버레이를 표시하려면 true , 표시하지 않으려면 false
|
---|
public void setZIndex (float zIndex)
이 타일 오버레이의 zIndex를 설정합니다. 자세한 내용은 이 클래스 상단에 있는 문서를 참조하세요.
매개변수
zIndex | 이 타일 오버레이의 zIndex. |
---|