必要に応じて、コンテンツの保存と分類を行います。地図にシェイプを追加してアプリケーション用にカスタマイズする手軽な方法がいくつか用意されています。連結された一連の線分です。任意のシェイプを形成でき、地図上にパスやルートを示すために使用できます。地図上の領域を示すのに使用できる閉図形です。地図に描画された地表面上に円を地理的に正確に投影したものです。これらすべてのシェイプについて、いくつかのプロパティを変更することで、その外観をカスタマイズできます。アプリ用のコードが全文掲載されています。リポジトリには、シェイプおよびその機能の使い方を示すサンプルがあります。クラスは、地図上の連結された一連の線分を定義します。位置のセットで構成され、これらの位置を決まった順序で連結する一連の線分を作成します。この動画では、ポリラインを使用して、ユーザーが目的地にたどり着くためのパスを地図上に描く方法を説明しています。オブジェクトを作成し、これにポイントを追加します。オブジェクトとして表現されます。オブジェクトにポイントを追加した順序に従って、ポイント間に描画されます。呼び出すこともできます)。呼び出して、地図にポリラインを追加できます。オブジェクトを返します。ユーザーはこのオブジェクトを使用して、後でポリラインを変更できます。スニペットは、地図に長方形を追加する方法を示しています。map.addPolyline(polylineOptions);追加した長方形は、下のように地図上に表示されます。呼び出して、ポリライン用の新しいポイントのリストを提供します。ポリラインの外観は、地図に追加する前でも、地図に追加した後でもカスタマイズできます。詳しくは、以下の外観のカスタマイズのセクションをご覧ください。ポリラインのカスタマイズポリラインの外観はいくつかの方法でカスタマイズできます。ポリラインの線分ごとに異なる色を設定します。色のグラデーションを使ってポリラインの色を設定します。ポリラインの外観をビットマップ画像の反復パターンに設定します。レンダラを使用している必要があります。ポリラインの作成スパンを使って、ポリラインの個々の線分に色を付けることができます。デフォルトでは、配列の各アイテムが、対応する線分の色に設定されます。以下の例では、線分の色を設定して、赤と緑の線分で構成されるポリラインを作成しています。指定して、ストロークの始まりと終わりの色を指定します。オブジェクトでこのプロパティを設定します。パーク動物園からワシントン州カークランドまで、赤から黄にグラデーションするポリラインを作成しています。テクスチャの反復パターンに設定できます。オブジェクトでこのプロパティを設定します。.addSpan(span));ポリラインのイベントデフォルトでは、ポリラインはクリックできません。イベントをリッスンします。コールバックを受け取ります。値に基づいて、他のクリック可能なオーバーレイまたはシェイプに対してトリガーされます。回のクリックで複数のイベントがトリガーされることはありません。値がより小さいオーバーレイまたはシェイプにはクリックが渡されません。イベントについての説明をご覧ください。オブジェクトと似ています。ポリゴンは終端部が開いておらず、閉じたループ内を塗りつぶした領域として定義されます。追加するのと同じ方法で地図に追加できます。オブジェクトを作成し、これにいくつかのポイントを追加します。これらのポイントにより、ポリゴンのアウトラインが形成されます。呼び出して、地図にポリゴンを追加します。スニペットでは、地図に長方形を追加しています。塗りつぶしの色を定義しておらず、デフォルトの塗りつぶし色は透明なので、追加した長方形の外見は前セクションのスニペットで追加したポリライン長方形とまったく同じになります。呼び出して、ポリゴンのアウトライン用の新しいポイントのリストを提供します。ポリゴンの外観は、地図に追加する前でも、地図に追加した後でもカスタマイズできます。詳しくは、以下の外観のカスタマイズのセクションをご覧ください。つの座標で構成されていますが、最初と最後の座標の位置が同じであるため、ループが定義されています。実際には、ポリゴンは閉じられた領域を定義するものであるため、この最後の座標を定義する必要はありません。より最初の座標が一連の座標の最後に追加され、ポリゴンが自動的に閉じられます。つのポリゴンは同等です。つのすべてのポイントが返されます。オブジェクトにまとめて、塗りつぶされた輪、つまり「ドーナツ」(ポリゴンの内部にポリゴン領域が「島」状に表示されているもの)などの複雑なシェイプを作成できます。複雑なシェイプは、複数のパスで構成されています。つのパスは同じ領域内に定義される必要があります。つの領域のうち、大きい方が塗りつぶし領域を定義します。この領域は、追加オプションなしの単純なポリゴンです。目の小さい方のパスが、大きい方のパスで完全に囲まれている場合、ポリゴンの一部が削除されているかのように見えます。穴がポリゴンのアウトラインと交差している場合、ポリゴンは塗りつぶされずにレンダリングされます。つの長方形が作成されます。.fillColor(Color.BLUE));中が空洞のポリゴンが、下のように地図上に表示されます。ポリゴンのイベントデフォルトでは、ポリゴンはクリックできません。イベントをリッスンします。コールバックを受け取ります。値に基づいて、他のクリック可能なオーバーレイまたはシェイプに対してトリガーされます。回のクリックで複数のイベントがトリガーされることはありません。値がより小さいオーバーレイまたはシェイプにはクリックが渡されません。イベントについての説明をご覧ください。オブジェクトに対する特別なクラスも用意されており、円を簡単に作成することができます。つのプロパティを指定する必要があります。メートルの地点にある、地表面上のすべてのポイントのセットとして円が定義されます。メルカトル図法が採用されており、この図法の性質上、円は地図の赤道付近ではほぼ完全な円として表示されますが、円が赤道から遠ざかるにつれて、(画面上の表示では)歪んだ円となっていきます。呼び出して、新しい値を指定します。円の外観は、地図に追加する前でも、地図に追加した後でもカスタマイズできます。詳しくは、以下の外観のカスタマイズのセクションをご覧ください。呼び出すことで、地図に円が追加されます。map.addCircle(circleOptions);円のイベントデフォルトでは、円はクリックできません。イベントをリッスンします。コールバックを受け取ります。値に基づいてトリガーされます。回のクリックで複数のイベントがトリガーされることはありません。値がより小さいオーバーレイまたはシェイプにはクリックが渡されません。イベントについての説明をご覧ください。オブジェクトで必要なプロパティを指定して)、地図に追加した後でも変更できます。公開されているため、シェイプの現在の状態に簡単にアクセスできます。次のスニペットでは、メルボルンからパースへの測地線セグメントを持つ濃い青色のポリラインが追加されます。次のセクションでは、これらのプロパティの詳細について説明します。.geodesic(true));地図の表示は下のようになります。これらのプロパティのほとんどは、ここで説明するどのシェイプにも適用できますが、プロパティの中には特定のシェイプでは意味を持たないものもあります(たとえば、ポリラインには内部がないため、塗りつぶし色を指定することはできません)。ARGB(alpha、red、green、blue)整数で、シェイプのストロークの不透明度と色を指定します。オブジェクトでこのプロパティを設定します。指定しない場合のデフォルトのストローク色は黒(Color.BLACK)です。polyline)を呼び出してストローク色を変更したりできます。塗りつぶし色はポリゴンと円にのみ適用されます。ポリラインには内部が定義されていないため、ポリラインには適用されません。ポリゴンの場合、その穴の内側の領域はポリゴンの内部には含まれないため、塗りつぶし色が設定されていても色付けされません。ARGB(alpha、red、green、blue)整数で、シェイプの内部の不透明度と色を指定します。オブジェクトでこのプロパティを設定します。指定しない場合のデフォルトのストローク色は透明(Color.TRANSPARENT)です。呼び出して塗りつぶし色を変更したりできます。線のストローク幅の単位はピクセル(px)で、浮動小数点数で表現されます。この幅は、地図がズームされても拡大縮小されません(つまり、シェイプのストローク幅はすべてのズームレベルで同じです)。オブジェクトでこのプロパティを設定します。polyline)を呼び出してストローク幅を変更したりできます。ストロークのパターンポリラインや、ポリゴンと円の枠線で使用されるストロークのパターンはデフォルトで実線です。パターンを指定できます。各アイテムはダッシュ、ドット、ギャップになります。ピクセル長のギャップが続く連続シーケンスを設定しています。Gap(20));polyline.setPattern(pattern);パターンは線に沿って反復され、シェイプに指定された最初の頂点にある最初のパターン項目から始まります。タイプと置き換えることができます。タイプを適用しています。タイプは、線の内部のベンドに影響します。タイプも適用されます。タイプはドットには影響しません。スタイルを指定できます。メソッドを使用します。キャップを指定しています。ビットマップを指定しています。ビットマップを使用する際には、リファレンスのストロークの幅をピクセル単位で指定する必要があります。それに基づいてビットマップをスケーリングします。リファレンスのストロークの幅は、キャップのビットマップ画像を画像の元のサイズで設計するために使用したストローク幅です。設定してビットマップ画像を開き、画像を基準にして希望する線のストローク幅を指定します。使用してビットマップを作成する場合は、密度非依存のリソース(nodpi)を使用してください。測地線セグメント測地線設定はポリラインとポリゴンにのみ適用されます。円はセグメントの集合として定義されていないため、円には適用されません。測地線設定は、ポリラインまたはポリゴンの連続する頂点間での線分の描画方法を決定します。測地線セグメントは、地表面(球体)に沿った最短のパスに従うセグメントで、メルカトル図法を使用している地図では多くの場合、曲線として表示されます。非測地線セグメントは、地図上に直線として描画されます。オブジェクトでこのプロパティを設定します。セグメントを直線として描画することを示します。指定しない場合のデフォルトは、非測地線セグメント(false)です。呼び出して測地線設定を変更したりできます。オーバーレイ)と相対的な、このシェイプの重ね順序を指定します。オーバーレイより上に描画されます。つのオーバーレイは、任意の順序で描画されます。関係なく、常に他のオーバーレイの上に描画されます。オブジェクトでこのプロパティを設定します。シェイプを地図に描画するかどうかを指定します。描画しないことを示します。これを使用して、地図上で一時的にシェイプを非表示にできます。オブジェクトでこのプロパティを設定します。呼び出して公開設定を変更したりできます。使ってそのオブジェクトを取得することができます。オブジェクトを取得できます。以下のコードでは、指定されたポリラインの任意のタグ(A)を定義しています。147.309)));polyline.setTag("A");次に、データにシェイプを保存し、それを取得する方法が役立つシナリオの例をいくつか紹介します。アプリでさまざまなタイプのシェイプを提供し、ユーザーがシェイプをクリックしたときにそれぞれ異なる処理を行う。固有のレコード識別子を持つシステムと連携し、シェイプでシステムの特定のレコードを表す。決定するための優先度を指定する。ライセンスにより使用許諾されます。ライセンスにより使用許諾されます。サイトのポリシーをご覧ください。関連会社の登録商標です。