Rで解析:中国の省・市・県の地図に地点や方位記号、スケールバーを重ねる「ggmapcn」パッケージ
「ggmapcn」パッケージは、中国の省・市・県の境界や世界地図をggplot2のレイヤーとして読み込み、地点や方位記号、スケールバー、経緯度線を重ねた地図を作れるパッケージです。地点は経度・緯度の列を持つデータフレームか、sfオブジェクトで渡します。ggplot2の上に乗る拡張で、中国の行政区画は同梱されていますが、世界地図と標高のデータは初回にダウンロードが要ります。地図の投影を変えても経度・緯度のまま範囲を指定できるので、中国を含むアジアの調査地点を地図で見せたい場面で活用できるのではないかと考えます。
パッケージバージョンは0.3.1。Windows 11 x64 (build 26200)のR version 4.6.1で確認しています。
<おすすめのRに関する書籍です>
パッケージのインストール
下記コマンドを実行してください。
# パッケージのインストール
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 |
| overwrite | TRUEで、空でないファイルが既にあっても取り直す。取り直したファイルはユーザーのキャッシュに保存し、導入済みのパッケージは変えない | FALSE |
| quiet | TRUEで進み具合とメッセージを表示しない | FALSE |
| max_retries | ファイル・取得先ごとの再試行回数 | 3 |
| mirrors | 末尾が/の取得先URLの文字列ベクトル。NULLでパッケージ既定の取得先を使う | NULL |
| use_checksum | TRUEで、SHA-256のチェックサムがあれば照合する | TRUE |
| checksums | SHA-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 |
| filter | filter_attributeの列で残す値の文字列ベクトル。一つも残らないとエラーになる | NULL |
| mapping | ggplot2::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” |
| mapping | ggplot2::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へ繰り上がります。
| オプション | 意味 | 初期値 |
|---|---|---|
| mapping | ggplot2のレイヤーの標準オプション(通常は使わない) | NULL |
| data | ggplot2のレイヤーの標準オプション(通常は使わない) | 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から1 | 0.6 |
| segments | “segment”の形での大きな区切りの数。NULLで読みやすい数を自動で選ぶ | NULL |
| label_show | 文字を付ける目盛り。”ends”、”all”、”major”、数値の間隔、何番目かを示す数値ベクトルのいずれか | “ends” |
| minor_tick_height | “segment”の形での小さな目盛りの相対的な高さ。0から1 | 0.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などのスタイルのコマンドを渡します。
| オプション | 意味 | 初期値 |
|---|---|---|
| mapping | ggplot2のレイヤーの標準オプション(通常は使わない) | NULL |
| data | ggplot2のレイヤーの標準オプション(通常は使わない) | 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から1 | 1 |
| label_family | ラベルのフォント(”sans”、”serif”、”mono”など) | “” |
| label_alpha | ラベルの透明度。0から1 | 1 |
| 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 |
| expand | ggplot2::coord_sfへ渡す。TRUEで範囲に余白を足す | TRUE |
| default_crs | xlimと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_china | TRUEで中国の境界の内側だけを表示。FALSEで中国を囲む長方形の範囲を表示 | FALSE |
| maxcell | 表示に使うセル数の上限(表示を軽くするため) | 1e+06 |
| na.rm | TRUEで欠測値を除く | 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.中国の内側の標高に、茶どころを重ねてプロット

<おすすめのRに関する書籍です>
この記事が誰かの役に立ちますように。