地図上のサーフェス上の特定の場所に配置されたアイコン。マーカー アイコンは、デバイスのサーフェスではなくデバイスの画面の向きに合わせて描画されます。つまり、地図の回転、傾斜、ズームによって、マーカーの向きが変わるとは限りません。
マーカーには次のプロパティがあります。
- アルファ版
- マーカーの不透明度を設定します。デフォルトは 1.0 です。
- アンカー
- マーカーの
LatLng
の位置に配置される画像上の点。デフォルトでは、画像の左側と下部から 50% の位置に表示されます。 - 位置
- 地図上のマーカーの位置の
LatLng
値。マーカーを移動する場合は、この値をいつでも変更できます。 - Title
- ユーザーがマーカーをタップしたときに、情報ウィンドウに表示されるテキスト文字列。この値はいつでも変更できます。
- スニペット
- タイトルの下に表示される追加のテキストです。この値はいつでも変更できます。
- アイコン
- マーカーに表示されるビットマップ。アイコンを未設定のままにした場合は、デフォルトのアイコンが表示されます。
defaultMarker(float)
を使用して、デフォルト アイコンの代替色を指定できます。 - ドラッグ ステータス
- ユーザーがマーカーをドラッグできるようにするには、このプロパティを
true
に設定します。この値はいつでも変更できます。デフォルトはfalse
です。 - 可視性
- デフォルトではマーカーが表示されます。マーカーを非表示にするには、このプロパティを
false
に設定します。この値はいつでも変更できます。 - フラット表示またはビルボード
- 地図に対してマーカーがフラットな場合、
GroundOverlay
とは異なり、カメラが回転および傾斜してもマップに固定されます。ただし、カメラのズームと同じサイズのままになります。マーカーが屋外広告の場合は、常にカメラに面してマーカーが描画され、カメラが回転したり傾斜したりします。デフォルトはビルボード(false
)です - 回転
- マーカーのアンカー ポイントを中心として時計回りに時計回りに回転します。回転軸はマーカーに対して垂直になります。回転 0 は、マーカーのデフォルトの位置に対応します。地図上のマーカーがフラットな場合、デフォルトの位置は北向きになり、地図上のマーカーが常にフラットに表示されるように回転されます。マーカーがビルボードの場合、デフォルトの位置は上向きとなり、マーカーは常にカメラの方を向いて回転します。デフォルト値は 0 です。
- zIndex
- マーカーの描画順序。マーカーは zIndex 順に描画され、最も高い zIndex マーカーが上に表示されます。各マーカーに zIndex プロパティを設定することで、ユーザーがヒットする可能性が最も高いタップ ターゲットをコントロールできます。デフォルト値は 0 です。
- タグ
- マーカーに関連付けられた
Object
。たとえば、Object
には、マーカーが表す内容に関するデータを含めることができます。別のMap<Marker, Object>
を保存するよりも簡単です。別の例として、データセットの ID に対応するString
ID を関連付けることができます。Google Maps SDK for Android は、このプロパティの読み取りも書き込みも行いません。
このクラスのメソッドは Android UI スレッドで呼び出す必要があります。そうでない場合は、実行時に IllegalStateException
がスローされます。
例
GoogleMap map = ... // get a map.
// Add a marker at San Francisco.
Marker marker = map.addMarker(new MarkerOptions()
.position(new LatLng(37.7750, 122.4183))
.title("San Francisco")
.snippet("Population: 776733"));
デベロッパー ガイド
詳しくは、マーカーのデベロッパー ガイドをご覧ください。
ネストクラスの概要
@interface | Marker.CollisionBehavior | 他のマーカーまたは基本地図ラベルと競合した場合に、マーカーがどう対処されるかを示します。 |
パブリック メソッドの概要
ブール値 | |
浮動小数点数 |
getAlpha()
マーカーのアルファを取得します。
|
文字列 |
getId()
このマーカーの ID を取得します。
|
LatLng |
getPosition()
マーカーの位置を返します。
|
浮動小数点数 |
getRotation()
マーカーの回転を取得します。
|
文字列 |
getSnippet()
マーカーのスニペットを取得します。
|
オブジェクト |
getTag()
マーカーのタグを取得します。
|
文字列 |
getTitle()
マーカーのタイトルを取得します。
|
浮動小数点数 |
getZIndex()
マーカーの zIndex を返します。
|
整数 |
hashCode()
|
void |
hideInfoWindow()
情報ウィンドウがこのマーカーに表示される場合、情報ウィンドウは非表示になります。
|
ブール値 |
isDraggable()
マーカーのドラッグ可能性を取得します。
|
ブール値 |
isFlat()
マーカーのフラット設定を取得します。
|
ブール値 |
isInfoWindowShown()
情報ウィンドウがこのマーカーの上に現在表示されているかどうかを示します。
|
ブール値 |
isVisible()
このマーカーの表示設定を取得します。
|
void |
remove()
このマーカーを地図から削除します。
|
void |
setAlpha(浮動小数点アルファ版)
マーカーのアルファ(不透明度)を設定します。
|
void |
setAnchor(float anchorU、float anchorV)
マーカーのアンカー ポイントを設定します。
|
void |
setDraggable(ブール値のドラッグ可能)
マーカーのドラッグ可能性を設定します。
|
void |
setFlat(ブール値フラット)
このマーカーを地図
true またはカメラ false に面したビルボードに対して平らに設定するかどうかを設定します。 |
void | |
void |
setInfoWindowAnchor(float anchorU、float anchorV)
情報ウィンドウが表示される際に、マーカー画像内の情報ウィンドウを固定する点を指定します。
|
void | |
void |
setRotation(浮動小数点回転)
マーカーのアンカー ポイントを中心として、時計回りの角度でマーカーの回転を設定します。
|
void |
setSnippet(文字列スニペット)
マーカーのスニペットを設定します。
|
void |
setTag(オブジェクト タグ)
マーカーのタグを設定します。
|
void |
setTitle(文字列タイトル)
マーカーのタイトルを設定します。
|
void |
setVisible(ブール値を表示)
このマーカーを表示するかどうかを設定します。
|
void |
setZIndex(浮動小数点数の zIndex)
マーカーの zIndex を設定します。
|
void |
showInfoWindow()
このマーカーの情報ウィンドウが地図上に表示されます(このマーカーが
isVisible() の場合)。 |
継承されたメソッドの概要
パブリック メソッド
public boolean equals (Object other)
public float getAlpha ()
マーカーのアルファを取得します。
戻り値
- 範囲 [0, 1] 内のマーカーのアルファ。
公開 文字列 getId ()
このマーカーの ID を取得します。この ID は、地図上のすべてのマーカー間で一意です。
戻り値
- このマーカーの ID。
public float getRotation ()
マーカーの回転を取得します。
戻り値
- デフォルト位置からの時計回りの角度でのマーカーの回転。
公開 文字列 getSnippet ()
マーカーのスニペットを取得します。
戻り値
- マーカーのスニペットを含む文字列。
public Object getTag ()
マーカーのタグを取得します。
戻り値
- タグが
setTag
に設定されている場合はタグ。タグが設定されていない場合はnull
。
公開 文字列 getTitle ()
マーカーのタイトルを取得します。
戻り値
- マーカーのタイトルを含む文字列。
public float getZIndex ()
マーカーの zIndex を返します。
戻り値
- このマーカーの zIndex です。
public int hashCode ()
public void hideInfoWindow ()
マーカーがこの情報ウィンドウに表示されている場合、情報ウィンドウを非表示にします。
このマーカーが表示されない場合、このメソッドは効果を生じさせません。
public boolean isDraggable ()
マーカーのドラッグ可能性を取得します。ドラッグ可能なマーカーは、ユーザーが長押しすることで移動できます。
戻り値
- マーカーがドラッグ可能である場合は
true
、それ以外の場合はfalse
を返します。
public boolean isFlat ()
マーカーのフラット設定を取得します。
戻り値
- マーカーが地図に対してフラットの場合は
true
、マーカーがカメラの方を向いている場合はfalse
と指定します。
public boolean isInfoWindowShown ()
情報ウィンドウがこのマーカーの上に現在表示されているかどうかを示します。これは、情報ウィンドウが実際に画面に表示されているかどうかについては考慮しません。
public boolean isVisible ()
このマーカーの表示設定を取得します。これは、マーカーが画面のビューポート内にあるかどうかを示すものではありません。マーカーが画面のビューポートに含まれている場合に、マーカーを描画するかどうかを指定します。
戻り値
- このマーカーの表示 / 非表示
public void remove ()
このマーカーを地図から削除します。マーカーが削除された後、そのすべてのメソッドの動作は未定義になります。
public void setAlpha (浮動小数点アルファ版)
マーカーのアルファ(不透明度)を設定します。これは 0 ~ 1 の値です。0 はマーカーが完全に透明であることを意味し、1 はマーカーが完全に不透明であることを示します。
パラメータ
アルファ |
---|
public void setAnchor (float anchorU, float anchorV)
マーカーのアンカー ポイントを設定します。
アンカーは、地表面上のマーカーの位置に固定されるアイコン画像内の点を指定します。
アンカー ポイントは連続空間 [0.0, 1.0] x [0.0, 1.0] で指定します。(0, 0)は画像の左上隅、(1, 1)は右下の角です。W × H 画像のアンカー ポイントは、(W + 1) × (H + 1)のグリッドにおける最も近い個別グリッドポイントで、この四捨五入によってスケーリングされます。たとえば 4x2 の画像では、アンカー ポイント(0.7、0.6)は(3, 1)のグリッド ポイントに解決されます。
*-----+-----+-----+-----* | | | | | | | | | | +-----+-----+-----+-----+ | | | X | | (U, V) = (0.7, 0.6) | | | | | *-----+-----+-----+-----* *-----+-----+-----+-----* | | | | | | | | | | +-----+-----+-----X-----+ (X, Y) = (3, 1) | | | | | | | | | | *-----+-----+-----+-----*
パラメータ
アンカー | 画像の幅の比率として、アンカーの u 座標([0, 1] の範囲)で指定します。 |
---|---|
アンカー V | 画像の高さの比として、アンカーの v 座標([0, 1] の範囲)です。 |
public void setDraggable (ブール値のドラッグ可能)
マーカーのドラッグ可能性を設定します。ドラッグ可能なマーカーは、ユーザーが長押しすることで移動できます。
パラメータ
draggable |
---|
public void setFlat (ブール値フラット)
このマーカーを地図 true
またはカメラ false
に面したビルボードに対して平らに設定するかどうかを設定します。
パラメータ
横ばい |
---|
public void setIcon (BitmapDescriptor iconDescriptor)
マーカーのアイコンを設定します。
パラメータ
iconDescriptor | null の場合、デフォルトのマーカーが使用されます。 |
---|
public void setInfoWindowAnchor (float anchorU, float anchorV)
情報ウィンドウが表示される際に、マーカー画像内の情報ウィンドウを固定する点を指定します。アンカーと同じ座標系で指定します。詳しくは、setAnchor(float, float)
をご覧ください。デフォルトは、画像の上部中央です。
パラメータ
アンカー | 情報ウィンドウのアンカーの u 座標を画像幅の比率として指定します([0, 1] の範囲)。 |
---|---|
アンカー V | 情報ウィンドウのアンカーの v 座標を画像の高さの比率(範囲 [0, 1])で表します。 |
public void setRotation (浮動小数点回転)
マーカーのアンカー ポイントを中心として、時計回りの角度でマーカーの回転を設定します。回転軸はマーカーに対して垂直になります。回転 0 は、マーカーのデフォルトの位置に対応します。
パラメータ
回転 |
---|
public void setSnippet (文字列スニペット)
マーカーのスニペットを設定します。
パラメータ
スニペット | null の場合、スニペットはクリアされます。 |
---|
public void setTag (オブジェクト タグ)
マーカーのタグを設定します。
このプロパティを使用すると、任意の Object
をこのマーカーに関連付けることができます。たとえば、Object
には、マーカーが表す内容に関するデータを含めることができます。別の Map<Marker, Object>
を保存するよりも簡単です。別の例として、データセットの ID に対応する String
ID を関連付けることができます。Google Maps SDK for Android は、このプロパティの読み取りも書き込みも行いません。アプリのメモリリークを防ぐため、不要になったら setTag(null)
を呼び出してタグを消去する必要があります。
パラメータ
タグ | null の場合、タグはクリアされます。 |
---|
public void setTitle (文字列タイトル)
マーカーのタイトルを設定します。
パラメータ
title | null の場合、タイトルはクリアされます。 |
---|
public void setVisible (ブール値の表示)
このマーカーを表示するかどうかを設定します。false
に設定し、このマーカーに現在情報ウィンドウが表示されている場合、情報ウィンドウは非表示になります。
パラメータ
表示 |
---|
public void setZIndex (浮動小数点数 zIndex)
マーカーの zIndex を設定します。
パラメータ
Z-index |
---|
public void showInfoWindow ()
このマーカーの情報ウィンドウが地図上に表示されます(このマーカーが isVisible()
の場合)。
スロー値
IllegalArgumentException | marker がこのマップにない場合
|
---|