Main Content

geoplot

地理座標にラインをプロット

  • Plot line in geographic coordinates

説明

ベクトル データ

geoplot(lat,lon) は、ベクトル lat および lon で指定された緯度と経度 (度単位) の場所の頂点を使用して、地理座標にラインをプロットします。入力 lat および lon は同じサイズでなければなりません。既定では、geoplot は実線を描画します。このとき、マーカーは使用されず、また geographic axes オブジェクトの ColorOrder プロパティで指定された色が使用されます。

geoplot(lat,lon,LineSpec) は、ラインのスタイル、マーカー記号および色を設定します。

geoplot(lat1,lon1,...,latN,lonN) は、緯度経度位置の複数の組み合わせにより指定されたプロットを結合します。

geoplot(lat1,lon1,LineSpec1,...,latN,lonN,LineSpecN) は、緯度経度位置の複数の組み合わせにより指定されたプロットを、行ごとに別々の LineSpec を使用して結合します。

テーブル データ

geoplot(tbl,latvar,lonvar) は、table tbl の変数 latvar および lonvar をプロットします。1 つのデータ セットをプロットするには、latvarlonvar にそれぞれ 1 つの変数を指定します。複数のデータ セットをプロットするには、latvarlonvar、またはその両方に複数の変数を指定します。両方の引数に複数の変数を指定する場合は、同数の変数を指定しなければなりません。(R2022b 以降)

追加オプション

geoplot(gx,___) は、現在の座標軸の代わりに gx で指定される地理座標軸を使用します。

geoplot(___,Name,Value) は、1 つ以上の名前と値の引数を使用してチャート ラインのプロパティを指定します。

h = geoplot(___) は Chart Line オブジェクトの列ベクトルを返します。各オブジェクトはプロットされる 1 つのラインに対応します。h を使用して、Chart Line オブジェクトのプロパティを変更します。

メモ

Mapping Toolbox™ は、MATLAB® 関数 geoplot の機能を拡張します。これにより、サポートされている任意の地理または投影座標参照系 (CRS) の座標を使用して点、ライン、多角形を表示できるようになります。geoplot (Mapping Toolbox) ページについては、geoplot (Mapping Toolbox) を参照してください。

すべて折りたたむ

マップ上の 2 点間の直線をプロットします。シアトルとアンカレッジの座標を使用して、ラインの端点を指定します。緯度と経度を度単位で指定します。

latSeattle = 47.62;
lonSeattle = -122.33;
latAnchorage = 61.20;
lonAnchorage = -149.9;

マップ上にデータをプロットします。ライン仕様 'g-*' を使用して、ラインの外観をカスタマイズします。geolimits を使用してマップの緯度と経度の範囲を調整します。

geoplot([latSeattle latAnchorage],[lonSeattle lonAnchorage],'g-*')
geolimits([45 62],[-149 -123])

マップ上の 2 点間の直線をプロットします。シアトルとアンカレッジの座標を使用して、ラインの端点を指定します。緯度と経度を度単位で指定します。

latSeattle = 47.62;
lonSeattle = -122.33;
latAnchorage = 61.20;
lonAnchorage = -149.9;

geoplot を使用してデータをプロットします。ライン仕様 'g-*' を使用して、ラインの外観をカスタマイズします。geolimits を使用してマップの緯度と経度の範囲を調整します。

geoplot([latSeattle latAnchorage],[lonSeattle lonAnchorage],'g-*')
geolimits([45 62],[-149 -123])

関数 text を使用してアンカレッジを識別します。

text(latAnchorage,lonAnchorage,'Anchorage');

関数 text を使用してシアトルを識別します。Text オブジェクトのプロパティを指定して、テキスト ラベルの配置を調整します。

text(latSeattle,lonSeattle,'Seattle',...
    'HorizontalAlignment','right',...
    'VerticalAlignment','bottom');

シアトル、アンカレッジおよびポイントバローの緯度座標と経度座標を指定します。

latSeattle = 47.62;
lonSeattle = -122.33;

latAnchorage = 61.20;
lonAnchorage = -149.9;

latPtBarrow = 71.38;
lonPtBarrow = -156.47;

シアトルから他の 2 都市へ、それぞれ直線をプロットします。シアトルからアンカレッジへの黄色の実線を描画し、シアトルからポイントバローへの青色の点線を描画します。geolimits を使用してマップの緯度と経度の範囲を調整します。

geoplot([latSeattle latAnchorage],[lonSeattle lonAnchorage],'y-',...
    [latSeattle latPtBarrow],[lonSeattle lonPtBarrow],'b:')
geolimits([44 73],[-149 -123])

関数 text を使用してマップ上の各都市にラベルを付けます。

text(latAnchorage,lonAnchorage,'Anchorage');
text(latPtBarrow,lonPtBarrow,'Point Barrow');
text(latSeattle,lonSeattle,'Seattle',...
    'VerticalAlignment','bottom');

R2022b 以降

table のデータをプロットするには、table を関数 geoplot に渡してプロット対象の変数を指定すると便利です。

サイクロンのデータを含む MAT ファイルをワークスペースに読み込みます。データのサブセットを使用して table を作成します。table には緯度と経度の座標の各 table 変数 LatitudeLongitude が含まれています。

load cycloneTracks
tbl = cycloneTracks(cycloneTracks.ID == 1320,:);

緯度と経度の座標を地形ベースマップにプロットします。Line オブジェクトを h として返します。

h = geoplot(tbl,"Latitude","Longitude");
geobasemap topographic

Marker および Color プロパティを設定して、プロットのマーカー スタイルと色を変更します。

h.Marker = ".";
h.Color = "m";

Figure contains an axes object. The axes object contains an object of type line.

マップ上の 2 点間の直線をプロットします。シアトルとアンカレッジの座標を使用して、ラインの端点を指定します。緯度と経度を度単位で指定します。

latSeattle = 47.62;
lonSeattle = -122.33;
latAnchorage = 61.20;
lonAnchorage = -149.9;

geoplot を使用してデータをプロットします。geolimits を使用してマップの緯度と経度の範囲を調整します。LineWidth プロパティと Color プロパティを使用して、ラインの外観をカスタマイズします。

geoplot([latSeattle latAnchorage],[lonSeattle lonAnchorage],...
    'LineWidth',2,'Color',[.6 0 0])
geolimits([45 62],[-149 -123])

マップ上でシアトルとアンカレッジの間に直線をプロットします。緯度座標と経度座標を度単位で指定します。

latSeattle = 47.62;
lonSeattle = -122.33;
latAnchorage = 61.20;
lonAnchorage = -149.9;
geoplot([latSeattle latAnchorage],[lonSeattle lonAnchorage])

緯度経度範囲とベースマップを変更します。

geolimits([45 62],[-149 -123])
geobasemap colorterrain

Figure contains an axes object. The axes object contains an object of type line.

入力引数

すべて折りたたむ

緯度座標 (度単位)。有限の実数値ベクトルとして指定します。ベクトルは埋め込まれた NaN を含むことができます。latlon と同じサイズでなければなりません。

例: [43.0327 38.8921 44.0435]

データ型: single | double

経度座標 (度単位)。有限の実数値ベクトルとして指定します。ベクトルは埋め込まれた NaN を含むことができます。lonlat と同じサイズでなければなりません。

例: [-107.5556 -77.0269 -72.5565]

データ型: single | double

ライン スタイル、マーカーおよび色。記号を含む string または文字ベクトルとして指定します。記号の順番は任意です。3 つの特性 (ライン スタイル、マーカーおよび色) をすべて指定する必要はありません。たとえば、ライン スタイルを省略してマーカーを指定する場合、プロットはラインなしでマーカーのみを表示します。

例: "--or" は円形マーカー付きの赤い破線

ライン スタイル説明結果として得られる線
"-"実線

Sample of solid line

"--"破線

Sample of dashed line

":"点線

Sample of dotted line

"-."一点鎖線

Sample of dash-dotted line, with alternating dashes and dots

マーカー説明結果のマーカー
"o"

Sample of circle marker

"+"プラス記号

Sample of plus sign marker

"*"アスタリスク

Sample of asterisk marker

"."

Sample of point marker

"x"十字

Sample of cross marker

"_"水平線

Sample of horizontal line marker

"|"垂直線

Sample of vertical line marker

"square"正方形

Sample of square marker

"diamond"菱形

Sample of diamond line marker

"^"上向き三角形

Sample of upward-pointing triangle marker

"v"下向き三角形

Sample of downward-pointing triangle marker

">"右向き三角形

Sample of right-pointing triangle marker

"<"左向き三角形

Sample of left-pointing triangle marker

"pentagram"星形五角形

Sample of pentagram marker

"hexagram"星形六角形

Sample of hexagram marker

色名省略名RGB 3 成分外観
"red""r"[1 0 0]

Sample of the color red

"green""g"[0 1 0]

Sample of the color green

"blue""b"[0 0 1]

Sample of the color blue

"cyan" "c"[0 1 1]

Sample of the color cyan

"magenta""m"[1 0 1]

Sample of the color magenta

"yellow""y"[1 1 0]

Sample of the color yellow

"black""k"[0 0 0]

Sample of the color black

"white""w"[1 1 1]

Sample of the color white

プロットするデータが含まれるソース table。table または timetable として指定します。

緯度座標を含む table 変数。table のインデックス方式の 1 つを使用して指定します。

インデックス方式

変数名:

  • string、文字ベクトル、または cell 配列。

  • pattern オブジェクト。

  • "A" または 'A'A という名前の変数

  • ["A","B"] または {'A','B'}A および B という名前の 2 つの変数

  • "Var"+digitsPattern(1)"Var" の後に数字 1 桁が続く名前の変数

変数インデックス:

  • table 内の変数の位置を参照するインデックス番号。

  • 数値のベクトル。

  • logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。

  • 3 — table の 3 番目の変数

  • [2 3] — table の 2 番目と 3 番目の変数

  • [false false true] — 3 番目の変数

変数の型:

  • 指定した型の変数を選択する vartype 添字。

  • vartype("categorical") — categorical 値を含んでいるすべての変数

変数名に関係なく、プロットの軸ラベルは常に Latitude です。

変数には、single または double 型の数値データが含まれていなければなりません。データは、(–90, 90) の範囲内でなければなりません。

latvarlonvar の両方が複数の変数を指定する場合、変数の数は同じでなければなりません。

例: geoplot(tbl,["lat1","lat2"],"lon") は、緯度座標用に lat1 および lat2 という名前の table 変数を指定します。

例: geoplot(tbl,2,"lon") は、緯度座標用に 2 番目の変数を指定します。

例: geoplot(tbl,vartype("numeric"),"lon") は、緯度座標用にすべての数値変数を指定します。

経度座標を含む table 変数。table のインデックス方式の 1 つを使用して指定します。

インデックス方式

変数名:

  • string、文字ベクトル、または cell 配列。

  • pattern オブジェクト。

  • "A" または 'A'A という名前の変数

  • ["A","B"] または {'A','B'}A および B という名前の 2 つの変数

  • "Var"+digitsPattern(1)"Var" の後に数字 1 桁が続く名前の変数

変数インデックス:

  • table 内の変数の位置を参照するインデックス番号。

  • 数値のベクトル。

  • logical ベクトル。通常、このベクトルの長さは変数の数と同じですが、末尾の 0 値や false 値は省略できます。

  • 3 — table の 3 番目の変数

  • [2 3] — table の 2 番目と 3 番目の変数

  • [false false true] — 3 番目の変数

変数の型:

  • 指定した型の変数を選択する vartype 添字。

  • vartype("categorical") — categorical 値を含んでいるすべての変数

変数名に関係なく、プロットの軸ラベルは常に Longitude です。

指定する変数には、single または double 型の数値データが含まれていなければなりません。

latvarlonvar の両方が複数の変数を指定する場合、変数の数は同じでなければなりません。

例: geoplot(tbl,"lat",["lon1","lon2"]) は、経度座標用に lon1 および lon2 という名前の table 変数を指定します。

例: geoplot(tbl,"lat",2) は、経度座標用に 2 番目の変数を指定します。

例: geoplot(tbl,"lat",vartype("numeric")) は、経度座標用にすべての数値変数を指定します。

ターゲットの地理座標軸。GeographicAxes オブジェクトとして指定します。 1 プロパティを設定することで GeographicAxes オブジェクトの外観と動作を変更できます。プロパティの一覧については、GeographicAxes のプロパティ を参照してください。

名前と値の引数

引数のオプションのペアを Name1=Value1,...,NameN=ValueN として指定します。ここで Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は重要ではありません。

R2021a より前では、コンマを使用してそれぞれの名前と値を区切り、Name を引用符で囲みます。

例: h = geoplot(lat,lon,'Color','g')

メモ

プロパティの設定はプロットのすべてのラインに適用されます。個別のラインのプロパティを設定するには、geoplot の戻り値 h でラインのハンドルを取得し、ドット表記を使用します。

ここにリストされている名前と値のペアは一部にすぎません。完全な一覧については、Line のプロパティ を参照してください。

ラインの色。RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。

カスタム色を使用する場合は、RGB 3 成分または 16 進数カラー コードを指定します。

  • RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。

  • 16 進数カラー コードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く文字ベクトルまたは string スカラーです。これらの値では大文字小文字は区別されません。したがって、カラー コード "#FF8800""#ff8800""#F80"、および "#f80" は等価です。

あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。

色名省略名RGB 3 成分16 進数カラー コード外観
"red""r"[1 0 0]"#FF0000"

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

"none"該当なし該当なし該当なし色なし

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分16 進数カラー コード外観
[0 0.4470 0.7410]"#0072BD"

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]"#D95319"

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]"#EDB120"

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]"#7E2F8E"

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]"#77AC30"

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]"#4DBEEE"

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]"#A2142F"

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

例: 'blue'

例: [0 0 1]

例: '#0000FF'

ライン スタイル。次の表にリストされたオプションのいずれかとして指定します。

ライン スタイル説明結果として得られる線
"-"実線

Sample of solid line

"--"破線

Sample of dashed line

":"点線

Sample of dotted line

"-."一点鎖線

Sample of dash-dotted line, with alternating dashes and dots

"none"ラインなしラインなし

ライン幅。ポイント単位の正の値として指定します。1 ポイントは 1/72 インチです。ラインがマーカーをもつ場合、ライン幅はマーカー エッジにも影響します。

ライン幅をピクセルの幅より細くすることはできません。システムでライン幅をピクセルの幅より細い値に設定すると、ラインは 1 ピクセル幅で表示されます。

マーカー記号。次の表のマーカーのいずれかとして指定します。既定では、チャート ラインにマーカーはありません。マーカー記号を指定することで、ライン上の各データ点にマーカーが追加されます。

マーカー説明結果のマーカー
"o"

Sample of circle marker

"+"プラス記号

Sample of plus sign marker

"*"アスタリスク

Sample of asterisk marker

"."

Sample of point marker

"x"十字

Sample of cross marker

"_"水平線

Sample of horizontal line marker

"|"垂直線

Sample of vertical line marker

"square"正方形

Sample of square marker

"diamond"菱形

Sample of diamond line marker

"^"上向き三角形

Sample of upward-pointing triangle marker

"v"下向き三角形

Sample of downward-pointing triangle marker

">"右向き三角形

Sample of right-pointing triangle marker

"<"左向き三角形

Sample of left-pointing triangle marker

"pentagram"星形五角形

Sample of pentagram marker

"hexagram"星形六角形

Sample of hexagram marker

"none"マーカーなし該当なし

マーカーの塗りつぶし色。"auto"、RGB 3 成分、16 進数カラー コード、色名、または省略名として指定します。"auto" オプションは親座標軸の Color プロパティと同じ色を使用します。"auto" を指定し、座標軸のプロット ボックスが非表示の場合、マーカーの塗りつぶし色は Figure の色です。

カスタム色を使用する場合は、RGB 3 成分または 16 進数カラー コードを指定します。

  • RGB 3 成分は、色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。たとえば [0.4 0.6 0.7] のようになります。

  • 16 進数カラー コードは、ハッシュ記号 (#) で始まり、3 桁または 6 桁の 0 から F までの範囲の 16 進数が続く文字ベクトルまたは string スカラーです。これらの値では大文字小文字は区別されません。したがって、カラー コード "#FF8800""#ff8800""#F80"、および "#f80" は等価です。

あるいは、名前を使用して一部の一般的な色を指定できます。次の表に、名前の付いた色オプション、等価の RGB 3 成分、および 16 進数カラー コードを示します。

色名省略名RGB 3 成分16 進数カラー コード外観
"red""r"[1 0 0]"#FF0000"

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

"none"該当なし該当なし該当なし色なし

MATLAB の多くのタイプのプロットで使用されている既定の色の RGB 3 成分および 16 進数カラー コードを次に示します。

RGB 3 成分16 進数カラー コード外観
[0 0.4470 0.7410]"#0072BD"

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]"#D95319"

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]"#EDB120"

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]"#7E2F8E"

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]"#77AC30"

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]"#4DBEEE"

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]"#A2142F"

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

マーカー サイズ。ポイント単位の正の値として指定します。1 ポイントは 1/72 インチです。

出力引数

すべて折りたたむ

地理プロット。Line オブジェクトの列ベクトルとして返されます。各オブジェクトはプロットされる 1 つのラインに対応します。h を使用して、オブジェクトの作成後にオブジェクトのプロパティを変更します。

ヒント

  • Mapping Toolbox は、MATLAB 関数 geoplot の機能を拡張します。これにより、サポートされている任意の地理または投影座標参照系 (CRS) の座標を使用して点、ライン、多角形を表示できるようになります。geoplot (Mapping Toolbox) ページについては、geoplot (Mapping Toolbox) を参照してください。

  • Mapping Toolbox 関数 geoglobe (Mapping Toolbox) および geoplot3 (Mapping Toolbox) を使用して 3 次元地理データをプロットします。

  • 地理座標軸上でプロットする場合、関数 geoplot では、座標は WGS84 座標参照系を基準とすると仮定します。別の座標参照系を基準とする座標を使用してプロットすると、座標がずれて表示される可能性があります。

  • 直交座標軸を必要とするデータを地理座標軸にプロットすることはできません。

  • 地理座標軸に追加のデータをプロットするには、hold on コマンドを使用します。

バージョン履歴

R2018b で導入

すべて展開する


1 Alignment of boundaries and region labels are a presentation of the feature provided by the data vendors and do not imply endorsement by MathWorks®.