本SDKは、マップにラベル(注記と記号)を追加することができます。
LabelOptionsオブジェクトを作成し、次のメソッドでマップに追加することで、地図にラベルが追加できます。
ZDCMap.addLabel(LabelOptions)
このメソッドはLabelオブジェクトを返すので、これを使って追加したラベルを変更/削除することができます。
GroundOverlayOptionsには、以下のプロパティがあります。
プロパティ | 概要 | |
---|---|---|
Position | ラベルの中心座標を設定します。 | |
DrawPosition |
記号に対する文字の描画位置を設定します。
|
|
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) ) );