net.rim.device.api.lbs.maps.ui 패키지에 제공되는 MapField 클래스 및 RichMapField 클래스를 사용하여 프로그램에 지도를 추가할 수 있습니다. 예를 들어, BlackBerry 단말기 사용자의 현재 위치 및 주변에 있는 관심 지점을 표시하는 지도를 보여 주는 프로그램을 만들 수 있습니다.

MapField 클래스는 net.rim.device.api.ui.Field 클래스를 확장합니다. MapField를 사용하면 프로그램에 다음과 같은 기능을 추가할 수 있습니다.

• UI 필드에서 지도 렌더링
• 키보드, 트랙패드, 트랙볼 또는 터치 스크린을 사용하여 지도 이동 및 확대/축소
• 표시 가능한 객체의 시각적 특성을 정의하는 스타일 설정
• 표시 가능한 객체에 포커스가 나타날 시점, 또는 지도 상에서 지점을 선택할 시점 결정.

RichMapField 클래스는 MapField의 기능을 확장합니다. RichMapField를 사용하면 프로그램에 다음과 같은 기능을 추가할 수 있습니다.

• 중앙 대상 영역, 확대/축소 표시 및 힌트 필드와 같은 유틸리티 필드 추가
• 지도에 필드 오버레이
• 사용자가 지도 필드 구성 요소를 통해 화면 상의 다른 구성 요소로 이동할 수 있도록 화면 상의 다른 UI 구성 요소와 포커스 공유

각 MapField 또는 RichMapField 인스턴스는 스레드 하나를 사용하여 지도를 렌더링합니다. 예를 들어, 프로그램에서 MapField 인스턴스 2개를 동시에 실행하는 경우 스레드 2개가 사용됩니다. 스레드는 MapField 인스턴스가 가비지 수집의 대상으로 처리될 때 종료됩니다. 사용 가능한 스레드의 제한치를 프로그램에서 초과하지 않아야 합니다. MapField 또는 RichMapField 인스턴스의 스레드를 종료하려면 close()를 호출해야 합니다. 그러면 수신기인 필드가 특정 클래스에서 제거되고 가비지 수집이 시작됩니다.

MapField map = new MapField();
add(map);

RichMapField map = MapFactory.getInstance().generateRichMapField();
add(map);

• 프로그램에 지도 추가
  
• 코드 샘플: 프로그램에 지도 추가