PlayMapView
Description
지도데이터를 화면에표시하는 메인클래스입니다.
Constructors
PlayMapView(Context context)
PlayMapView(Context context, AttributeSet attrs)
PlayMapView(Context context, AttributeSet attrs, int defStyle)
Example
PlayMapView mapView = new PlayMapView(this);
mapView = findViewById(R.id.mapView);
mapView.onCreate(savedInstanceState);
mapView.initMap(37.56640, 126,97851, 17);Methods
void setAppkey(String key, final OnApiKeyListenerCallback listener)Description
발급받은 앱키를 인증하여 성공 시 PlayMapView 를 초기화합니다.
Parameters
| Name {Type} | Description |
|---|---|
| key{String} | 발급받은 App Key |
| listener{OnApiKeyListenerCallback} | App Key 인증 결과를 받을 콜백 인터페이스 |
Example
mapView.setAppkey("APPKEY", new PlayMapView.OnApiKeyListenerCallback() {
@Override
public void onApiKeySucceed() {
MainActivity.this.runOnUiThread(new Runnable() {
@Override
public void run() {
//맵뷰 초기화
mapViewCreate();
}
});
}
@Override
public void onApiKeyFailed(String errorMsg) {
Log.e("[PlayMap Activity]", "Map Loading Failed !!! " + errorMsg);
}
});
void setInitMapAngle(double degree)Description
지도 초기화 시 지도 각도 세팅 API
Parameters
| Name {Type} | Description |
|---|---|
| degree{double} | 초기화 시 세팅할 지도 각도 |
Example
public void setInitMapDegree(double degree){
mapView.setInitMapAngle(degree);
}
Remark
getInitMapAngle() : 지도 초기화 시 지도 각도 리턴
Bitmap generateBitmap(@NonNull View view)Description
view -> Bitmap 변환
Parameters
| Name {Type} | Description |
|---|---|
| view{View} | 변환할 view |
Example
public void sample(){
ConstraintLayout btnLayoutL = (ConstraintLayout) View.inflate(this, R.layout.layout_btn_left, null);
Bitmap bitmapL = mapView.generateBitmap(btnLayoutL);
}
Bitmap generateBitmap(int drawableRes)Description
drawable resource -> Bitmap 변환
Parameters
| Name {Type} | Description |
|---|---|
| drawableRes{int} | 변환할 drawable resource id |
Example
public void sample(){
markerItem.setMarkerIcon(mapView.generateBitmap(R.drawable.gps_sample));
}
Interface OnMapInitCallbackDescription
지도 초기화 후 호출되며 지도 레벨 및 중심좌표가 파라미터로전달되는 인터페이스를정의합니다.
Parameters
Example
public class MapActivity extends Activity implements OnMapInitCallback{
@Override
public void onMapInitEvent(int zoom, PlayMapPoint playMapPoint) {
}
}void OnMapInitListener(OnMapInitCallbacklistener)Description
지도 초기화 후호출되는 인터페이스 함수추가
Parameters
| Name {Type} | Description |
|---|---|
| listener{OnMapInitCallback} | 지도초기화 후 호출될 Interface |
Example
mapView.onMapInitListener(new PlayMapView.OnMapInitCallback() {
@Override
public void onMapInitEvent(int zoom, PlayMapPoint playMapPoint) {
}
});void onMapInitEvent (int zoom, PlayMapPointplayMapPoint)Description
지도 초기화 후호출되며 지도 레벨 및 중심좌표가 파라미터로전달합니다.
Parameters
| Name {Type} | Description |
|---|---|
| zoom{int} | 지도 레벨 |
| playMapPoint{PlayMapPoint} | 중심 좌표 |
Example
mapView.onMapInitListener(new PlayMapView.OnMapInitCallback() {
@Override
public void onMapInitEvent (int zoom, PlayMapPoint playMapPoint) {
}
});
Interface OnZoomLevelChangeCallbackDescription
지도 레벨 변경 시호출되며 변경된 지도레벨이 파라미터로전달되는 인터페이스를정의합니다.
Parameters
Example
public class MapActivity extends Activity implements OnZoomLevelChangeCallback{
@Override
public void onZoomLevelChangeEvent (int zoom) {
}
}
void onZoomLevelChangeListener(OnZoomLevelChangeCallback listener)Description
지도 레벨 변경 시호출되는 인터페이스 함수추가
Parameters
| Name {Type} | Description |
|---|---|
| listener{OnZoomLevelChangeCallback} | 호출될 Interface |
Example
mapView.onZoomLevelChangeListener(new PlayMapView.OnZoomLevelChangeCallback() {
@Override
public void onZoomLevelChangeEvent (int zoom) {
}
});
void onZoomLevelChangeEvent (int zoom)Description
지도 레벨 변경 시호출되며 변경된 지도레벨이 파라미터로전달합니다.
Parameters
| Name {Type} | Description |
|---|---|
| zoom{int} | 지도 레벨 |
Example
mapView.onZoomLevelChangeListener(new PlayMapView.OnZoomLevelChangeCallback() {
@Override
public void onZoomLevelChangeEvent (int zoom) {
}
});
interface OnMapCenterChangeCallbackDescription
지도 위치 변경 시호출되며 변경된 지도좌표를 파라미터로전달되는 인터페이스를정의합니다.
Parameters
Example
public class MapActivity extends Activity implements OnMapCenterChangeCallback{
@Override
public void onMapCenterChangeEvent (PlayMapPoint playMapPoint) {
}
}
void onMapCenterChangeListener(OnMapCenterChangeCallback listener)Description
지도 위치 변경 시호출되는 인터페이스 함수추가
Parameters
| Name {Type} | Description |
|---|---|
| listener{OnMapCenterChangeCallback} | 호출될 Interface |
Example
mapView.onMapCenterChangeListener(new PlayMapView.OnMapCenterChangeCallback(){
@Override
public void onMapCenterChangeEvent(PlayMapPoint playMapPoint) {
}
});
void onMapCenterChangeEvent(PlayMapPointplayMapPoint)Description
지도 위치 변경 시호출되며 변경된 지도좌표를 파라미터로전달합니다.
Parameters
| Name {Type} | Description |
|---|---|
| playMapPoint{PlayMapPoint} | 중심좌표 |
Example
mapView. onMapCenterChangeListener (new PlayMapView.OnMapCenterChangeCallback() {
@Override
public void onMapCenterChangeEvent(PlayMapPoint playMapPoint) {
}
});
interface OnMapScrollCallbackDescription
지도 위에서 스크롤이벤트 발생시 호출되는인터페이스를 정의합니다.
Parameters
Example
public class MapActivity extends Activity implements OnMapScrollCallback{
@Override
public void onMapScrollEvent(MotionEvent e1, MotionEvent e2) {
}
}
void onMapScrollListener(OnMapScrollCallback listener)Description
지도 위에서 스크롤이벤트 발생시 호출되는인터페이스 함수 추가
Parameters
| Name {Type} | Description |
|---|---|
| listener{OnMapScrollCallback} | 호출될 Interface |
Example
mapView.onMapScrollListener(new PlayMapView.onMapScrollListener(){
@Override
public void onMapScrollEvent(MotionEvent e1, MotionEvent e2) {
}
});
void onMapScrollEvent(MotionEvent e1,MotionEvent e2)Description
지도 위에서 스크롤이벤트 발생시 호출되며모션이벤트를 파라미터로전달합니다.
Parameters
| Name {Type} | Description |
|---|---|
| e1{MotionEvent} | 모션1 |
| e2{MotionEvent} | 모션2 |
Example
mapView.onMapScrollListener (new PlayMapView.OnMapSingleTapUpCallback() {
@Override
public void onMapSingleTapUpEvent(MotionEvent event, PlayMapPoint playMapPoint) {
}
});
interface OnMapSingleTapUpCallbackDescription
지도 위에서 탭 이벤트발생시 호출되는인터페이스를 정의합니다.
Parameters
Example
public class MapActivity extends Activity implements OnMapSingleTapUpCallback{
@Override
public void onMapSingleTapUpEvent(MotionEvent event, PlayMapPoint playMapPoint) {
}
}
void onMapSingleTapUpListener(OnMapSingleTapUpCallback listener)Description
지도 위에서 탭 이벤트발생시 호출되는인터페이스 함수 추가
Parameters
| Name {Type} | Description |
|---|---|
| listener{OnMapSingleTapUpCallback} | 호출될 Interface |
Example
mapView.onMapSingleTapUpListener(new PlayMapView.OnMapCenterChangeCallback(){
@Override
public void onMapSingleTapUpEvent (MotionEvent event, PlayMapPoint playMapPoint) {
}
});
void onMapSingleTapUpEvent (MotionEventevent, PlayMapPoint playMapPoint)Description
지도 위에서 탭 이벤트발생시 호출되며모션이벤트와위경도좌표를 파라미터로전달합니다.
Parameters
| Name {Type} | Description |
|---|---|
| event{MotionEvent} | 모션이벤트 |
| playMapPoint{PlayMapPoint} | 위경도좌표 |
Example
mapView.onMapSingleTapUpListener (new PlayMapView.OnMapSingleTapUpCallback() {
@Override
public void onMapSingleTapUpEvent (MotionEvent event, PlayMapPoint playMapPoint) {
}
});
interface OnMapDoubleTapUpCallbackDescription
지도 위에서 더블탭이벤트 발생시 호출되는인터페이스를 정의합니다.
Parameters
Example
public class MapActivity extends Activity implements OnMapDoubleTapUpCallback{
@Override
public void onMapDoubleTapUpEvent(MotionEvent event, PlayMapPoint playMapPoint) {
}
}
void onMapDoubleTapUpListener(OnMapDoubleTapUpCallback listener)Description
지도 위에서 더블탭이벤트 발생시 호출되는인터페이스 함수 추가
Parameters
| Name {Type} | Description |
|---|---|
| listener{OnMapDoubleTapUpCallback} | 호출될 Interface |
Example
mapView.onMapDoubleTapUpListener(new PlayMapView.OnMapDoubleTapUpCallback(){
@Override
public void onMapDoubleTapUpEvent(MotionEvent event, PlayMapPoint playMapPoint) {
}
});
void onMapDoubleTapUpEvent (MotionEventevent, PlayMapPoint playMapPoint)Description
지도 위에서 더블탭이벤트 발생시 호출되며모션이벤트와위경도좌표를 파라미터로전달합니다.
Parameters
| Name {Type} | Description |
|---|---|
| event{MotionEvent} | 모션이벤트 |
| playMapPoint{PlayMapPoint} | 위경도좌표 |
Example
mapView.onMapDoubleTapUpListener (new PlayMapView.OnMapDoubleTapUpCallback() {
@Override
public void onMapDoubleTapUpEvent (MotionEvent event, PlayMapPoint playMapPoint) {
}
});
interface OnMapTouchDownCallbackDescription
지도 위에서 터치 다운이벤트 발생시 호출되는인터페이스를 정의합니다.
Parameters
Example
public class MapActivity extends Activity implements OnMapTouchDownCallback{
@Override
public void onMapTouchDownEvent(MotionEvent event, ArrayList <PlayMapMarker> markerList) {
}
}
void onMapTouchDownListener(OnMapTouchDownCallback listener)Description
지도 위에서 터치 다운이벤트 발생시 호출되는인터페이스 함수 추가
Parameters
| Name {Type} | Description |
|---|---|
| listener{OnMapTouchDownCallback} | 호출될 Interface |
Example
mapView.onMapTouchDownListener(new PlayMapView.OnMapTouchDownCallback(){
@Override
public void onMapTouchDownEvent(MotionEvent event, ArrayList<PlayMapMarker> markerList) {
}
});
void onMapTouchDownEvent(MotionEvent event,ArrayList<PlayMapMarker> markerList)Description
지도 위에서 터치 다운이벤트 발생시 호출되며모션이벤트와 주변 마커의배열을 파라미터로전달합니다.
Parameters
| Name {Type} | Description |
|---|---|
| event{MotionEvent} | 모션이벤트 |
| markerList{ArrayList<PlayMapMarker>} | 마커의 배열 |
Example
mapView.onMapTouchDownListener (new PlayMapView.OnMapTouchDownCallback() {
@Override
public void onMapTouchDownEvent (MotionEvent event, ArrayList<PlayMapMarker> markerList) {
}
});
interface OnMapTouchUpCallbackDescription
지도 위에서 터치 업이벤트 발생시 호출되는인터페이스를 정의합니다.
Parameters
Example
public class MapActivity extends Activity implements OnMapTouchUpCallback{
@Override
public void onMapTouchUpEvent(MotionEvent event, ArrayList<PlayMapMarker> markerList) {
}
}
void onMapTouchUpListener(OnMapTouchUpCallback listener)Description
지도 위에서 터치 업이벤트 발생시 호출되는인터페이스 함수 추가
Parameters
| Name {Type} | Description |
|---|---|
| listener{OnMapTouchUpCallback} | 호출될 Interface |
Example
mapView.onMapTouchUpListener(new PlayMapView.OnMapTouchUpCallback(){
@Override
public void onMapTouchUpEvent(MotionEvent event, ArrayList<PlayMapMarker> markerList) {
}
});
void onMapTouchUpEvent(MotionEvent event,ArrayList<PlayMapMarker> markerList)Description
지도 위에서 터치 업이벤트 발생시 호출되며모션이벤트와 주변 마커의배열을 파라미터로전달합니다.
Parameters
| Name {Type} | Description |
|---|---|
| event{MotionEvent} | 모션이벤트 |
| markerList{ArrayList<PlayMapMarker>} | 마커의 배열 |
Example
mapView.onMapTouchUpListener(new PlayMapView.OnMapTouchUpCallback() {
@Override
public void onMapTouchUpEvent (MotionEvent event, ArrayList<PlayMapMarker> markerList) {
}
});
interface OnMapLongPressCallbackDescription
지도 위에서 터치 후일정 시간이 경과하면호출되는 인터페이스를정의합니다.
Parameters
Example
public class MapActivity extends Activity implements OnMapLongPressCallback{
@Override
public void onMapLongPressEvent(PlayMapPoint playMapPoint) {
}
}
void onMapLongPressListener(OnMapLongPressCallback listener)Description
지도 위에서 터치 후일정 시간이 경과하면호출되는 인터페이스 함수추가
Parameters
| Name {Type} | Description |
|---|---|
| listener{OnMapLongPressCallback} | 호출될 Interface |
Example
mapView.onMapLongPressListener(new PlayMapView.OnMapLongPressCallback(){
@Override
public void onMapLongPressEvent(PlayMapPoint playMapPoint) {
}
});
void onMapLongPressEvent(PlayMapPointplayMapPoint)Description
지도 위에서 터치 후일정 시간이 경과하면호출되며 터치한 곳의위경도 좌표를 파라미터로전달합니다.
Parameters
| Name {Type} | Description |
|---|---|
| playMapPoint{PlayMapPoint} | 위경도 좌표 |
Example
mapView.onMapLongPressListener(new PlayMapView.OnMapLongPressCallback() {
@Override
public void onMapLongPressEvent (PlayMapPoint playMapPoint) {
}
});
interface OnMapSnapshotImageCallbackDescription
지도 화면을 캡처하면호출되는 인터페이스를정의합니다.
Parameters
Example
public class MapActivity extends Activity implements OnMapSnapshotImageCallback{
@Override
public void onMapSnapshotImage(Bitmap bitmap) {
}
}
void onMapSnapshotImageListener(OnMapSnapshotImageCallback listener)Description
지도 화면을 캡처하면호출되는 인터페이스 함수추가
Parameters
| Name {Type} | Description |
|---|---|
| listener{OnMapSnapshotImageCallback} | 호출될 Interface |
Example
mapView.onMapSnapshotImageListener(new PlayMapView.OnMapSnapshotImageCallback(){
@Override
public void onMapSnapshotImage(Bitmap bitmap) {
}
});
void onMapSnapshotImage(Bitmapbitmap)Description
지도 화면을 캡처하면호출되며 캡처한 Bitmap이미지를 파라미터로전달합니다.
Parameters
| Name {Type} | Description |
|---|---|
| bitmap{Bitmap} | 캡처한 이미지 |
Example
mapView.onMapSnapshotImageListener(new PlayMapView.OnMapSnapshotImageCallback() {
@Override
public void onMapSnapshotImage (Bitmap bitmap) {
}
});
void onMarkerLongPressListener(OnMarkerLongPressCallback listener)Description
마커 위에서 터치 후 일정 시간이 경과하면 호출되는 인터페이스
Parameters
| Name {Type} | Description |
|---|---|
| listener{OnMarkerLongPressCallback} | 마커 롱탭 시 콜백리스너 |
Example
mapView.onMarkerLongPressListener(new PlayMapView.OnMarkerLongPressCallback() {
@Override
public void onMarkerLongPressEvent(PlayMapPoint playMapPoint) {
eventTextView.setText(String.format(getString(R.string.marker_long_tap),
playMapPoint.getLongitude(), playMapPoint.getLatitude()));
}
});
void setMarkerLongClickEvent(boolean enableMode)Description
marker long click 시 마커아이콘 move 여부 세팅
Parameters
| Name {Type} | Description |
|---|---|
| enableMode{boolean} | 마커 move 여부 |
Example
public void sample(){
mapView.setMarkerLongClickEvent(true);
}
interface OnInfoWindowClickCallbackDescription
인포윈도우 클릭 시호출되는 인터페이스를정의합니다.
Parameters
Example
public class MapActivity extends Activity implements OnInfoWindowClickCallback{
@Override
public void onInfoWindowClickEvent(PlayMapMarker item) {
}
}
void onInfoWindowClickListner(OnInfoWindowClickCallback listener)Description
인포윈도우 클릭 시호출되는 인터페이스 함수추가
Parameters
| Name {Type} | Description |
|---|---|
| listener{OnInfoWindowClickCallback} | 호출될 Interface |
Example
mapView.onInfoWindowClickListner(new PlayMapView.OnInfoWindowClickCallback(){
@Override
public void onInfoWindowClickEvent(PlayMapMarker item) {
}
});
void onInfoWindowClickEvent(PlayMapMarker item)Description
인포윈도우 클릭 시호출되며 클릭한 곳의마커를 파라미터로전달합니다.
Parameters
| Name {Type} | Description |
|---|---|
| item{PlayMapMarker} | 인포윈도우를 클릭한 곳의 마커 |
Example
mapView.onInfoWindowClickListner(new PlayMapView.OnInfoWindowClickCallback() {
@Override
public void onInfoWindowClickEvent (PlayMapMarker item) {
}
});
void initMap()Description
지도를 초기화 합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.initMap ();
void initMap(final double latitude, final doublelongitude)Description
지도를 초기화 합니다.
Parameters
| Name {Type} | Description |
|---|---|
| Latitude{double} | 위도 |
| Longitude{double} | 경도 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.initMap (37.56640, 126.97851);
void initMap(final double latitude, final doublelongitude , final int zoom)Description
지도를 초기화 합니다.
Parameters
| Name {Type} | Description |
|---|---|
| Latitude{double} | 위도 |
| Longitude{double} | 경도 |
| zoom{int} | 줌 레벨 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.initMap (37.56640, 126.97851, 17);
void removeAllMapOption()Description
MapView 에 추가된 모든 아이템 제거
- groundImage, circle, clusterMarker, label, markerItem, polygon, polyLine, rectangle,customLayer
Example
public void sample(){
mapView.removeAllMapOption();
}
void setMapType (final PlayMapcontrol.MapType nType)Description
MapType을 변경합니다. (1 : image, 2 :vector)
Parameters
| Name {Type} | Description |
|---|---|
| nType{PlayMapcontrol.MapType} | 맵 타입 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setMapType (1);
void setMapRotate(boolean enabled)Description
지도 회전 설정을변경합니다.
Parameters
| Name {Type} | Description |
|---|---|
| enabled{boolean} | 회전 상태 변경. |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setMapRotate (true);
void setMapRotateAngle(double degree)Description
지도를 전달된 각도로회전 합니다.
Parameters
| Name {Type} | Description |
|---|---|
| degree{double} | 각도 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setMapRotateAngle (180);
void setMapCenterPoint (PlayMapPointplayMapPoint, int durationMs)Description
지도의 중심 좌표를설정 합니다.
Parameters
| Name {Type} | Description |
|---|---|
| playMapPoint{PlayMapPoint} | 지도의 중심좌표 |
| durationMs{int} | 이동시 속도 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setMapCenterPoint(new PlayMapPoint(37.570841, 126.985302), 1000);
void setMapCenterPoint (PlayMapPointplayMapPoint, int zoom, int durationMs)Description
지도의 중심 좌표 및축척 레벨을 설정 합니다.
Parameters
| Name {Type} | Description |
|---|---|
| playMapPoint{PlayMapPoint} | 지도의 중심좌표 |
| zoom{int} | 줌 레벨 |
| durationMs{int} | 이동시 속도 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setMapCenterPoint (new PlayMapPoint(37.570841, 126.985302),18, 1000);
void setMapLocationCenterPoint (intdurationMs)Description
지도의 중심 좌표를현재 위치로 설정 합니다.
Parameters
| Name {Type} | Description |
|---|---|
| durationMs{int} | 이동시 속도 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setMapLocationCenterPoint (1000);
void setMapCenterPointByMeter(PlayMapPoint playMapPoint, int meter, int durationMs)Description
지도의 중심 좌표 및직경( meter )를 설정 합니다.
Parameters
| Name {Type} | Description |
|---|---|
| playMapPoint{PlayMapPoint} | 지도의 중심좌표 |
| meter{int} | 직경(meter) |
| durationMs{int} | 이동시 속도 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setMapCenterPointByMeter(new PlayMapPoint(37.570841, 126.985302),100.1000);
void setMapBounds (double left, double top, doubleright, double bottom, int durationMs, int padding)Description
화면에 보이는 지도영역을 설정 합니다.
Parameters
| Name {Type} | Description |
|---|---|
| left{double} | 최소 위도 |
| top{double} | 최소 경도 |
| right{double} | 최소 위도 |
| bottom{double} | 최소 경도 |
| durationMs{int} | 이동시 속도 |
| padding{int} | 지도와의 거리 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setMapBounds(126.98358535766643, 37.56010548702511, 127.01733398437541, 37.5666097518793, 1000);
void setMapBounds(double left, double top, double right, double bottom, int durationMs,PlayMapPaddings paddings)Description
현재 지도의 영역과 상하좌우 여백을 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| left{double} | 최소 위도 |
| top{double} | 최소 경도 |
| right{double} | 최소 위도 |
| bottom{double} | 최소 경도 |
| durationMs{int} | 이동시 속도 |
| padding{int} | 지도와의 거리 |
Example
//상하좌우 padding 각각 설정한 영역 객체 생성
PlayMapPaddings paddings = new PlayMapPaddings(80,30,80,10);
//해당 영역으로 이동
mapView.setMapBounds(minLon, maxLat, maxLon, minLat, 500, paddings);
void setMapBounds(List<PlayMapPoint> locationList, int durationMs, PlayMapPaddingspaddings)Description
화면에 보이는 지도 영역 설정
Parameters
| Name {Type} | Description |
|---|---|
| locationList{List<PlayMapPoint>} | PlayMapPoint List |
| durationMs{int} | Map Move Animation Duration |
| paddings{PlayMapPaddings} | 지도와의 거리 (4 면 각각의 거리) |
Example
mapView.setMapBounds(list, 100, new PlayMapPaddings(padding, padding, padding, padding));
void setMapBounds(List<PlayMapPoint> locationList, int durationMs, int padding)Description
화면에 보이는 지도 영역 설정
Parameters
| Name {Type} | Description |
|---|---|
| locationList{List<PlayMapPoint>} | PlayMapPoint List |
| durationMs{int} | Map Move Animation Duration |
| paddings{PlayMapPaddings} | 지도와의 거리 (4 면 각각의 거리) |
Example
mapView.setMapBounds(list, 100, 0);
void setZoomEnabled (boolean enabled)Description
지도의 확대/축소 가능여부를 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| enabled{boolean} | 확대/축소 가능 여부 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setZoomEnabled(true);
boolean setZoom (int zoom)Description
지도 축적 레벨을 변수값으로 받아 성공여부를반환합니다(6보다 크거나같고 18보다 작거나 같은 값).
Parameters
| Name {Type} | Description |
|---|---|
| zoom{int} | 축적 레벨 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setZoom(18);
void setPanEnabled (boolean enabled)Description
지도 패닝 가능 여부를설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| enabled{boolean} | 가능 여부 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setPanEnabled(true);
void setSightModeForTracking (booleanenabled)Description
시야표출 모드를설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| enabled{boolean} | 가능 여부 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setSightModeForTracking(true);
void setTrackingMode (boolean enabled)Description
Tracking 모드를 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| enabled{boolean} | 가능 여부 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setTrackingMode(true);
void setTrackingCircle (int radius, intareaColor)Description
현위치 마커를중심으로 그릴 원의 반경과색상을 지정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| radius{int} | 원의 반경 |
| areaColor{int} | 원의 색상 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setTrackingCircle(50,0);
void setCompassMode (boolean Enable)Description
나침반 모드를설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| enabled{boolean} | 가능 여부 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setCompassMode(true);
boolean getCompassMode ()Description
나침반 모드를 반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getCompassMode();
void setZoomControllerEnable (booleanenable)Description
줌 컨트롤러 사용여부를 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| enabled{boolean} | 가능 여부 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setZoomControllerEnable(true);
boolean getZoomControllerEnable()Description
줌 컨트롤 설정 여부를반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getZoomControllerEnable();
void setDistanceMode (final boolean enabled)Description
거리 재기 모드 사용여부를 설정합니다.
Parameters
enabled Example
PlayMapView mapView = new PlayMapView(this);
mapview.setDistanceMode(true);
void setMeasuresMode (final boolean enabled)Description
면적 재기 모드 사용여부를 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| enabled{boolean} | 가능 여부 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setMeasuresMode(true);
void setIcon (Bitmap icon)Description
현재 위치로 표시될아이콘을 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| icon{Bitmap} | 이미지 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setIcon(BitmapFactory.decodeResource(getResources(), R.drawable.ic_end));
void setIconVisibility (Boolean visibility)Description
현재 위치로 표시될아이콘을 표시할지 여부를설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| visibility{Boolean} | 표시 여부 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setIconVisibility(true);
void setLocationPoint (PlayMapPointplayMapPoint)Description
현재 위치로 표시될좌표를 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| playMapPoint{PlayMapPoint} | 위경도 좌표 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setLocationPoint(new PlayMapPoint(37.570841, 126.985302));
void setLogoPosition (int horizontalMargin, intveriticalMargin, PlayMapControl.MapControlPosition nPosition)Description
로고 이미지의 위치를설정합니다.( MapControlPosition(LEFTTOP,RIGHTTOP,LEFTBOTTOM,RIGHTBOTTOM) )
Parameters
| Name {Type} | Description |
|---|---|
| horizontalMargin{int} | 로고 외부와의 수평 간격 |
| veriticalMargin{int} | 로고 외부와의 수직 간격 |
| nPosition{PlayMapControl.MapControlPosition} | MapControlPosition (LEFTTOP,RIGHTTOP,LEFTBOTTOM,RIGHTBOTTOM) |
Example
PlayMapView mapView = new PlayMapView(this);
mapView.setLogoPosition(10, 10, PlayMapControl.MapControlPosition.RIGHTTOP);
void setScaleBarPosition (inthorizontalMargin, int veriticalMargin, PlayMapControl.MapControlPosition nPosition)Description
스케일바 이미지의위치를 설정합니다.( MapControlPosition(NONE,LEFTTOP,RIGHTTOP,LEFTBOTTOM,RIGHTBOTTOM) )
Parameters
| Name {Type} | Description |
|---|---|
| horizontalMargin{int} | 로고 외부와의 수평 간격 |
| veriticalMargin{int} | 로고 외부와의 수직 간격 |
| nPosition{PlayMapControl.MapControlPosition} | MapControlPosition (LEFTTOP,RIGHTTOP,LEFTBOTTOM,RIGHTBOTTOM) |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setScaleBarPosition(10, 10, PlayMapControl.MapControlPosition.RIGHTTOP);
void setCompassPosition (inthorizontalMargin, int veriticalMargin, PlayMapControl.MapControlPosition nPosition)Description
나침반 이미지의위치를 설정합니다.( MapControlPosition(NONE,LEFTTOP,RIGHTTOP,LEFTBOTTOM,RIGHTBOTTOM) )
Parameters
| Name {Type} | Description |
|---|---|
| horizontalMargin{int} | 로고 외부와의 수평 간격 |
| veriticalMargin{int} | 로고 외부와의 수직 간격 |
| nPosition{PlayMapControl.MapControlPosition} | MapControlPosition (LEFTTOP,RIGHTTOP,LEFTBOTTOM,RIGHTBOTTOM) |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setCompassPosition(10, 10, PlayMapControl.MapControlPosition.RIGHTTOP);
void setMapTraffic (boolean enabled)Description
교통정보 사용 여부를설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| enabled{boolean} | 가능 여부 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setMapTraffic(true);
PlayMapPoint getMapCenterPoint ()Description
현재 화면의 중심좌표를 반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getMapCenterPoint();
double getMapCenterLatitude ()Description
현재 화면의 중심 위도좌표를 반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getMapCenterLatitude();
double getMapCenterLongitude ()Description
현재 화면의 중심 경도좌표를 반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getMapCenterLongitude();
int getZoomLevel ()Description
현재 화면의 지도 축척레벨을 반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getZoomLevel();
boolean canZoomIn ()Description
현재 지도의 축척레벨에서 확대가 가능한지여부를 반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.canZoomIn();
boolean canZoomOut ()Description
현재 지도의 축척레벨에서 축소가 가능한지여부를 반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.canZoomOut();
boolean zoomIn ()Description
지도 축척 레벨을 한단계 확대하며 성공 여부를반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.zoomIn();
boolean zoomOut ()Description
지도 축척 레벨을 한단계 축소하며 성공 여부를반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.zoomOut();
int getMaxZoomLevel ()Description
최대 지도 축척 레벨을반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getMaxZoomLevel();
int getMinZoomLevel ()Description
최소 지도 축척 레벨을반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getMinZoomLevel();
PlayMapPoint getPointFromPixel (PointF pixel)Description
화면 좌표(pixel)에해당하는 지도 좌표를반환합니다.
Parameters
| Name {Type} | Description |
|---|---|
| pixel{PointF} | 픽셀 좌표 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getPointFromPixel(new PointF(10, 10));
PointF getPointToPixel (PlayMapPointplayMapPoint)Description
지도 좌표에 해당하는화면 좌표(pixel)를 반환합니다.
Parameters
| Name {Type} | Description |
|---|---|
| playMapPoint{PlayMapPoint} | 지도 좌표 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getPointToPixel(new PlayMapPoint(37.570841, 126.985302));
boolean isMapRotateEnabled ()Description
지도의 회전 가능여부를 반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.isMapRotateEnabled();
double getMapRotateAngle ()Description
지도가 회전된 각도를반환합니다. (지도가 회전기능이 활성화된상태에서만 유효)
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getMapRotateAngle();
float getPixelByMeter (int meter)Description
미터(meter)값을 픽셀로반환합니다.
Parameters
| Name {Type} | Description |
|---|---|
| meter{int} | 미터 값(meter) |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getPixelByMeter(100);
PlayMapPoint getLocationPoint ()Description
현재 위치로 표시된좌표를 반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getLocationPoint();
boolean getIsTrackingMode ()Description
현재 트레킹 모드를반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getIsTrackingMode();
void getTrafficData ()Description
교통정보 데이터를반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getTrafficData();
void drawTrafficLayer ()Description
교통정보를 지도에그립니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.drawTrafficLayer();
void addPolyLine (final String id, finalPlayMapPolyLine polyLine)Description
지도위에 폴리라인을추가합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 추가할 id |
| polyLine{PlayMapPolyLine} | 추가할 PolyLine |
Example
PlayMapView mapView = new PlayMapView(this);
PlayMapPolyLine polyLine = new PlayMapPolyLine();
String strId = String.format("line%d", mLineID++);
mapview.addPolyLine(strId, polyLine);
void removePolyLine (final String id)Description
지도위에 폴리라인을삭제합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 추가할 id |
Example
PlayMapView mapView = new PlayMapView(this);
String strId = String.format("line%d", mLineID++);
mapview.addPolyLine(strId);
void removeAllPolyLine ()Description
지도위에 모든폴리라인을 삭제합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.removeAllPolyLine();
void fitPolyLine ()Description
지도위에 모든폴리라인의 위치만큼화면을 조정합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.fitPolyLine();
void addPolygon (final String id, finalPlayMapPolygon polygon)Description
지도위에 폴리곤을추가합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 추가할 id |
| polygon{PlayMapPolygon} | 추가할 Polygon |
Example
PlayMapView mapView = new PlayMapView(this);
PlayMapPolygon polygon = new PlayMapPolygon();
String strId = String.format("line%d", mLineID++);
mapview.addPolygon(strId, polygon);
void removePolygon (final String id)Description
지도위에 폴리곤을삭제합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 추가할 id |
Example
PlayMapView mapView = new PlayMapView(this);
String strId = String.format("line%d", mLineID++);
mapview.removePolygon(strId);
void removeAllPolygon ()Description
지도위에 모든폴리곤을 삭제합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.removeAllPolygon();
void fitPolygon ()Description
지도위에 모든폴리곤의 위치만큼 화면을조정합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.fitPolygon();
void addRectangle (final String id, finalPlayMapPolygon rectangle)Description
지도위에 사각형을추가합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 추가할 id |
| rectangle{PlayMapPolygon} | 추가할 사각형 |
Example
PlayMapView mapView = new PlayMapView(this);
PlayMapPolygon rectangle = new PlayMapPolygon();
String strId = String.format("line%d", mLineID++);
mapview.addRectangle(strId, rectangle);
void removeRectangle (final String id)Description
지도위에 사각형을삭제합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 추가할 id |
Example
PlayMapView mapView = new PlayMapView(this);
String strId = String.format("line%d", mLineID++);
mapview.removeRectangle(strId);
void removeAllRectangle ()Description
지도위에 모든사각형을 삭제합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.removeAllRectangle();
void fitRectangle ()Description
지도위에 모든사각형의 위치만큼 화면을조정합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.fitRectangle();
void addCircle (final String id, final PlayMapCirclecircle)Description
지도위에 원형을추가합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 추가할 id |
| circle{PlayMapCircle} | 추가할 원형 |
Example
PlayMapView mapView = new PlayMapView(this);
PlayMapCircle circle = new PlayMapCircle();
String strId = String.format("line%d", mLineID++);
mapview.addCircle(strId, circle);
void removeCircle (final String id)Description
지도위에 서클을삭제합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 추가할 id |
Example
PlayMapView mapView = new PlayMapView(this);
String strId = String.format("line%d", mLineID++);
mapview.removeCircle(strId);
void removeAllCircle()Description
지도위에 모든 서클을삭제합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.removeAllCircle();
void fitCircle()Description
지도위에 모든 서클의위치만큼 화면을조정합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.fitCircle();
void addMarkerItem (final String id, finalPlayMapMarker markerItem)Description
지도위에 마커를추가합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 추가할 id |
| markerItem{PlayMapMarker} | 추가할 마커 |
Example
PlayMapView mapView = new PlayMapView(this);
PlayMapMarker markerItem = new PlayMapMarker();
String strId = String.format("line%d", mLineID++);
mapview.addMarkerItem(strId, markerItem);
void addMarkerItem(final PlayMapMarker markerItem)Description
지도 위에 마커 추가
Parameters
| Name {Type} | Description |
|---|---|
| markerItem{PlayMapMarker} | 추가할 마커 아이템 |
Example
mapView.addMarkerItem(markerItem);
void addMarkerItemList(final List<PlayMapMarker> markerItemList)Description
지도 위에 마커 리스트 추가
Parameters
| Name {Type} | Description |
|---|---|
| markerItemList{List<PlayMapMarker>} | 추가할 마커 아이템 List |
Example
List<PlayMapMarker> ll = new ArrayList<>();
ll.add(markerItem1);
ll.add(markerItem2);
ll.add(markerItem3);
ll.add(markerItem4);
mapView.addMarkerItemList(ll);
void removeMarkerItem (final String id)Description
지도위에 마커를삭제합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 삭제할 id |
Example
PlayMapView mapView = new PlayMapView(this);
String strId = String.format("line%d", mLineID++);
mapview.removeMarkerItem(strId);
void removeAllMarkerItem ()Description
지도위에 모든 마커을삭제합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.removeAllMarkerItem();
void fitMarker ()Description
지도위에 모든 마커의위치만큼 화면을조정합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.fitMarker();
void addClusterMarker (final String id, finalMarkerCluster clustermarkerItem)Description
지도위에 클러스터마커를 추가합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 삭제할 id |
| clustermarkerItem{MarkerCluster} | 추가할 클러스터 마커 |
Example
PlayMapView mapView = new PlayMapView(this);
MarkerCluster clustermarkerItem = new MarkerCluster();
String strId = String.format("line%d", mLineID++);
mapview.addClusterMarker(strId, clustermarkerItem);
void removeClusterMarker (final String id)Description
지도위에 클러스터마커를 삭제합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 삭제할 id |
Example
PlayMapView mapView = new PlayMapView(this);
String strId = String.format("line%d", mLineID++);
mapview.removeClusterMarker(strId);
void removeAllClusterMarker ()Description
지도위에 모든클러스터 마커를삭제합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.removeAllClusterMarker();
void addLabel (final String id, final PlayMapTextlabel)Description
지도위에 라벨을추가합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 삭제할 id |
| label{PlayMapText} | 추가할 라벨 |
Example
PlayMapView mapView = new PlayMapView(this);
PlayMapText label = new PlayMapText();
String strId = String.format("line%d", mLineID++);
mapview.addLabel(strId, label);
void removeLabel (final String id)Description
지도위에 라벨을삭제합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 삭제할 id |
Example
PlayMapView mapView = new PlayMapView(this);
String strId = String.format("line%d", mLineID++);
mapview.removeLabel(strId);
void removeAllLabel ()Description
지도위에 모든 라벨을삭제합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.removeAllLabel();
void fitLabel ()Description
지도위에 모든 라벨의위치만큼 화면을조정합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.fitLabel();
void addGroundImageLayer(final String id, final PlayMapGroundImage groundImage)Description
지도 위에 이미지 Layer 추가 API
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 추가할 이미지 id |
| groundImage{PlayMapGroundImage} | 추가할 PlayMapGroundImage 객체 |
Example
public void addGroundImage() {
String id = "custom" + mCustomImg++;
Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.hy);
if (mBitmap != null)
bitmap = mBitmap;
int width = bitmap.getWidth();
int height = bitmap.getHeight();
PointF centerPixel = mapView.getPointToPixel(mapView.getMapCenterPoint());
PointF p1 = new PointF(centerPixel.x - (width / 2), centerPixel.y - (height / 2));
PointF p2 = new PointF(centerPixel.x + (width / 2), centerPixel.y - (height / 2));
PointF p3 = new PointF(centerPixel.x + (width / 2), centerPixel.y + (height / 2));
PointF p4 = new PointF(centerPixel.x - (width / 2), centerPixel.y + (height / 2));
PlayMapPoint bp1 = mapView.getPointFromPixel(p1);
PlayMapPoint bp2 = mapView.getPointFromPixel(p2);
PlayMapPoint bp3 = mapView.getPointFromPixel(p3);
PlayMapPoint bp4 = mapView.getPointFromPixel(p4);
mapView.addGroundImageLayer(id, new PlayMapGroundImage(id,bp1,bp2,bp3,bp3,bitmap));
}
void removeGroundImage (final Stringid)Description
지도위에 이미지를삭제합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 추가할 이미지 id |
Example
PlayMapView mapView = new PlayMapView(this);
String strId = String.format("line%d", mLineID++);
mapview.removeGroundImage(strId);
void removeAllGroundImage ()Description
지도위에 모든이미지를 삭제합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.removeAllGroundImage();
Bitmap getSnapShotImage ()Description
지도 화면 캡처이미지를 반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getSnapShotImage();
void getSnapShotImage(finalOnMapSnapshotImageCallback onMapSnapshotImageListener)Description
지도 화면 캡처 후 콜백함수를 호출합니다.
Parameters
| Name {Type} | Description |
|---|---|
| onMapSnapshotImageListener{OnMapSnapshotImageCallback} | 호출될 Interface |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getSnapShotImage(new PlayMapView.OnMapSnapshotImageCallback() {
@Override
public void onMapSnapshotImage(Bitmap bitmap) {
}
});
void setClusterEnable (boolean enable)Description
지도위에 클러스터링사용 여부를 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| enable{boolean} | 사용 여부 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setClusterEnable(true);
boolean getClusterEnable ()Description
지도위에 클러스터링사용 여부를 반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getClusterEnable();
void setminClusterRadius (floatradius)Description
최소 클러스터사이즈를 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| radius{float} | 반지름 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setminClusterRadius(50f);
float getminClusterRadius ()Description
최소 클러스터사이즈를 반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getminClusterRadius();
void setMaxClusterLevel (int ClusterLevel)Description
클러스터가 적용될레벨을 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| ClusterLevel{int} | 적용할 줌 레벨 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setMaxClusterLevel(18);
int getMaxClusterLevel ()Description
클러스터가 적용될레벨을 반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getMaxClusterLevel();
void setClusterTextColor (int TextColor)Description
클러스터의 텍스트색상을 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| TextColor{int} | 지정할 텍스트 컬러 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setMaxClusterLevel(Color.BLUE);
int getClusterTextColor ()Description
클러스터의 텍스트색상을 반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getClusterTextColor();
void setClusterTextSize (intTextSize)Description
클러스터의 텍스트크기를 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| TextSize{int} | 지정할 텍스트 크기 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setClusterTextSize(15);
int getClusterTextSize ()Description
클러스터의 텍스트크기를 반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getClusterTextSize();
void setClusterOffset (float x, floaty)Description
클러스터의 offset을설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| x{float} | x의 좌표 |
| y{float} | y의 좌표 |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.setClusterOffset(10f, 10f);
Float[] getClusterOffset ()Description
클러스터의 offset을반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getClusterOffset();
void setClusterImage (Bitmap bitmap)Description
클러스터의 표출이미지를 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| bitmap{Bitmap} | 지정할 이미지 |
Example
PlayMapView mapView = new PlayMapView(this);
Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.hy);
mapview.setClusterImage(bitmap);
Bitmap getClusterImage ()Description
클러스터의 표출이미지를 반환합니다.
Parameters
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getClusterImage();
PlayMapPolyLine getPolyLine (String id)Description
id값으로 해당폴리라인을 반환합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 조회할 id |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getPolyLine(“polyLine”);
PlayMapPolygon getPolygon(String id)Description
id값으로 해당 폴리곤을반환합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 조회할 id |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getPolygon(“polygon”);
PlayMapCircle getCircle(String id)Description
id 값으로 서클 개체 조회
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 조회할 Circle 객체 id |
Example
public void sample(){
PlayMapView mapView = new PlayMapView(this);
mapView.getPolygon("polygonid");
}
PlayMapMarker getMarkerItem (String id)Description
id값으로 해당 마커를반환합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 조회할 id |
Example
PlayMapView mapView = new PlayMapView(this);
mapview.getMarkerItem(“marker”);
void addCustomLayer(final String id, final Bitmap bitmap, final PlayMapPoint centerPoint,final Float[] offset)Description
지도 위에 Custom Layer 추가
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 추가할 Layer id |
| bitmap{Bitmap} | 추가할 Layer 의 이미지 객체 |
| centerPoint{PlayMapPoint} | 추가할 Layer 의 경도/위도 값을 저장한 객체 |
| offset{Float[]} | 추가할 Layer offset |
Example
public void drawBtnLayer (PlayMapPoint playMapPoint) {
//remove bton layer
mapView.removeCustomLayer("btnLeft");
mapView.removeCustomLayer("btnRight");
LayoutInflater inflater = (LayoutInflater)
this.getSystemService(Context.LAYOUT_INFLATER_SERVICE);
//left layout
ConstraintLayout btnLayoutL = (ConstraintLayout) View.inflate(this, R.layout.layout_btn_left, null);
Bitmap bitmapL = mapView.generateBitmap(btnLayoutL);
Float[] offsetL = {-50f, -8f};
//right layout
ConstraintLayout btnLayoutR = (ConstraintLayout) View.inflate(this, R.layout.layout_btn_right, null);
Bitmap bitmapR = mapView.generateBitmap(btnLayoutR);
Float[] offsetR = {50f, -8f};
//add bton layer
mapView.addCustomLayer("btnLeft", bitmapL, playMapPoint, offsetL);
mapView.addCustomLayer("btnRight", bitmapR, playMapPoint, offsetR);
}
public void removeCustomLayer(final String id)Description
지도 위에 Custom Layer 삭제
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 삭제할 Layer id |
Example
public void sample(){
mapView.removeCustomLayer("btnLeft");
mapView.removeCustomLayer("btnRight");
}
void removeAllCustomLayer()Description
지도 위의 모든 CustomLayer 삭제
Example
public void sample(){
removeAllCustomLayer();
}
void onCustomLayerClickListner(OnCustomLayerClickCallback listner)Description
Custom Layer 클릭 시 호출되는 리스너
Parameters
| Name {Type} | Description |
|---|---|
| listner{OnCustomLayerClickCallback} | Custom Layer 클릭 시 호출되는 콜백 인터페이스 |
Example
public void sample(){
mapView.onCustomLayerClickListner(new PlayMapView.OnCustomLayerClickCallback() {
@Override
public void onCustomLayerClickEvent(String id) {
Toast.makeText(getBaseContext(), "customLayer Click \nfrom Marker Id : " + id,
Toast.LENGTH_LONG).show();
}
});
}
void setMapBlackTheme(boolean enabled)Description
지도 타일 블랙 테마 설정 변경
Parameters
| Name {Type} | Description |
|---|---|
| enabled{boolean} | true : black 테마, false : milk 테마 |
Example
public void sample(){
mapView.setMapBlackTheme(false);
}
void setLocationBtnPosition(int horizontalMargin, int veriticalMargin,PlayMapControl.MapControlPosition nPosition)Description
현재위치 버튼 위치 조정
Parameters
| Name {Type} | Description |
|---|---|
| horizontalMargin{int} | horizontalMargin |
| veriticalMargin{int} | veriticalMargin |
| nPosition{PlayMapControl.MapControlPosition} |
MapControlPosition (NONE,LEFTTOP,RIGHTTOP,LEFTBOTTOM,RIGHTBOTTOM) |
Example
PlayMapView mapView = new PlayMapView(this);
mapView.setLocationBtnPosition(20,20,PlayMapControl.MapControlPosition.LEFTBOTTOM);
public void setLocationBtnEnable(boolean enable)Description
현재위치 버튼 enable/disable 설정
Parameters
| Name {Type} | Description |
|---|---|
| enable{boolean} | Enable 여부 |
Example
mapView.setLocationBtnEnable(true);
public void onLocationBtnClickListener(OnLocationBtnClickCallback listener)Description
현재위치 버튼 클릭시 호출
Parameters
| Name {Type} | Description |
|---|---|
| listener{OnLocationBtnClickCallback} | OnLocationBtnClickCallback listener |
Example
mapView.onLocationBtnClickListener(new PlayMapView.OnLocationBtnClickCallback() {
@Override
public void onLocationBtnClickEvent(View v) {
Toast.makeText(getApplicationContext(), "현재 위치로 이동 버튼 클릭 !!",
Toast.LENGTH_SHORT).show();
}
});
public void setZoomControllerPosition(int horizontalMargin, int veriticalMargin,PlayMapControl.MapControlPosition nPosition)Description
Zoom controller 버튼 위치 조정
Parameters
| Name {Type} | Description |
|---|---|
| horizontalMargin{int} | horizontalMargin |
| veriticalMargin{int} | veriticalMargin |
| nPosition{PlayMapControl.MapControlPosition} | MapControlPosition (NONE,LEFTTOP,RIGHTTOP,LEFTBOTTOM,RIGHTBOTTOM) |
Example
PlayMapView mapView = new PlayMapView(this);
mapView.setZoomControllerPosition(20,20,PlayMapControl.MapControlPosition.LEFTBOTTOM);
PlayMapPoint
Description
위경, 경도 좌표를 나타내는클래스 입니다.
Constructors
PlayMapPoint(double latitude, double longitude)
Example
PlayMapPoint mapPoint = new PlayMapPoint (37.570841, 126.985302);Methods
double getLatitude ()Description
위도 값을 반환합니다.
Parameters
Example
PlayMapPoint mapPoint = new PlayMapPoint(37.570841, 126.985302);
mapPoint.getLatitude();double getLongitude ()Description
경도 값을 반환합니다.
Parameters
Example
PlayMapPoint mapPoint = new PlayMapPoint(37.570841, 126.985302);
mapPoint.getLongitude();void setLatitude (double latitude)Description
위도 값을 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| latitude{double} | 위도 |
Example
PlayMapPoint mapPoint = new PlayMapPoint(37.570841, 126.985302);
mapPoint.setLatitude(37.570841);void setLongitude (double longitude)Description
경도 값을 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| longitude{double} | 경도 |
Example
PlayMapPoint mapPoint = new PlayMapPoint(37.570841, 126.985302);
mapPoint.setLongitude(126.985302);
PlayMapMarker
Description
지도 마커를 표시하기 위한클래스 입니다.
Constructors
PlayMapMarker()
Example
PlayMapMarker markerItem = new PlayMapMarker();
PlayMapPoint point = mapview.getMapCenterPoint();
markerItem.setMapPoint(point);
markerItem.setCalloutTitle("제목");
markerItem.setCalloutSubTitle("내용");
markerItem.setCanShowCallout(true);
markerItem.setAutoCalloutVisible(true);
String strId = String.format("marker_%d", mCircleID++);
mapview.addMarkerItem(strId, markerItem);
Methods
public void setMarkerZindex(int zindex)Description
마커의 z-index 설정
Parameters
| Name {Type} | Description |
|---|---|
| zindex{int} | 높을 수록 상위에 위치 (기본값 : 0) |
Example
markerItem.setMarkerZindex(3);
Remark
getMarkerZindex() : 마커의 z-Index 리턴
void setPosition (String position)Description
마커의 anchor point를설정합니다. ( position : left, right, top, bottom, top-left,top-right, bottom-left, bottom-right )
Parameters
| Name {Type} | Description |
|---|---|
| position{String} | 설정할 position |
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.setPosition(“left”);
String getPosition ()Description
마커의 anchor point를반환합니다.
Parameters
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.getPosition();
float getPositionX ()Description
마커의 anchor point의 X를반환합니다.
Parameters
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.getPositionX();
float getPositionY ()Description
마커의 anchor point의 Y를반환합니다.
Parameters
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.getPositionY();
void setId (String id)Description
마커의 id를 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 설정할 id |
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.setId(“marker”);
String getId ()Description
마커의 id를 반환합니다.
Parameters
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.getId();
void setIcon (final Bitmap bitmap)Description
마커의 아이콘이미지를 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| bitmap{Bitmap} | 설정할 이미지 |
Example
PlayMapMarker markerItem = new PlayMapMarker();
Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.hy);
markerItem.setIcon(bitmap);
Bitmap getIcon ()Description
마커의 아이콘이미지를 반환합니다.
Parameters
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.getIcon();
void setMapPoint (PlayMapPoint point)Description
마커의 좌표를설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| point{PlayMapPoint} | 설정할 위경도 좌표 |
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.setMapPoint(new PlayMapPoint(37.570841, 126.985302));
PlayMapPoint getMapPoint ()Description
마커의 좌표를반환합니다.
Parameters
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.getMapPoint();
void setName (String name)Description
마커의 이름을설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| name{String} | 설정할 이름 |
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.setName(“marker1”);
String getName ()Description
마커의 이름을반환합니다.
Parameters
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.getName();
void setVisible (final boolean visible)Description
마커의 표출 여부를설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| visible{boolean} | 표출 여부 |
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.setVisible(true);
boolean getVisible ()Description
마커의 표출 여부를반환합니다.
Parameters
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.getVisible();
void setCalloutTitle (String title)Description
풍선뷰의 title을설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| title{String} | 설정할 title |
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.setCalloutTitle(“title1”);
String getCalloutTitle ()Description
풍선뷰의 title을반환합니다.
Parameters
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.getCalloutTitle();
void setCalloutSubTitle (String subTitle)Description
풍선뷰의 subtitle을설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| subTitle{String} | 부제목 |
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.setCalloutSubTitle(“subtitle”);
String getCalloutSubTitle ()Description
풍선뷰의 subtitle을반환합니다.
Parameters
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.getCalloutSubTitle();
void setCanShowCallout (booleanbShow)Description
풍선뷰의 표출 여부를설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| bShow{boolean} | 표출 여부 |
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.setCanShowCallout(ture);
boolean getCanShowCallout ()Description
풍선뷰의 표출 여부를반환합니다.
Parameters
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.getCanShowCallout();
void setCalloutLeftButtonImage(Bitmap bitmap)Description
풍선뷰의 왼쪽에표시될 이미지를설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| bitmap{Bitmap} | 표출될 이미지 |
Example
PlayMapMarker markerItem = new PlayMapMarker();
Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.hy);
markerItem.setCalloutLeftButtonImage(bitmap);
Bitmap getCalloutLeftButtonImage ()Description
풍선뷰의 왼쪽에표시될 이미지를반환합니다.
Parameters
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.getCalloutLeftButtonImage();
void setCalloutRightButtonImage(Bitmap bitmap)Description
풍선뷰의 오른쪽에표시될 이미지를설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| bitmap{Bitmap} | 표출될 이미지 |
Example
PlayMapMarker markerItem = new PlayMapMarker();
Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.hy);
markerItem.setCalloutRightButtonImage(bitmap);
Bitmap getCalloutRightButtonImage()Description
풍선뷰의 오른쪽에표시될 이미지를반환합니다.
Parameters
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.getCalloutRightButtonImage();
void setAutoCalloutVisible (booleanvisible)Description
풍선뷰의 자동 표출여부를 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| visible{boolean} | 표출 여부 |
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.setAutoCalloutVisible(true);
Bitmap getAutoCalloutVisible ()Description
풍선뷰의 자동 표출여부를 반환합니다.
Parameters
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.getAutoCalloutVisible();
void setRect (Rect rect)Description
마커의 영역을설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| rect{Rect} | 설정할 영역 |
Example
PlayMapMarker markerItem = new PlayMapMarker();
Rect rect = new Rect();
markerItem.setRect(rect);
Rect getRect ()Description
마커의 영역을반환합니다.
Parameters
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.getRect();
void setCalloutRect (Rect calloutRect)Description
풍선뷰의 영역을설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| calloutRect{Rect} | 설정할 영역 |
Example
PlayMapMarker markerItem = new PlayMapMarker();
Rect rect = new Rect();
markerItem.setCalloutRect(rect);
Rect getCalloutRect ()Description
풍선뷰의 영역을반환합니다.
Parameters
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.getCalloutRect();
void setCalloutRightRect (Rectrect)Description
풍선뷰의 오른쪽영역을 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| rect{Rect} | 설정할 영역 |
Example
PlayMapMarker markerItem = new PlayMapMarker();
Rect rect = new Rect();
markerItem.setCalloutRightRect(rect);
Rect getCalloutRightRect ()Description
풍선뷰의 오른쪽영역을 반환합니다.
Parameters
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.getCalloutRightRect();
void setCalloutBitmap(Bitmap bitmap)Description
풍선뷰의 배경이미지를 설정한다.
배경이미지 설정 시 setCalloutBackgroundColor()는 null 로 설정하거나 기본값으로 두어야한다.
Parameters
| Name {Type} | Description |
|---|---|
| bitmap{Bitmap} | 설정할 이미지 비트맵 |
Example
public void sample(){
markerItem.setCalloutBitmap(mapView.generateBitmap(R.drawable.info_bg));
}
void setCalloutArrowVisible(boolean visible)Description
풍선뷰의 배경이미지 아랫부분 화살모양 표시 유무를 설정한다. (Default : true)
Parameters
| Name {Type} | Description |
|---|---|
| visible{boolean} | 표시 유무 |
Example
public void sample(){
markerItem.setCalloutArrowVisible(false);
}
void setCalloutArrowColor(String calloutArrowColor)Description
풍선뷰의 아래 화살 이미지 색상 설정 (Default : #555555)
Parameters
| Name {Type} | Description |
|---|---|
| calloutArrowColor{String} | 설정할 색상 |
Example
public void sample(){
markerItem.setCalloutArrowVisible(true);
markerItem.setCalloutArrowColor("#FFFFFF");
}
void setCalloutBottomMargin(int margin)Description
풍선뷰의 Bottom Margin 을 세팅한다. (Default : 0)
Parameters
| Name {Type} | Description |
|---|---|
| margin{int} | 0 이상의 pixel 값 |
Example
public void sample(){
markerItem.setCalloutBottomMargin(80);
}
void setCalloutTitleViewHorizontalMargin(int pixel)Description
풍선뷰 텍스트필드의 양 옆 마진을 설정한다. (Default : 0)
Parameters
| Name {Type} | Description |
|---|---|
| margin{int} | 0 이상의 pixel 값 |
Example
public void sample(){
markerItem.setCalloutTitleViewHorizontalMargin(30);
}
boolean isCalloutLeftClicked() / public boolean isCalloutRightClicked()Description
풍선뷰의 왼쪽/오른쪽 이미지가 클릭되었는지 가져온다
Example
mapView.onInfoWindowClickListner(new PlayMapView.OnInfoWindowClickCallback() {
@Override
public void onInfoWindowClickEvent(PlayMapMarker item) {
if (item.isCalloutLeftClicked()) {
Toast.makeText(getBaseContext(), "Info Window 'Left Image' Click \nfrom Marker
Id : " + item.getId(), Toast.LENGTH_LONG).show();
} else if (item.isCalloutRightClicked()) {
Toast.makeText(getBaseContext(), "Info Window 'Right Image' Click \nfrom Marker
Id : " + item.getId(), Toast.LENGTH_LONG).show();
} else{
Toast.makeText(getBaseContext(), "Info Window Click \nfrom Marker Id : " +
item.getId(), Toast.LENGTH_LONG).show();
}
}
});
void setEnableMarkerAnimation(boolean Enable)Description
마커의 애니메이션사용 여부를 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| Enable{boolean} | 사용 여부 |
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.setEnableMarkerAnimation(true);
boolean getEnableMarkerAnimation ()Description
마커의 애니메이션사용 여부를 반환합니다.
Parameters
Example
PlayMapMarker markerItem = new PlayMapMarker();
markerItem.getEnableMarkerAnimation();
PlayMapPolyLine
Description
지도 화면에 line 을표시하는데 필요한클래스입니다.
Constructors
PlayMapPolyLine ()
Example
PlayMapPolyLine polyLine = new PlayMapPolyLine();Methods
void setId(final String id)Description
지도에 표현될 line 의 id 를정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | line의 id 값 |
Example
PlayMapPolyLine polyLine = new PlayMapPolyLine();
polyLine.setId(idValue);
String getId()Description
지도에 표현된 line 의 id정보를 얻어옵니다.
Parameters
Example
String idValue = polyLine.getId();void addLinePoint(PlayMapPoint Point)Description
지도에 표현될 line 의좌표를 정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| Point{PlayMapPoint} | line의 좌표 |
Example
PlayMapPolyLine polyLine = new PlayMapPolyLine();
polyLine.addLinePoint (new PlayMapPoint(37.123456, 127.123456));
ArrayList<playmappoint> getLinePoint()Description
지도에 표현된 line 의좌표들의 정보를얻어옵니다.
Parameters
Example
ArrayList<playmappoint> pointList = polyLine.getLinePoint();</playmappoint>void setLineColor(int Color)Description
지도에 표현될 line 의색깔을 정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| Color{int} | line의 색깔 |
Example
polyLine.setLineColor (Color.BLUE);int getLineColor()Description
지도에 표현된 line 의색깔을 얻어옵니다.
Parameters
Example
int lineColor = polyLine.getLineColor ();void setLineWidth(final float width)Description
지도에 표현될 line 의넓이 값을 정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| width{float} | line의 넓이 |
Example
polyLine.setLineWidth (5);float getLineWidth()Description
지도에 표현된 line 의넓이 값을 얻어옵니다.
Parameters
Example
float lineWidth = polyLine.getLineWidth ();void setLineAlpha(float alpha)Description
지도에 표현될 line 의 Alpha값을 정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| alpha{float} | line의 Alpha 값 |
Example
polyLine.setLineAlpha (1.0);float getLineAlpha()Description
지도에 표현된 line 의 Alpha값을 얻어옵니다.
Parameters
Example
float lineAlpha = polyLine.getLineAlpha ();void setPathEffect(final Float[] dashPath)Description
지도에 표현될 line 의점선 효과를 정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| dashPath{Float[]} | line의 점선 효과 |
Example
polyLine.setPathEffect(new Float[]{1f, 1f});float[] getPathEffect()Description
지도에 표현된 line 의점선 효과를 얻어옵니다.
Parameters
Example
float[] pathEffect = polyLine.getPathEffect();void setOutLineColor(int Color)Description
지도에 표현될 line 의외곽선 색깔을 정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| Color{int} | line 의 외곽선 색깔 |
Example
polyLine.setLineColor (Color.BLUE);int getOutLineColor()Description
지도에 표현된 line 의외곽선 색깔을 얻어옵니다.
Parameters
Example
int outLineColor = polyLine.getOutLineColor ();void setOutLineAlpha(float alpha)Description
지도에 표현될 line 의외곽선 Alpha 값을 정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| alpha{float} | line 의 외곽선 Alpha |
Example
polyLine.setOutLineAlpha (1.0);float getOutLineAlpha()Description
지도에 표현된 line 의외곽선 Alpha 값을 얻어옵니다.
Parameters
Example
float outLineAlpha = polyLine.getOutLineAlpha();void setOutLineWidth(final floatwidth)Description
지도에 표현될 line 의외곽선 넓이 값을정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| width{float} | line 의 넓이 |
Example
polyLine.setOutLineWidth(5);float getOutLineWidth()Description
지도에 표현된 line 의외곽선 넓이 값을얻어옵니다.
Parameters
Example
float lineWidth = polyLine.getOutLineWidth ();void setOutLinePathEffect(final Float[]dashPath)Description
지도에 표현될 line 의외곽선 점선 효과 값을정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| dashPath{Float[]} | line 의 외곽선 점선 효과 |
Example
polyLine.setOutLinePathEffect (new Float[]{1f, 1f});float[] getOutLinePathEffect ()Description
지도에 표현된 line 의외곽선 점선 효과 값을얻어옵니다.
Parameters
Example
float[] linePathEffect = polyLine.getOutLinePathEffect();PlayMapPolygon
Description
지도 화면에 polygon 을표시하는데 필요한클래스입니다.
Constructors
PlayMapPolygon ()
Example
PlayMapPolygon polygon = new PlayMapPolygon();Methods
void setId(final String id)Description
지도에 표현될 polygon 의 id 를정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | polygon 의 id 값 |
Example
PlayMapPolygon polygon = new PlayMapPolygon();
polygon.setId(idValue);
String getId()Description
지도에 표현된 polygon 의 id정보를 얻어옵니다.
Parameters
Example
String idValue = polygon.getId();void addPolygonPoint(PlayMapPointPoint)Description
지도에 표현될 polygon 의좌표를 정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| Point{PlayMapPoint} | polygon 의 좌표 |
Example
PlayMapPolygon polygon = new PlayMapPolygon();
polygon.addPolygonPoint (new PlayMapPoint(37.123456, 127.123456));
ArrayList<playmappoint>
getPolygonPoint()</playmappoint>Description
지도에 표현된 ploygon 의좌표들의 정보를얻어옵니다.
Parameters
Example
ArrayList<playmappoint>pointList = polygon.getPolygonPoint();</playmappoint>void setAreaColor(int Color)Description
지도에 표현될 ploygon 의영역 색깔을 정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| Color{int} | polygon 의 영역 색깔 |
Example
polygon.setAreaColor(Color.BLUE);int getAreaColor()Description
지도에 표현된 ploygon 의영역 색깔을 얻어옵니다.
Parameters
Example
int areaColor = polygon.getAreaColor();void setLineColor(int Color)Description
지도에 표현될 ploygon 의 line색깔을 정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| Color{int} | polygon 의 line 색깔 |
Example
polygon.setLineColor (Color.BLUE);int getLineColor()Description
지도에 표현된 ploygon 의 line색깔을 얻어옵니다.
Parameters
Example
int lineColor = polygon.getLineColor ();void setPolygonWidth(final floatwidth)Description
지도에 표현될 ploygon 의 line넓이 값을 정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| width{float} | polygon 의 line 의 넓이 |
Example
polygon.setPolygonWidth(5);float getPolygonWidth()Description
지도에 ploygon 의 line 넓이값을 얻어옵니다.
Parameters
Example
float lineWidth = polygon.getPolygonWidth();void setAreaAlpha(float alpha)Description
지도에 표현될 ploygon 의영역 Alpha 값을 정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| alpha{float} | polygon 의 영역 Alpha 값 |
Example
polygon.setAreaAlpha(1.0);float getAreaAlpha()Description
지도에 표현된 ploygon 의영역 Alpha 값을 얻어옵니다.
Parameters
Example
float areaAlpha = polygon.getAreaAlpha();void setLineAlpha(float alpha)Description
지도에 표현될 ploygon 의 line Alpha값을 정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| alpha{float} | polygon 의 line Alpha 값 |
Example
polygon.setLineAlpha (1.0);float getLineAlpha()Description
지도에 표현된 ploygon 의 line Alpha값을 얻어옵니다.
Parameters
Example
float lineAlpha = polygon.getLineAlpha ();double getPolygonMeasures()Description
지도에 표현된 ploygon 의영역 넓이 값을 얻어옵니다.
Parameters
Example
double measures = polygon.getPolygonMeasures();PlayMapCircle
Description
지도 화면에 원을표시하는데 필요한클래스입니다.
Constructors
PlayMapCircle ()
Example
PlayMapCircle circle = new PlayMapCircle();Methods
void setId(final String id)Description
지도에 표현될 원의 id 를정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 원의 id 값 |
Example
PlayMapCircle circle = new PlayMapCircle();
circle.setId(idValue);
String getId()Description
지도에 표현된 원의 id정보를 얻어옵니다.
Parameters
Example
String idValue = circle.getId();void setCenterPoint(PlayMapPoint Point)Description
지도에 표현될 원의중심 좌표를 정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| Point{PlayMapPoint} | 원의 중심 좌표 |
Example
PlayMapCircle circle = new PlayMapCircle();
circle.setCenterPoint (new PlayMapPoint(37.123456, 127.123456));
PlayMapPoint getCenterPoint()Description
지도에 표현된 원의중심 좌표 정보를얻어옵니다.
Parameters
Example
PlayMapPoint centerPoint = circle.getCenterPoint();void setRadius(final float radius)Description
지도에 표현될 원의반경을 정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| radius{float} | 원의 반경 |
Example
circle.setRadius (500);float getRadius()Description
지도에 표현된 원의반경을 얻어옵니다.
Parameters
Example
float radius = circle.getRadius ();void setAreaColor(int Color)Description
지도에 표현될 원의영역 색깔을 정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| Color{int} | 원의 영역 색깔 |
Example
circle.setAreaColor(Color.BLUE);int getAreaColor()Description
지도에 표현된 원의영역 색깔을 얻어옵니다.
Parameters
Example
int areaColor = circle.getAreaColor();void setLineColor(int Color)Description
지도에 표현될 원의 line색깔을 정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| Color{int} | 원의 line 색깔 |
Example
circle.setLineColor (Color.BLUE);int getLineColor()Description
지도에 표현된 원의 line색깔을 얻어옵니다.
Parameters
Example
int lineColor = circle.getLineColor ();void setCircleWidth(final float width)Description
지도에 표현될 원의 line넓이 값을 정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| width{float} | 원의 line 넓이 |
Example
circle.setCircleWidth (5);float getCircleWidth()Description
지도에 표현된 원의 line넓이 값을 얻어옵니다.
Parameters
Example
float lineWidth = circle.getCircleWidth ();void setAreaAlpha(float alpha)Description
지도에 표현될 원의영역 Alpha 값을 정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| alpha{float} | 원의 영역 Alpha 값 |
Example
circle.setAreaAlpha (1.0);float getAreaAlpha()Description
지도에 표현된 원의영역 Alpha 값을 얻어옵니다.
Parameters
Example
float alpha = circle.getAreaAlpha ();void setLineAlpha(float alpha)Description
지도에 표현될 원의 line Alpha값을 정의합니다.
Parameters
| Name {Type} | Description |
|---|---|
| alpha{float} | 원의 line Alpha 값 |
Example
circle.setLineAlpha (1.0);float getLineAlpha()Description
지도에 표현된 원의 line Alpha값을 얻어옵니다.
Parameters
Example
float lineAlpha = circle.getLineAlpha ();MarkerCluster
Description
지도 클러스터 마커를표시하기 위한 클래스입니다.
Example
MarkerCluster markerItem = new MarkerCluster();
PlayMapPoint point = mapview.getMapCenterPoint();
markerItem.setMapPoint(point);
String strId = String.format("marker_%d", mCircleID++);
mapview.addClusterMarker(strId, markerItem);
Methods
void setId (String id)Description
클러스터 마커의 id를설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 설정할 id |
Example
MarkerCluster markerItem = new MarkerCluster();
markerItem.setId(“cluster_marker”);
String getId ()Description
클러스터 마커의 id를반환합니다.
Parameters
Example
MarkerCluster markerItem = new MarkerCluster();
markerItem.getId();
void setIcon (final Bitmap bitmap)Description
클러스터 마커의아이콘 이미지를설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| bitmap{Bitmap} | 설정할 이미지 |
Example
MarkerCluster markerItem = new MarkerCluster();
Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.hy);
markerItem.setIcon(bitmap);
Bitmap getIcon ()Description
클러스터 마커의아이콘 이미지를반환합니다.
Parameters
Example
MarkerCluster markerItem = new MarkerCluster();
markerItem.getIcon();
void setMapPoint (PlayMapPoint point)Description
클러스터 마커의좌표를 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| point{PlayMapPoint} | 설정할 위경도 좌표 |
Example
MarkerCluster markerItem = new MarkerCluster();
markerItem.setMapPoint(new PlayMapPoint(37.570841, 126.985302));
PlayMapPoint getMapPoint ()Description
클러스터 마커의좌표를 반환합니다.
Parameters
Example
MarkerCluster markerItem = new MarkerCluster();
markerItem.getMapPoint();
void setEnableClustering (boolean bEnable)Description
마커의 클러스터링사용여부를 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| bEnable{boolean} | 사용여부 |
Example
MarkerCluster markerItem = new MarkerCluster();
markerItem.setEnableClustering(true);
boolean getEnableClustering ()Description
마커의 클러스터링사용여부를 반환합니다.
Parameters
Example
MarkerCluster markerItem = new MarkerCluster();
markerItem.getEnableClustering();
void setVisible (boolean visible)Description
클러스터 마커의 표출여부를 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| visible{boolean} | 표출 여부 |
Example
MarkerCluster markerItem = new MarkerCluster();
markerItem.setVisible(true);
boolean getVisible ()Description
클러스터 마커의 표출여부를 반환합니다.
Parameters
Example
MarkerCluster markerItem = new MarkerCluster();
markerItem.getVisible();
PlayMapGroundImage
Description
Map 에 추가할 수 있는 이미지 정보를 담은 클래스
Constructors
PlayMapGroundImage(String id, PlayMapPoint leftTop, PlayMapPoint rightTop, PlayMapPoint rightBottom, PlayMapPoint leftBottom, Bitmap bitmap)
Parameters
| Name {Type} | Description |
|---|---|
| id{String} | 해당 객체 id |
| leftTop{PlayMapPoint} | 왼쪽 top 위/경도 정보 |
| id{PlayMapPoint} | 오른쪽 top 위/경도 정보 |
| rightBottom{PlayMapPoint} | 오른쪽 bottom 위/경도 정보 |
| leftBottom{PlayMapPoint} | 왼쪽 bottom 위/경도 정보 |
| bitmap{Bitmap} | 추가할 이미지 Bitmap 객체 |
Example
public void addGroundImage() {
String id = "custom" + mCustomImg++;
Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.hy);
if (mBitmap != null)
bitmap = mBitmap;
int width = bitmap.getWidth();
int height = bitmap.getHeight();
PointF centerPixel = mapView.getPointToPixel(mapView.getMapCenterPoint());
PointF p1 = new PointF(centerPixel.x - (width / 2), centerPixel.y - (height / 2));
PointF p2 = new PointF(centerPixel.x + (width / 2), centerPixel.y - (height / 2));
PointF p3 = new PointF(centerPixel.x + (width / 2), centerPixel.y + (height / 2));
PointF p4 = new PointF(centerPixel.x - (width / 2), centerPixel.y + (height / 2));
PlayMapPoint bp1 = mapView.getPointFromPixel(p1);
PlayMapPoint bp2 = mapView.getPointFromPixel(p2);
PlayMapPoint bp3 = mapView.getPointFromPixel(p3);
PlayMapPoint bp4 = mapView.getPointFromPixel(p4);
mapView.addGroundImageLayer(id, new PlayMapGroundImage(id,bp1,bp2,bp3,bp3,bitmap));
}
PlayMapPaddings
Description
상하좌우 패딩 영역 정보를 담은 클래스
Constructors
public PlayMapPaddings(int paddingLeft, int paddingTop, int paddingRight, int paddingBottom)
Parameters
| Name {Type} | Description |
|---|---|
| paddingLeft{int} | 왼쪽 패딩 영역(단위 : pixel) |
| paddingTop{int} | 위쪽 패딩 영역(단위 : pixel) |
| paddingRight{int} | 오른쪽 패딩 영역(단위 : pixel) |
| paddingBottom{int} | 아래쪽 패딩 영역(단위 : pixel) |
Example
//상하좌우 padding 각각 설정한 영역 객체 생성
PlayMapPaddings paddings = new PlayMapPaddings(80,30,80,10);
//해당 영역으로 이동
mapView.setMapBounds(minLon, maxLat, maxLon, minLat, 500, paddings);
PlayMapText
Description
Map 에 추가할 수 있는 라벨 정보를 담은 클래스
Constructors
public PlayMapText()
Example
public void drawLabelItem() {
PlayMapText labelItem = new PlayMapText();
PlayMapPoint point = mapView.getMapCenterPoint();
labelItem.setMapPoint(point);
labelItem.setName("Hello!");
labelItem.setTextColor(Color.RED);
labelItem.setTextSize(15);
mapView.addLabel("testLabel" + mLabelId++, labelItem);
}
PlayMapControl
Description
Map 에서 사용되는 상수를 사용하기 위한 정보가 담긴 클래스
enum
| Type | Description |
|---|---|
| MapControlPosition | NONE,LEFTTOP, RIGHTTOP, LEFTBOTTOM ,RIGHTBOTTOM |
| MapType | MAPTYPE_IMAGE, MAPTYPE_VECTOR |
Example
//MapControlPosition
mapView.setScaleBarPosition(10,20, PlayMapControl.MapControlPosition.LEFTTOP);
//MapType
mapView.setMapType(PlayMapControl.MapType.MAPTYPE_IMAGE);
PlayMapRestApi
Methods
void setPlayMapApiKey (String key)Description
API Key를 설정합니다.
Parameters
| Name {Type} | Description |
|---|---|
| key{String} | API Key |
Example
PlayMapRestApi mapRestApi = new PlayMapRestApi (this);
mapRestApi.setPlayMapApiKey("API Key");
void findAllPOI (final String data, final doublelat, final double lon, final int sort, final String intent, final int from, final int size,final int language, final FindAllPOIListenerCallback findAllPoiListener)Description
POI 통합 검색 요청
Parameters
| Name {Type} | Description |
|---|---|
| data{String} | 검색할 문자열 |
| lat{double} | 검색할 장소의 위도 |
| lon{double} | 검색할 장소의 경도 |
| sort{int} | 정렬 옵션 (1=추천순, 2=명칭순, 3=거리순) |
| intent{String} | 검색 의도 요청 (ex) "near_poi_class", "poi_name", "fts_poi") |
| from{int} | 검색 결과 시작 위치 |
| size{String} | 응답으로 받을 결과 개수 |
| language{int} | 언어 설정 (0 : 영어, 3: 한국어-default) |
| findAllPoiListener{FindAllPOIListenerCallback} | 결과에 대한 인터페이스 |
Example
PlayMapRestApi mapRestApi = new PlayMapRestApi (this);
mapRestApi.findAllPOI(“주유소”, 37.56640, 126.97851, 1, "fts_poi", 0, 20, 3, new mapRestApi.FindAllPOIListenerCallback(){
@Override
public void onFindAllPOI (ArrayList<PlayMapPoiItem> poiItem) {
}
});
Return
Return 정보는 Document를 참고해주세요.void findPOIDetailSearch (final intpoiId, final int language, final FindPOIDetailSearchListenerCallback findPoiDetailListener)Description
POI 상세 정보 검색 요청
Parameters
| Name {Type} | Description |
|---|---|
| poiId{String} | 검색할 POI ID |
| language{int} | 언어 설정 (0 : 영어, 3: 한국어-default) |
| findPoiDetailListener{FindPOIDetailSearchListenerCallback} | 결과에 대한 인터페이스 |
Example
PlayMapRestApi mapRestApi = new PlayMapRestApi (this);
mapRestApi.findPOIDetailSearch(119587, 3, new mapRestApi.FindPOIDetailSearchListenerCallback(){
@Override
public void onFindPOIDetailSearch (PlayMapPoiItem poiItem) {
}
});
Return
Return 정보는 Document를 참고해주세요.void aroundPOIsearch (final String depthText,final int radius, final int sort, final int roadType, final int from, final int size, finalFindAllPOIListenerCallback findAllPoiListener)Description
시설물 검색 요청
Parameters
| Name {Type} | Description |
|---|---|
| depthText{String} | 시설물 분류 업종 명칭 |
| radius{int} | 반경. m단위. 기본은 10000 |
| sort{int} | 정렬 옵션 (1=추천순, 2=명칭순, 3=거리순) |
| roadType{int} | 해당 위치 도로종별 |
| from{int} | 응답으로 받을 결과 시작 (0부터) |
| size{int} | 응답으로 받을 결과 개수 (from값이 없을 경우 0부터) |
| findAllPoiListener{FindAllPOIListenerCallback} | 결과에 대한 인터페이스 |
Example
PlayMapRestApi mapRestApi = new PlayMapRestApi (this);
mapRestApi.aroundPOIsearch(119587, 3, new mapRestApi.FindAllPOIListenerCallback(){
@Override
public void onFindAllPOI (ArrayList<PlayMapPoiItem> poiItem) {
}
});
Return
Return 정보는 Document를 참고해주세요.void searchGeocoding (final String keyword,final double lat, final double lon, final int sort, final int from, final int size, finalsearchGeocodingListenerCallback searchGeocodingListener)Description
Geocoding요청
Parameters
| Name {Type} | Description |
|---|---|
| keyword{String} | 주소 검색어 |
| lat{double} | 검색할 장소의 위도 |
| lon{double} | 검색할 장소의 경도 |
| sort{int} | 정렬 옵션 (1=추천순, 2=명칭순, 3=거리순) |
| from{int} | 응답으로 받을 결과 시작 (0부터) |
| size{int} | 응답으로 받을 결과 개수 (from값이 없을 경우 0부터) |
| searchGeocodingListener{searchGeocodingListenerCallback} | 결과에 대한 인터페이스 |
Example
PlayMapRestApi mapRestApi = new PlayMapRestApi (this);
mapRestApi.searchGeocoding(“마포대로100”, 37.56640, 126.97851, 3, 0, 20, new mapRestApi.searchGeocodingListenerCallback(){
@Override
public void onSearchGeocoding (ArrayList<PlayMapGeoItem> geoItems) {
}
});
Return
Return 정보는 Document를 참고해주세요.void reverseGeocoding (final double lat,final double lon, final int addrType, final reverseGeocodingListenerCallbackreverseGeocodingListener)Description
Reverse Geocoding요청
Parameters
| Name {Type} | Description |
|---|---|
| lat{double} | 검색할 장소의 위도 |
| lon{double} | 검색할 장소의 경도 |
| addrType{int} | 응답으로 받을 주소 체계 (0=지번주소, 1=도로명주소) |
| reverseGeocodingListener{reverseGeocodingListenerCallback} | 결과에 대한 인터페이스 |
Example
PlayMapRestApi mapRestApi = new PlayMapRestApi (this);
mapRestApi.reverseGeocoding(“마포대로100”, 37.56640, 126.97851, 3, 0, 20, new mapRestApi.searchGeocodingListenerCallback(){
@Override
public void onSearchGeocoding (ArrayList<PlayMapGeoItem> geoItems) {
}
});
Return
Return 정보는 Document를 참고해주세요.void findPathData (final String routeOption,final String feeOption, final String roadOption, final String coordType, final StringcarType, final PlayMapPoint startPoint, final ArrayList viaPoint, final PlayMapPointgoalPoint, final FindPathDataListenerCallback findPathDataListener)Description
경로 탐색 요청
Parameters
| Name {Type} | Description |
|---|---|
| routeOption{String} | 탐색 옵션(0: 최소시간, 1:(미정의) 2: 최단, 3:추천) |
| feeOption{String} | 요금(0: 모든도로, 1: 무료도로) |
| roadOption{String} | 우선도로(0: 모든도로, 1: 고속도로우선 2: 고속도로회피 3: 자동차전용도로회피) |
| coordType{String} | 좌표계타입( 1: Bessel, 2: WGS84) |
| carType{String} | 단말 차종 (0=미선택(기본값), 1=승용차/소형합차, 2= 중형승합차, 3= 대형승합차, 4= 대형화물차, 5= 특수화물차, 6=경차) |
| startPoint{PlayMapPoint} | 출발지 좌표 |
| viaPoint{ArrayList<layMapPoint>} | 경유지 좌표 리스트 (최대 3개) |
| goalPoint{PlayMapPoint} | 목적지 좌표 |
| findPathDataListener{FindPathDataListenerCallback} | 결과에 대한 인터페이스 |
Example
PlayMapRestApi mapRestApi = new PlayMapRestApi (this);
PlayMapPoint point1 = new PlayMapPoint(37.56640, 126.97851);
PlayMapPoint point2 = new PlayMapPoint(37.562692, 127.007286);
PlayMapPoint passPoint1 = new PlayMapPoint(37.538603, 127.007200);
PlayMapPoint passPoint2 = new PlayMapPoint(37.543930, 126.950922);
ArrayList<PlayMapPoint> passList = new ArrayList<>();
passList.add(passPoint1);
passList.add(passPoint2);
mapRestApi.findMultiPointPathData(point1, passList, point2, new mapRestApi.FindPathDataListenerCallback(){
@Override
public void onFindPathData (PlayMapPolyLine polyLine) {
}
});