Marker

パブリック ファイナル クラス マーカー オブジェクト
を拡張

地図上の特定のポイントに配置されるアイコン。マーカー アイコンは、指定した向きまたは重ねて 地図の表面ではなくデバイスの画面に照らして配置します。すなわち、必ずしも変更されるとは限りません。 地図の回転、傾斜、ズームによる画面の向きが変わることがあります。

マーカーには次の特性があります。

アルファ版
マーカーの不透明度を設定します。デフォルトは 1.0 です。
アンカー
マーカーの LatLng の位置に配置される画像上の点。 デフォルトでは、画像の左側と下部から 50% に設定されます。
位置
地図上のマーカーの位置を表す LatLng 値。この値は いつでもマーカーを移動できます。
タイトル
ユーザーがマーカーをタップしたときに情報ウィンドウに表示されるテキスト文字列。Google Chat では この値はいつでも変更できます。
スニペット
タイトルの下に表示される追加のテキスト。この値はいつでも変更できます。
アイコン
マーカーで表示されるビットマップ。アイコンを未設定のままにした場合、デフォルトのアイコンは 表示されます。defaultMarker(float) を使用して、デフォルト アイコンの代替色を指定できます。
ドラッグ ステータス
ユーザーがマーカーをドラッグできるようにするには、このプロパティを true に設定します。マイページ この値はいつでも変更できます。デフォルトは false です。
視程
デフォルトでは、マーカーは表示されます。マーカーを非表示にするには、このプロパティを false。この値はいつでも変更できます。
フラットまたはビルボード
マーカーが地図に対して平らな場合、マーカーはカメラに向かって地図上で固定されたままになります。 回転や傾斜はしますが、GroundOverlay とは異なり、カメラのズームと同じサイズのままです。マーカーがビルボードの場合は、常にカメラに向かって描画され、 カメラに合わせて回転、傾斜します。デフォルトはビルボード（false）
ローテーション
マーカーのアンカー ポイントを中心とした時計回りの角度で表したマーカーの回転。軸 マーカーに対して垂直になります。回転を 0 にすると、デフォルトの マーカーの位置。地図上のマーカーがフラットな場合、デフォルトの位置は北です 地図上でマーカーが常に平らになるように回転します。リリースを マーカーは看板、デフォルトの位置は上向きで、回転は マーカーは常にカメラの方を向いています。デフォルト値は 0 です。
zIndex
マーカーの描画順序。マーカーは zIndex 順に描画され、 最上部に描画された ZIndex マーカー。各マーカーに zIndex プロパティを設定すると、 ユーザーがヒットする可能性の高いタップ ターゲットを制御できます。デフォルト値は 0 です。
タグ
マーカーに関連付けられた Object。たとえば、Object には、 マーカーが表す内容に関するデータを返します。これは、個別の Map<Marker, Object> を保存するよりも簡単です。別の例として、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 他のマーカーやベースと衝突した場合のマーカーの処理方法を示します 使用できます。

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

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

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

パブリック メソッド

<ph type="x-smartling-placeholder"></ph> 一般公開 ブール値 次と等しい （オブジェクト その他）

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

パラメータ
その他 Object。
戻り値
  • 両方のオブジェクトが同じオブジェクトの場合、つまり、これは「== other」の場合は true を返します。

<ph type="x-smartling-placeholder"></ph> 一般公開 浮動小数点数 getAlpha ()

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

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

<ph type="x-smartling-placeholder"></ph> 一般公開 文字列 getId ()

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

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

<ph type="x-smartling-placeholder"></ph> 一般公開 LatLng をご覧ください。 getPosition ()

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

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

<ph type="x-smartling-placeholder"></ph> 一般公開 浮動小数点数 getRotation ()

マーカーの回転を取得します。

戻り値
  • マーカーの回転を、デフォルトの位置からの時計回りの度数で指定します。

<ph type="x-smartling-placeholder"></ph> 一般公開 文字列 getSnippet ()

マーカーのスニペットを取得します。

戻り値
  • マーカーのスニペットを含む文字列。

<ph type="x-smartling-placeholder"></ph> 一般公開 オブジェクト getTag ()

マーカーのタグを取得します。

戻り値
  • タグが setTag に設定されている場合は、タグ。タグが設定されていない場合は null。

<ph type="x-smartling-placeholder"></ph> 一般公開 文字列 getTitle ()

マーカーのタイトルを取得します。

戻り値
  • マーカーのタイトルを含む文字列。

<ph type="x-smartling-placeholder"></ph> 一般公開 浮動小数点数 getZIndex ()

マーカーの zIndex を返します。

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

<ph type="x-smartling-placeholder"></ph> 一般公開 整数 hashCode ()

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 hideInfoWindow ()

情報ウィンドウがこのマーカーから表示される場合は非表示にします。

このマーカーが非表示の場合、このメソッドの効果はありません。

<ph type="x-smartling-placeholder"></ph> 一般公開 ブール値 isDraggable ()

マーカーのドラッグ可能性を取得します。マーカーがドラッグ可能な場合、ユーザーは次の方法でマーカーを移動できます。 長押しします。

戻り値
  • マーカーがドラッグ可能な場合は true、それ以外の場合は false を返します。

<ph type="x-smartling-placeholder"></ph> 一般公開 ブール値 isFlat ()

マーカーのフラット設定を取得します。

戻り値
  • マーカーが地図に対して平坦である場合は true、マーカーの位置に false を追加します。 カメラを正します。

<ph type="x-smartling-placeholder"></ph> 一般公開 ブール値 isInfoWindowShown ()

情報ウィンドウが現在このマーカーの上に表示されているかどうかを返します。このモデルでは、 情報ウィンドウが実際に画面に表示されているかどうか。

<ph type="x-smartling-placeholder"></ph> 一般公開 ブール値 isVisible ()

このマーカーの公開設定を取得します。ただし、この指標はマーカーが が画面のビューポート内にあるかどうかです。次の場合にマーカーを描画するかどうかを指定します。 ビューポート内に収まるように配置されます

戻り値
  • このマーカーの表示設定。

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 削除 ()

このマーカーを地図から削除します。マーカーを削除すると、そのマーカーのすべての動作 メソッドが定義されていません。

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setAlpha （浮動小数点数アルファ）

マーカーのアルファ（不透明度）を設定します。0 ～ 1 の値で、0 はマーカーであることを示します。 は完全に透明で、1 はマーカーが完全に不透明であることを意味します。

パラメータ
アルファ

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setAnchor （float anchorU, float anchorV）

マーカーのアンカー ポイントを設定します。

アンカーは、マーカーの位置に固定されるアイコン画像内の点を指定します。 地球の表面上に現れます

アンカー ポイントは、連続空間 [0.0, 1.0] x [0.0, 1.0] で指定されます。ここで (0, 0) は画像の左上隅、(1, 1) は右下隅です。アンカー ポイント W x H の画像で、(W + 1) x 型の最も近い離散グリッド点 (H + 1) グリッド。スケーリング後に丸めます。たとえば 4x2 の画像では アンカー ポイント (0.7, 0.6) は、(3, 1) のグリッド ポイントに解決されます。 

 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----+-----+
 |     |     |   X |     |   (U, V) = (0.7, 0.6)
 |     |     |     |     |
 *-----+-----+-----+-----*
 *-----+-----+-----+-----*
 |     |     |     |     |
 |     |     |     |     |
 +-----+-----+-----X-----+   (X, Y) = (3, 1)
 |     |     |     |     |
 |     |     |     |     |
 *-----+-----+-----+-----*

パラメータ
anchorU アンカーの u 座標。画像の幅に対する比率（[0, 1] の範囲）で指定します。
anchorV アンカーの v 座標。画像の高さに対する比率で表します（[0, 1]）。

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setDraggable （ドラッグ可能なブール値）

マーカーのドラッグ可能性を設定します。マーカーがドラッグ可能な場合、ユーザーは次の方法でマーカーを移動できます。 長押しします。

パラメータ
draggable

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setFlat （ブール値のフラット）

このマーカーを地図 true に対して平らにするか、ビルボードに接するかを設定します カメラ false。

パラメータ
フラット

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setIcon （BitmapDescriptor iconDescriptor）

マーカーのアイコンを設定します。

パラメータ
iconDescriptor null の場合は、デフォルトのマーカーが使用されます。

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setInfoWindowAnchor （float anchorU, float anchorV）

情報ウィンドウを固定するマーカー画像内の位置を指定します。 表示されます。アンカーと同じ座標系で指定します。詳しくは、setAnchor(float, float) をご覧ください。デフォルトは画像の上部中央です。

パラメータ
anchorU 情報ウィンドウのアンカーの u 座標。画像の幅（ 範囲 [0, 1]）。
anchorV 情報ウィンドウのアンカーの v 座標。 範囲 [0, 1]）。

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setPosition （LatLng latlng）

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

パラメータ
緯度経度

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setRotation （浮動小数点回転）

マーカーのアンカー ポイントを中心とした時計回りの角度でマーカーの回転を設定します。軸 マーカーに対して垂直になります。回転の 0 はデフォルトの位置に対応します。 クリックします。

パラメータ
回転

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setSnippet （文字列スニペット）

マーカーのスニペットを設定します。

パラメータ
snippet null の場合、スニペットはクリアされます。

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setTag （オブジェクト タグ）

マーカーのタグを設定します。

このプロパティを使って、任意の Object をこのマーカーに関連付けることができます。対象 たとえば Object には、マーカーが表す内容に関するデータを含めることができます。こちらの方が簡単 Map<Marker, Object> を格納するよりも効率的です。別の例として、1 つのテーブルに String データセットの ID に対応する ID。Google Maps SDK for Android でもない 読み書きできません。責任を持って setTag(null) を呼び出して、 アプリのメモリリークを防止できます。

パラメータ
タグ null の場合、タグはクリアされます。

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setTitle （文字列のタイトル）

マーカーのタイトルを設定します。

パラメータ
title null の場合、タイトルはクリアされます。

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setVisible （ブール値表示）

このマーカーの表示 / 非表示を設定します。false に設定され、情報ウィンドウが現在 表示されている場合、情報ウィンドウは非表示になります。

パラメータ
表示

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 setZIndex （浮動小数点数 zIndex）

マーカーの zIndex を設定します。

パラメータ
zIndex

<ph type="x-smartling-placeholder"></ph> 一般公開 無効 showInfoWindow ()

このマーカーが isVisible() の場合、地図上にこのマーカーの情報ウィンドウを表示します。

例外
IllegalArgumentException markerがこの地図にない場合