本文へスキップ
からだにいいもの

まだ知らない、役に立つ情報を。ゲーム攻略・R・ガジェット

Rで解析:中国の省・市・県の地図に地点や方位記号、スケールバーを重ねる「ggmapcn」パッケージ

「ggmapcn」パッケージは、中国の省・市・県の境界や世界地図をggplot2のレイヤーとして読み込み、地点や方位記号、スケールバー、経緯度線を重ねた地図を作れるパッケージです。地点は経度・緯度の列を持つデータフレームか、sfオブジェクトで渡します。ggplot2の上に乗る拡張で、中国の行政区画は同梱されていますが、世界地図と標高のデータは初回にダウンロードが要ります。地図の投影を変えても経度・緯度のまま範囲を指定できるので、中国を含むアジアの調査地点を地図で見せたい場面で活用できるのではないかと考えます。

パッケージバージョンは0.3.1。Windows 11 x64 (build 26200)のR version 4.6.1で確認しています。

パッケージのインストール

下記コマンドを実行してください。

# パッケージのインストール
install.packages("ggmapcn")

# パッケージの読み込み
library("ggmapcn")
Warning message:
package 'ggmapcn' was built under R version 4.6.2
Loading required package: ggplot2

# コマンド例実行で必要なパッケージを読み込み
library("ggplot2")
スポンサーリンク

コマンド例

詳細はコメント、パッケージのヘルプを確認してください。

中国の地図は、初期値で中国の中心(北緯35度・東経105度)から見た正距方位図法(aeqd)に投影されます。地点やスケールバーを重ねるときも、この座標参照系(CRS)にそろえて使います。DEM(Digital Elevation Model)は、標高を格子状に記録したデータのことです。

例として、京都の茶商が仕入れを考えている中国の茶どころ5か所に、架空の試飲点を付けたデータを作ります。

# 茶どころの架空データ(経度・緯度はおおよその位置)
tea_site <- data.frame(
  site  = c("Hangzhou", "Anxi", "Huangshan", "Yaan", "Puer"),
  type  = c("green", "oolong", "green", "dark", "dark"),
  score = c(88, 82, 79, 71, 85),
  lon   = c(120.15, 118.19, 118.34, 103.00, 100.97),
  lat   = c(30.27, 25.06, 29.71, 29.98, 22.79)
)

# 茶どころのある省(英語名)
tea_prov <- c("Zhejiang", "Fujian", "Anhui", "Sichuan", "Yunnan")

地理データの確認と取得:check_geodataコマンド

地図のデータがあるかを確かめ、無ければダウンロードします。戻り値は保存先のパスです。世界地図を使うcoord_projの節の前に、ここで取得しておきます。

オプション意味初期値
files確認・取得するファイル名の文字列ベクトル。NULLで既知のファイルをすべて対象にするNULL
overwriteTRUEで、空でないファイルが既にあっても取り直す。取り直したファイルはユーザーのキャッシュに保存し、導入済みのパッケージは変えないFALSE
quietTRUEで進み具合とメッセージを表示しないFALSE
max_retriesファイル・取得先ごとの再試行回数3
mirrors末尾が/の取得先URLの文字列ベクトル。NULLでパッケージ既定の取得先を使うNULL
use_checksumTRUEで、SHA-256のチェックサムがあれば照合するTRUE
checksumsSHA-256の値を名前付きの文字列ベクトルで指定。NULLでパッケージ既定の値を使うNULL
resume途中まで取得した.partファイルを、HTTPの範囲指定で続きから取得するかTRUE
local_dirs取得を試みる前に探すフォルダの文字列ベクトルNULL
# 世界地図のデータを確認し、無ければ取得
geo_path <- check_geodata(
  c("world_countries.rda", "world_coastlines.rda", "world_boundaries.rda"),
  quiet = TRUE
)

# 保存先のフォルダは環境で変わるので、ファイル名だけを表示
basename(geo_path)
[1] "world_countries.rda"  "world_coastlines.rda" "world_boundaries.rda"

中国の行政区画の地図を作る:geom_mapcnコマンド

同梱の行政区画のデータを読み込み、ggplot2のレイヤーにします。filter_attributeとfilterで一部の省だけを取り出せるので、全体の地図に重ねると特定の省を色分けできます。

オプション意味初期値
dataプロットする図形を持つsfオブジェクト。NULLでadmin_levelに対応する同梱データを読み込むNULL
admin_level行政区画の単位。”province”(省)、”city”(市)、”county”(県)のいずれか“province”
crsプロットに使う座標参照系。PROJの文字列かEPSGコードを指定。初期値は中国を中心とする正距方位図法“+proj=aeqd +lat_0=35 +lon_0=105 +ellps=WGS84 +units=m +no_defs”
color境界線の色“black”
fill塗りつぶしの色“white”
linewidth境界線の太さ0.1
filter_attribute絞り込みに使う属性の列名(例: 省の英語名なら”name”)NULL
filterfilter_attributeの列で残す値の文字列ベクトル。一つも残らないとエラーになるNULL
mappingggplot2::geom_sfへ渡す審美的属性の対応付け。dataの列を塗り分けに使うときに指定NULL
…ggplot2::geom_sfへ渡すその他のオプションなし
# 全体の省の地図に、茶どころのある省を重ねてプロット
ggplot() +
  geom_mapcn(fill = "grey95", color = "grey40") +
  geom_mapcn(
    filter_attribute = "name",
    filter = tea_prov,
    fill = "darkseagreen3",
    color = "grey40"
  ) +
  theme_minimal()

全体の省の地図に、茶どころのある省を重ねてプロット

経度・緯度の表から地点を重ねる:geom_locコマンド

経度・緯度の列名を渡すと、地図と同じ座標参照系に変換して点を打ちます。mappingで点の色や大きさに列を割り当てられます。

オプション意味初期値
data地点のデータ。データフレーム、tibble、sfオブジェクトのいずれかなし
lon経度の列名。dataが表形式のときは必須NULL
lat緯度の列名。dataが表形式のときは必須NULL
crs変換先の座標参照系“+proj=aeqd +lat_0=35 +lon_0=105 +ellps=WGS84 +units=m +no_defs”
mappingggplot2::aesで作る審美的属性の対応付け(色や大きさなど)ggplot2::aes()
…ggplot2::geom_sfへ渡すその他のオプション(size、alpha、colorなど)なし
# 茶どころを茶の種類で色分けし、試飲点を点の大きさにする
p_tea <- ggplot() +
  geom_mapcn(fill = "white", color = "grey60") +
  geom_loc(
    data = tea_site,
    lon = "lon",
    lat = "lat",
    mapping = aes(color = type, size = score),
    alpha = 0.8
  ) +
  theme_minimal()

# プロット
p_tea

プロット

スケールバーを付ける:annotation_scalebarコマンド

地図の隅にスケールバーを付けます。単位は座標参照系から判定され、距離に合わせてmからkmへ繰り上がります。

オプション意味初期値
mappingggplot2のレイヤーの標準オプション(通常は使わない)NULL
dataggplot2のレイヤーの標準オプション(通常は使わない)NULL
…レイヤーへ渡すその他のオプション(通常は不要)なし
location配置の位置。”bl”、”br”、”tr”、”tl”のいずれか“bl”
styleスケールバーの形。”segment”、”bar”、”ticks”のいずれか“segment”
fixed_widthバーの幅を座標系の単位(メートルなど)で固定する。自動の幅より優先NULL
crs_unit座標系の単位(”m”、”ft”、”°”など)。自動で判定できないときだけ指定NULL
crsプロット側に座標系が無いときに使う座標参照系。sf::st_crsのオブジェクトかPROJの文字列NULL
display_unit目盛りの表示単位(”m”、”km”など)。geographic_mode = “degrees”のときは無視NULL
unit_labels単位の表示名を名前付きの文字列ベクトルで指定NULL
width_hintパネルの幅に対するバーの幅の割合の目安。0より大きく1以下0.25
unit_category“metric”(メートル法)か”imperial”(ヤード・ポンド法)。単位の自動の繰り上げ(m→km、ft→mi)に効く“metric”
bar_cols“bar”の形で交互に塗る2色c(“black”, “white”)
line_width外枠と目盛りの線の太さ1
heightバーの高さgrid::unit(0.25, “cm”)
pad_xパネルの端からの横の余白grid::unit(0.25, “cm”)
pad_yパネルの端からの縦の余白grid::unit(0.25, “cm”)
text_padバーと目盛りの文字の間隔grid::unit(0.15, “cm”)
text_cex目盛りの文字の大きさ(倍率)0.7
text_face目盛りの文字の書体(太字など)NULL
text_family目盛りの文字のフォント“”
tick_height“ticks”の形での内側の目盛りの相対的な高さ。0から10.6
segments“segment”の形での大きな区切りの数。NULLで読みやすい数を自動で選ぶNULL
label_show文字を付ける目盛り。”ends”、”all”、”major”、数値の間隔、何番目かを示す数値ベクトルのいずれか“ends”
minor_tick_height“segment”の形での小さな目盛りの相対的な高さ。0から10.5
geographic_mode地理座標系のときの表示。”approx_m”でおおよそのメートル・キロメートル(近似である旨の警告を出す)、”degrees”で度のままc(“approx_m”, “degrees”)
text_col目盛りの文字の色“black”
line_col外枠と目盛りの線の色“black”
# 左下に白黒交互のバーで、パネル幅の3割ほどのスケールバーを付ける
p_tea +
  annotation_scalebar(location = "bl", style = "bar", width_hint = 0.3)

左下に白黒交互のバーで、パネル幅の3割ほどのスケールバーを付ける

方位記号を付ける:annotation_compassコマンド

地図の隅に方位記号を付けます。styleで形を選び、compass_sinan(指南)、compass_rose_classic、north_arrow_solidなどのスタイルのコマンドを渡します。

オプション意味初期値
mappingggplot2のレイヤーの標準オプション(通常は使わない)NULL
dataggplot2のレイヤーの標準オプション(通常は使わない)NULL
…レイヤーへ渡すその他のオプション(通常は不要)なし
location配置の位置。”tl”、”tr”、”bl”、”br”のいずれか“bl”
which_north北の基準。”grid”(図の上方向)か”true”(真北)“grid”
height方位記号の枠の高さunit(1.5, “cm”)
width方位記号の枠の幅unit(1.5, “cm”)
pad_xパネルの端からの横の余白unit(0.5, “cm”)
pad_yパネルの端からの縦の余白unit(0.5, “cm”)
rotation回転角を度(反時計回り)で固定する。指定すると”grid”・”true”より優先NULL
style方位記号の形。grob、gList・gTree、grobを返すコマンド(north_arrow_classicなど)のいずれかnorth_arrow_classic()
# 右上に初期値の方位記号、左上に指南の形の方位記号を付ける
p_tea +
  annotation_compass(location = "tr") +
  annotation_compass(location = "tl", style = compass_sinan())

右上に初期値の方位記号、左上に指南の形の方位記号を付ける

標準の方位記号の色や太さを変える:north_arrow_classicコマンド

annotation_compassのstyleに渡す方位記号の見た目を決めます。which_north = “true”にすると、投影でずれた真北の向きに記号が回ります。

オプション意味初期値
fill多角形の塗りつぶしの色。形によっては交互に塗る色を並べて指定c(“white”, “black”)
line_col外枠の線の色“black”
line_width外枠の線の太さ2
text_col文字の色“black”
text_size文字の大きさ(ポイント)12
text_face文字の書体(”plain”、”bold”など)“plain”
text_family文字のフォント“”
# 宇治茶の色に合わせた方位記号を、真北の向きで右上に付ける
p_tea +
  annotation_compass(
    location = "tr",
    which_north = "true",
    style = north_arrow_classic(
      fill = c("darkseagreen3", "darkgreen"),
      line_width = 1.5,
      text_col = "darkgreen"
    )
  )

宇治茶の色に合わせた方位記号を、真北の向きで右上に付ける

経緯度線とラベルを付ける:annotation_graticuleコマンド

経緯度線とその度数のラベルを付けます。投影した地図ではcrsを地図と同じにし、label_offsetをメートル単位の大きな値にします。

オプション意味初期値
xlim経度の範囲を度でc(最小, 最大)と指定(WGS84)。xlimとylimが両方NULLなら地球全体NULL
ylim緯度の範囲を度でc(最小, 最大)と指定(WGS84)。xlimとylimが両方NULLなら地球全体NULL
crs経緯度線の座標参照系。地図のレイヤーやcoord_sfと同じものにする“+proj=longlat +datum=WGS84”
lon_step経線の間隔(度)60
lat_step緯線の間隔(度)30
line_color経緯度線の色“grey70”
line_width経緯度線の太さ0.3
line_type経緯度線の線種“dashed”
label_colorラベルの色“grey30”
label_sizeラベルの大きさ(mm。ggplot2::geom_textへ渡す)3
label_offset全ラベル共通のずらし幅。座標系の単位で指定し、投影座標系(メートル)では大きな値にする5
label_offset_lon経度のラベルだけのずらし幅。指定するとlabel_offsetより優先NULL
label_offset_lat緯度のラベルだけのずらし幅。指定するとlabel_offsetより優先NULL
sidesラベルを付ける辺。”bottom”、”top”、”left”、”right”の組み合わせc(“left”, “bottom”)
…経緯度線のレイヤー(ggplot2::geom_sf)へ渡すその他のオプションなし
line_alpha経緯度線の透明度。0から11
label_familyラベルのフォント(”sans”、”serif”、”mono”など)“”
label_alphaラベルの透明度。0から11
label_angleラベルの回転角(度)0
label_format度のラベルの書式を決めるコマンド。NULLでN・S・E・W付きの標準の表記NULL
# 中国の地図と同じ正距方位図法
china_proj <- "+proj=aeqd +lat_0=35 +lon_0=105 +ellps=WGS84 +units=m +no_defs"

# 東経70〜140度・北緯15〜55度に10度間隔の経緯度線を付けてプロット
ggplot() +
  geom_mapcn(fill = "white", color = "grey60") +
  annotation_graticule(
    xlim = c(70, 140),
    ylim = c(15, 55),
    crs = china_proj,
    lon_step = 10,
    lat_step = 10,
    label_offset = 3e5,
    line_color = "grey80"
  ) +
  coord_sf(crs = china_proj) +
  theme_void()

東経70〜140度・北緯15〜55度に10度間隔の経緯度線を付けてプロット

投影した地図の範囲を経度・緯度で決める:coord_projコマンド

投影した地図の表示範囲を、経度・緯度のまま指定します。ここでは京都と、京都市の姉妹都市の西安を、両者の中間を中心にした世界地図に載せます。

オプション意味初期値
crs出力の座標参照系(”EPSG:3857″、”+proj=robin”、sf::crsオブジェクトなど)。必須NULL
xlim経度の範囲(度、WGS84)NULL
ylim緯度の範囲(度、WGS84)NULL
expandggplot2::coord_sfへ渡す。TRUEで範囲に余白を足すTRUE
default_crsxlimとylimを指定する座標参照系“EPSG:4326”
…ggplot2::coord_sfへ渡すその他のオプションなし
# 京都と西安の位置
kyoto_link <- data.frame(
  city = c("Kyoto", "Xian"),
  lon  = c(135.77, 108.94),
  lat  = c(35.01, 34.34)
)

# 京都と西安の中間(東経122度)を中心にした正距方位図法
crs_kx <- "+proj=aeqd +lat_0=35 +lon_0=122 +ellps=WGS84 +units=m +no_defs"

# 東経100〜145度・北緯20〜45度の範囲でプロット
ggplot() +
  geom_world(crs = crs_kx) +
  geom_loc(
    data = kyoto_link, lon = "lon", lat = "lat", crs = crs_kx,
    color = "firebrick", size = 3
  ) +
  coord_proj(crs = crs_kx, xlim = c(100, 145), ylim = c(20, 45)) +
  theme_minimal()

東経100〜145度・北緯20〜45度の範囲でプロット

標高のレイヤーを作る:basemap_demコマンド

中国周辺の標高データを、ggplot2のレイヤーにします。初回は標高データ(gebco_2024_China.tif)のダウンロードが要ります。色はtidyterraパッケージのスケールで付けます。

オプション意味初期値
data独自の標高データ(terraのラスター)NULL
crs投影に使う座標参照系。NULLで標高データの座標系のままNULL
within_chinaTRUEで中国の境界の内側だけを表示。FALSEで中国を囲む長方形の範囲を表示FALSE
maxcell表示に使うセル数の上限(表示を軽くするため)1e+06
na.rmTRUEで欠測値を除くFALSE
…tidyterra::geom_spatrasterへ渡すその他のオプションなし
# 標高データと中国の範囲のデータを確認し、無ければ取得
dem_path <- check_geodata(c("gebco_2024_China.tif", "China_mask.gpkg"), quiet = TRUE)

# 中国の内側の標高に、茶どころを重ねてプロット
ggplot() +
  basemap_dem(crs = china_proj, within_china = TRUE) +
  geom_boundary_cn(crs = china_proj) +
  tidyterra::scale_fill_hypso_c(
    palette = "dem_print",
    breaks = c(0, 2000, 4000, 6000),
    limits = c(0, 7000)
  ) +
  geom_loc(
    data = tea_site, lon = "lon", lat = "lat", crs = china_proj,
    color = "darkgreen", size = 2
  ) +
  labs(fill = "Elevation (m)") +
  theme_minimal()
<SpatRaster> resampled to 1000968 cells.

中国の内側の標高に、茶どころを重ねてプロット


この記事が誰かの役に立ちますように。

スポンサーリンク
価格および配送状況は変更される場合があります。購入時は商品ページをご確認ください。
当サイトに表示されている商品情報はAmazonから提供されたものであり、更新または削除される場合があります。
karada-goodはAmazonアソシエイトとして、適格販売により収入を得ています。