TileOverlay

타일 오버레이는 기본 지도 타일 위에 표시되는 이미지 집합입니다. 이러한 타일은 투명하여 기존 지도에 지형지물을 추가할 수 있습니다. 타일 오버레이에는 다음과 같은 속성이 있습니다.

타일 제공자

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일 때 세계는 2^Nx2^N 그리드로 배열된 4^N개의 타일로 나뉩니다.

카메라가 지원하는 최소 확대/축소 수준 (다양한 요인에 따라 다를 수 있음)은 GoogleMap.getMinZoomLevel이고 최대 확대/축소 수준은 GoogleMap.getMaxZoomLevel입니다.

타일의 좌표는 지도의 왼쪽 상단 (북서쪽) 모서리를 기준으로 측정됩니다. 확대/축소 수준 N에서 타일 좌표의 x 값은 0에서 2^N - 1까지 증가하고 서쪽에서 동쪽으로 갈수록 증가하고 y 값은 0에서 2^N - 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를 설정합니다.

상속받은 메서드 요약

java.lang.Object 클래스에서 상속됨

boolean	equals(객체 arg0)
최종 Class<?>	getClass()
int	hashCode()
최종 void	notify()
최종 void	notifyAll()
문자열	toString()
최종 void	wait(long arg0, int arg1)
최종 void	wait(long arg0)
최종 void	wait()