사용자 정의 모양 및 객체 만들기

지도 상단에 사용자 정의 모양 및 객체를 만드는 것은 통합된 BlackBerry 프로그램을 구축하는데 필수적인 요소입니다. 예를 들어, BlackBerry Messenger와 통합하고 사용자가 근처에 있을 때 BlackBerry 단말기 사용자의 프로필 사진을 지도에 표시하는 프로그램을 만들 수 있습니다. 또한 어떤 프로그램을 만든 다음, 이 프로그램이 모니터링하는 지오펜스 영역을 다각형으로 표시할 수도 있습니다. 다른 표시 가능한 객체와 마찬가지로, 모양과 객체에 스타일을 넣어 사용자 정의할 수 있습니다.

net.rim.device.api.lbs.maps.model 패키지에는 기본 모양과 객체에 해당하는 다음과 같은 클래스가 포함되어 있습니다. 기본 모양과 객체는 자신의 객체를 만드는 데 구성 요소로 사용할 수 있습니다.

클래스

설명

MapPoint

이 클래스는 지도에서 위치의 좌표를 나타냅니다. MapPoint 객체 집합은 선, 폴리라인 및 다각형을 만드는 데 필요합니다.

MapMarker

이 클래스는 지도에서 마커 지점을 나타내며 MapPoint 객체와 유사합니다. 이미지를 MapMarker 객체로 사용할 수 있습니다.

PeerPoint

이 클래스는 지도에서 고정된 위치를 나타내며 정확도가 높습니다. 예를 들어, PeerPoint 객체를 사용하여 BlackBerry 단말기 사용자의 마지막 위치를 미터 단위의 정확도로 표시할 수 있습니다.

MapLine

이 클래스는 지도에서 선분을 표시합니다. MapLine 객체를 만들려면 선의 시작과 종료 지점에 대해 MapPoint 객체를 지정해야 합니다.

MapPolyLine

이 클래스는 정렬된 MapPoint 객체 집합 간을 여러 선분으로 이은 하나의 실선을 나타냅니다.

MapSimplePolygon

이 클래스는 정렬된 MapPoint 객체 집합으로 정의되는 간단한 다각형을 나타냅니다. 배열의 마지막 MapPoint 객체는 첫 객체에 연결되어 다각형을 이룹니다. 간단한 다각형은 복잡한 다각형보다 렌더링 속도가 빠릅니다.

MapComplexPolygon

이 클래스는 외부 범위(정렬된 MapPoints 시리즈로 정의됨)와 내부 범위(0개 이상의 MapSimplePolygons)로 구성되는 다각형을 나타냅니다.

MapImage

이 클래스는 지도에서 위치에 대한 이미지를 나타냅니다. 해당 위치에 대해 이미지, 미리 보기 또는 URI를 지정할 수 있습니다. 미리 보기를 지정하면 해당 미리 보기는 지도에 직접 표시됩니다. 사용자가 미리 보기를 클릭하여 확대를 요청하면 큰 이미지가 표시됩니다.

이전 표에 언급된 클래스 중 일부의 경우, 해당 모양 집합은 net.rim.device.api.lbs.maps.model.geospatial 패키지에서 제공됩니다. net.rim.device.api.lbs.maps.model.geospatial 패키지의 모양(Gs<shape>로 불림)과 기본 모양(Map<shape>로 불림) 간의 차이점은 지리공간 모양이 GsFolderGsRoot 클래스를 사용하여 트리 구조로 구성할 수 있다는 점입니다. 지리공간 객체에는 이름과 설명을 할당할 수도 있습니다.

MapSimplePolygon 객체 만들기

MapPoint[] points = new MapPoint[6];
points[0] = new MapPoint(45.05, -75.0);
points[1] = new MapPoint(45.0, -74.95);
points[2] = new MapPoint(44.95, -74.975);
points[3] = new MapPoint(44.95, -75.025);
points[4] = new MapPoint(45.0, -75.05);
points[5] = new MapPoint(45.05, -75.0);
MapSimplePolygon poly = new MapSimplePolygon(points);

GsImage 객체 만들기

GsImage gsImg = new GsImage();
img.setIconUri("http://www.rim.com/products/appworld_3col.jpg");
img.setLat(44.5);
img.setLon(-75.0);
img.setName("App World!");
img.setDescription("BlackBerry App World icon");

이 정보가 도움이 되었습니까? 의견을 보내 주십시오.