ラベルを追加する

本SDKは、マップにラベル(注記と記号)を追加することができます。

LabelOptionsオブジェクトを作成し、次のメソッドでマップに追加することで、地図にラベルが追加できます。

ZDCMap.addLabel(LabelOptions)

このメソッドはLabelオブジェクトを返すので、これを使って追加したラベルを変更/削除することができます。

GroundOverlayOptionsには、以下のプロパティがあります。

プロパティ 概要  
Position ラベルの中心座標を設定します。  
DrawPosition 記号に対する文字の描画位置を設定します。
  • 0:記号の中心に文字の中心が位置します
  • 1:記号の右側に文字の中心が位置します
  • 2:記号の左側に文字の中心が位置します
  • 3:記号の上側に文字の中心が位置します
  • 4:記号の下側に文字の中心が位置します
 
Icons 記号を設定します。
複数設定することが可能ですが、アトラス形式にした際に幅と高さが1024を超える場合は描画できません。
 
LabelTextInfo 文字情報を設定します。
詳細は以下を参照してください。
文字情報を設定する
 
Bearing ラベルを回転させる角度を設定します。
指定した角度は、文字と記号の両方に適用されます。
 
zIndex ラベルの描画優先度を設定します。
ラベル同士が重なった時に、値が低いものを優先的に描画します。
ラベルのzIndexは、他図形(Polyline, Polygon, Circle, GroundOverlay)のzIndexと扱いが異なることに注意してください。
 
Visible ラベルの可視性を設定します。trueの時に描画し、falseの時は描画しません。  
Force ラベルの強制描画フラグを設定します。
この値がtrueの時、zIndexの設定を無視して描画します。
 
Clickable onLabelClickイベントの発生可否を設定します。trueの時にラベルがタッチされるとイベントが発生します。  

以下はラベルを追加するサンプルコードです。

Label label = map.addLabel(new LabelOptions()
      .position(new LatLng(35.628958, 139.741576))
      .addLabelTextInfo(new LabelTextInfo()
            .text("品川駅港南口")
            .textColor(Color.WHITE)
            .fillColor(Color.BLACK)
      )
);