マーカー

Public final クラス Marker が Object を拡張する

地図上のサーフェス上の特定の場所に配置されたアイコン。マーカー アイコンは、デバイスのサーフェスではなくデバイスの画面の向きに合わせて描画されます。つまり、地図の回転、傾斜、ズームによって、マーカーの向きが変わるとは限りません。

マーカーには次のプロパティがあります。

アルファ版
マーカーの不透明度を設定します。デフォルトは 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 他のマーカーまたは基本地図ラベルと競合した場合に、マーカーがどう対処されるかを示します。

パブリック メソッドの概要

ブール値
equals(Object other)
この Marker が等しいかどうかをテストします。
浮動小数点数
getAlpha()
マーカーのアルファを取得します。
文字列
getId()
このマーカーの ID を取得します。
LatLng
getPosition()
マーカーの位置を返します。
浮動小数点数
getRotation()
マーカーの回転を取得します。
文字列
getSnippet()
マーカーのスニペットを取得します。
オブジェクト
getTag()
マーカーのタグを取得します。
文字列
getTitle()
マーカーのタイトルを取得します。
浮動小数点数
getZIndex()
マーカーの zIndex を返します。
整数
void
hideInfoWindow()
情報ウィンドウがこのマーカーに表示される場合、情報ウィンドウは非表示になります。
ブール値
isDraggable()
マーカーのドラッグ可能性を取得します。
ブール値
isFlat()
マーカーのフラット設定を取得します。
ブール値
isInfoWindowShown()
情報ウィンドウがこのマーカーの上に現在表示されているかどうかを示します。
ブール値
isVisible()
このマーカーの表示設定を取得します。
void
remove()
このマーカーを地図から削除します。
void
setAlpha(浮動小数点アルファ版)
マーカーのアルファ(不透明度)を設定します。
void
setAnchor(float anchorU、float anchorV)
マーカーのアンカー ポイントを設定します。
void
setDraggable(ブール値のドラッグ可能)
マーカーのドラッグ可能性を設定します。
void
setFlat(ブール値フラット)
このマーカーを地図 true またはカメラ false に面したビルボードに対して平らに設定するかどうかを設定します。
void
setIconBitmapDescriptor iconDescriptor)
マーカーのアイコンを設定します。
void
setInfoWindowAnchor(float anchorU、float anchorV)
情報ウィンドウが表示される際に、マーカー画像内の情報ウィンドウを固定する点を指定します。
void
setPositionLatLng latlng)
マーカーの位置を設定します。
void
setRotation(浮動小数点回転)
マーカーのアンカー ポイントを中心として、時計回りの角度でマーカーの回転を設定します。
void
setSnippet(文字列スニペット)
マーカーのスニペットを設定します。
void
setTag(オブジェクト タグ)
マーカーのタグを設定します。
void
setTitle(文字列タイトル)
マーカーのタイトルを設定します。
void
setVisible(ブール値を表示)
このマーカーを表示するかどうかを設定します。
void
setZIndex(浮動小数点数の zIndex)
マーカーの zIndex を設定します。
void
showInfoWindow()
このマーカーの情報ウィンドウが地図上に表示されます(このマーカーが isVisible() の場合)。

継承されたメソッドの概要

パブリック メソッド

public boolean equals (Object other)

この Marker が等しいかどうかをテストします。

パラメータ
その他 Object です。
戻り値
  • 両方のオブジェクトが同じ場合は true(== 他の値)。

public float getAlpha ()

マーカーのアルファを取得します。

戻り値
  • 範囲 [0, 1] 内のマーカーのアルファ。

公開 文字列 getId ()

このマーカーの ID を取得します。この ID は、地図上のすべてのマーカー間で一意です。

戻り値
  • このマーカーの ID。

public LatLng getPosition ()

マーカーの位置を返します。

戻り値
  • マーカーの現在の位置を指定する LatLng オブジェクト。

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 setPosition (LatLng latlng)

マーカーの位置を設定します。

パラメータ
緯度 / 経度

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 がこのマップにない場合