Rで解析:エクアドルの州・郡・教区の地図を読み込み手元の表と結合する「geoecu」パッケージ
「geoecu」パッケージは、エクアドルの州・郡・教区の境界を、行政区分コード(DPA)付きの地図データとして1行で読み込めるパッケージです。渡すのは州や郡のコード、または名前の列を持つデータフレームで、Excelから持ってきて先頭の0が落ちたコードでも、そのまま地図に結合して塗り分けられます。地図データはsfオブジェクトで返るのでsfパッケージが要り、初回だけ境界データをインターネットからダウンロードします。地図向けの軽い版と、空間解析向けの詳しい版の2種類から選べます。エクアドルの統計や調査の結果を、地域ごとに地図で確かめるときに役立てることができるのではないかと考えます。
パッケージバージョンは0.4.1。Windows 11 x64 (build 26200)のR version 4.6.1で確認しています。
<おすすめのRに関する書籍です>
パッケージのインストール
下記コマンドを実行してください。
# パッケージのインストール
install.packages("geoecu")
# プロットで使うパッケージのインストール
install.packages("ggplot2")
# パッケージの読み込み
library("geoecu")
Warning message:
package 'geoecu' was built under R version 4.6.2
library("ggplot2")コマンド例
エクアドルの行政区画は、州(provincia)、郡(cantón)、教区(parroquia)の3段です。それぞれに行政区分コード(DPA)があり、州は2桁、郡は4桁、教区は6桁で、上の段のコードが先頭に入ります。例えば州「AZUAY」は01、その中の郡「CUENCA」は0101です。
コマンド例では、京都の茶舗がエクアドルの各州へ送った宇治茶の量(kg)を架空のデータとして作り、地図と結合します。州のコードは、Excelから読み込んだときのように先頭の0が落ちた数値にしています。
# 宇治茶を送った州のコード(先頭の0が落ちた数値)と量
set.seed(1201)
cha <- data.frame(
cod = c(1, 2, 6, 9, 10, 11, 13, 17, 18, 20, 23, 24),
kg = round(runif(12, 20, 300))
)
cha
cod kg
1 1 30
2 2 258
3 6 118
4 9 122
5 10 81
6 11 271
7 13 175
8 17 140
9 18 237
10 20 206
11 23 73
12 24 188州の境界を読み込む:read_provinciasコマンド
| オプション | 意味 | 初期値 |
|---|---|---|
| provincia | 読み込む州。名前(アクセント記号と大文字小文字は区別しない)またはコードで指定。”Loja”、”11″、11のどれでもよい。NULLで国全体 | NULL |
| resolucion | 解像度。”baja”は地図や集計画面向けの軽い版、”alta”は空間解析向けの詳しい版 | c(“baja”, “alta”) |
| crs | 出力する座標参照系。既定はWGS84(EPSG:4326)。本土で距離をメートルで求めるなら32717(UTM 17S)。面積はarea_km2列か、6933などの正積図法を使う | 4326 |
# 国全体の州を読み込む
provincias <- read_provincias()
# 地図データを除いた列を確認
head(sf::st_drop_geometry(provincias))
dpa_provin provincia tipo area_km2
1 01 AZUAY provincia 8170.524
2 02 BOLÍVAR provincia 3955.740
3 03 CAÑAR provincia 3227.251
4 04 CARCHI provincia 3776.231
5 05 COTOPAXI provincia 6183.837
6 06 CHIMBORAZO provincia 5923.301
# 州の境界をプロット
ggplot(provincias) +
geom_sf(fill = "#E8F1DC", color = "#2F6B2F") +
theme_void()州の境界をプロット

郡の境界を読み込む:read_cantonesコマンド
| オプション | 意味 | 初期値 |
|---|---|---|
| provincia | 読み込む州。名前(アクセント記号と大文字小文字は区別しない)またはコードで指定。”Loja”、”11″、11のどれでもよい。NULLで国全体 | NULL |
| canton | 読み込む郡。名前またはコードで指定。BolívarやOlmedoのように複数の州に同じ名前があるときは、コードを使うかprovinciaも指定する | NULL |
| resolucion | 解像度。”baja”は地図や集計画面向けの軽い版、”alta”は空間解析向けの詳しい版 | c(“baja”, “alta”) |
| crs | 出力する座標参照系。既定はWGS84(EPSG:4326)。本土で距離をメートルで求めるなら32717(UTM 17S)。面積はarea_km2列か、6933などの正積図法を使う | 4326 |
# 首都キトのある州「Pichincha」の郡を読み込む
pichincha <- read_cantones(provincia = "Pichincha")
# 郡のコード・名前・面積を確認
sf::st_drop_geometry(pichincha)[, c("dpa_canton", "canton", "area_km2")]
dpa_canton canton area_km2
1 1701 DISTRITO METROPOLITANO DE QUITO 4196.306
2 1702 CAYAMBE 1199.071
3 1703 MEJÍA 1409.820
4 1704 PEDRO MONCAYO 334.320
5 1705 RUMIÑAHUI 135.281
6 1707 SAN MIGUEL DE LOS BANCOS 854.979
7 1708 PEDRO VICENTE MALDONADO 618.381
8 1709 PUERTO QUITO 695.605
# 郡を面積で塗り分けてプロット
ggplot(pichincha) +
geom_sf(aes(fill = area_km2), color = "white") +
scale_fill_gradient(low = "#E8F1DC", high = "#2F6B2F") +
theme_void()郡を面積で塗り分けてプロット

<おすすめのRに関する書籍です>
教区の境界を読み込む:read_parroquiasコマンド
| オプション | 意味 | 初期値 |
|---|---|---|
| provincia | 読み込む州。名前(アクセント記号と大文字小文字は区別しない)またはコードで指定。”Loja”、”11″、11のどれでもよい。NULLで国全体 | NULL |
| canton | 読み込む郡。名前またはコードで指定。BolívarやOlmedoのように複数の州に同じ名前があるときは、コードを使うかprovinciaも指定する | NULL |
| tipo | 教区の種類。”cabecera”(郡の中心の教区)、”rural”(農村の教区)、”zona”(境界が未確定の地域)、NULL(すべて)。c(“cabecera”, “rural”)のように組み合わせられる | NULL |
| resolucion | 解像度。”baja”は地図や集計画面向けの軽い版、”alta”は空間解析向けの詳しい版 | c(“baja”, “alta”) |
| crs | 出力する座標参照系。既定はWGS84(EPSG:4326)。本土で距離をメートルで求めるなら32717(UTM 17S)。面積はarea_km2列か、6933などの正積図法を使う | 4326 |
| area | 廃止予定。tipoを使う。”rural”はtipo = “rural”、”urbana”はtipo = “cabecera”と同じ | NULL |
# 州「Azuay」の教区を読み込む
azuay <- read_parroquias(provincia = "Azuay")
# 教区の種類ごとの数を確認
table(azuay$tipo)
cabecera cantonal parroquia rural
15 61
# 教区を種類で塗り分けてプロット
ggplot(azuay) +
geom_sf(aes(fill = tipo), color = "white") +
scale_fill_manual(values = c("#2F6B2F", "#B5D39A")) +
theme_void()教区を種類で塗り分けてプロット

名前やコードで行政区画を探す:buscar_dpaコマンド
| オプション | 意味 | 初期値 |
|---|---|---|
| texto | 探す文字列。名前の一部またはコード | なし |
| nivel | 探す段。”parroquia”(教区)、”canton”(郡)、”provincia”(州) | c(“parroquia”, “canton”, “provincia”) |
# 名前に「santa rosa」を含む教区を探す
buscar_dpa("santa rosa")
dpa_parroq parroquia tipo dpa_canton canton
1 071250 SANTA ROSA cabecera cantonal 0712 SANTA ROSA
2 091153 SANTA ROSA DE FLANDES parroquia rural 0911 NARANJAL
3 150454 SANTA ROSA parroquia rural 1504 EL CHACO
4 170255 SANTA ROSA DE CUZUBAMBA parroquia rural 1702 CAYAMBE
5 180165 SANTA ROSA parroquia rural 1801 AMBATO
6 200352 SANTA ROSA parroquia rural 2003 SANTA CRUZ
7 210651 SANTA ROSA DE SUCUMBÍOS parroquia rural 2106 CASCALES
dpa_provin provincia
1 07 EL ORO
2 09 GUAYAS
3 15 NAPO
4 17 PICHINCHA
5 18 TUNGURAHUA
6 20 GALÁPAGOS
7 21 SUCUMBÍOS
# 同じ名前の郡が複数の州にあるかを確かめる
buscar_dpa("bolivar", nivel = "canton")
dpa_canton canton dpa_provin provincia
1 0402 BOLÍVAR 04 CARCHI
2 0922 SIMÓN BOLÍVAR 09 GUAYAS
3 1302 BOLÍVAR 13 MANABÍ地名の表記を揃える:normalizar_nombreコマンド
| オプション | 意味 | 初期値 |
|---|---|---|
| x | 文字列のベクトル | なし |
# アクセント記号・大文字小文字・前後の空白が混ざった州名を揃える
normalizar_nombre(c("Bolívar", " Galápagos ", "SUCUMBÍOS"))
[1] "BOLIVAR" "GALAPAGOS" "SUCUMBIOS"行政区分コードの桁を揃える:formatear_codigoコマンド
| オプション | 意味 | 初期値 |
|---|---|---|
| x | コードのベクトル(数値または文字列) | なし |
| nivel | コードの段。”provincia”(2桁)、”canton”(4桁)、”parroquia”(6桁) | c(“parroquia”, “canton”, “provincia”) |
# 共通データの州のコードを2桁の文字列に揃える
formatear_codigo(cha$cod, nivel = "provincia")
[1] "01" "02" "06" "09" "10" "11" "13" "17" "18" "20" "23" "24"
# 郡のコードを4桁に揃える
formatear_codigo(c(901, 1701), nivel = "canton")
[1] "0901" "1701"
<おすすめのRに関する書籍です>
手元の表を地図に結合する:geoecu_unirコマンド
| オプション | 意味 | 初期値 |
|---|---|---|
| datos | 行政区分コードの列を持つデータフレーム | なし |
| codigo | datosのうち、コードが入っている列の名前 | なし |
| nivel | コードの段。”provincia”(州)、”canton”(郡)、”parroquia”(教区) | c(“canton”, “provincia”, “parroquia”) |
| … | 対応するread_*()コマンドに渡すオプション(provincia、resolucion、crsなど) | なし |
# 宇治茶の量を州の地図に結合する(先頭の0は自動で補われる)
mapa <- geoecu_unir(cha, codigo = "cod", nivel = "provincia")
head(sf::st_drop_geometry(mapa))
dpa_provin provincia tipo area_km2 kg
1 01 AZUAY provincia 8170.524 30
2 02 BOLÍVAR provincia 3955.740 258
3 03 CAÑAR provincia 3227.251 NA
4 04 CARCHI provincia 3776.231 NA
5 05 COTOPAXI provincia 6183.837 NA
6 06 CHIMBORAZO provincia 5923.301 118
# 宇治茶の量で州を塗り分けてプロット
ggplot(mapa) +
geom_sf(aes(fill = kg)) +
scale_fill_gradient(low = "#E8F1DC", high = "#2F6B2F", na.value = "grey90") +
theme_void()
# 州「Azuay」の郡ごとの量を、州を絞って結合する
kanton <- data.frame(cod = c(101, 102, 103, 104), kg = c(120, 45, 30, 15))
azuay_cha <- geoecu_unir(kanton,
codigo = "cod", nivel = "canton",
provincia = "Azuay"
)
sf::st_drop_geometry(azuay_cha)[, c("dpa_canton", "canton", "kg")]
dpa_canton canton kg
1 0101 CUENCA 120
2 0102 GIRÓN 45
3 0103 GUALACEO 30
4 0104 NABÓN 15
5 0105 PAUTE NA
6 0106 PUCARÁ NA
7 0107 SAN FERNANDO NA
8 0108 SANTA ISABEL NA
9 0109 SÍGSIG NA
10 0110 OÑA NA
11 0111 CHORDELEG NA
12 0112 EL PAN NA
13 0113 SEVILLA DE ORO NA
14 0114 GUACHAPALA NA
15 0115 CAMILO PONCE ENRÍQUEZ NA宇治茶の量で州を塗り分けてプロット

古い教区コードを今のコードに直す:actualizar_codigoコマンド
2026年7月の行政区画の見直しで、郡の中心の教区(都市部)は1つの教区にまとめられ、一部の郡はコードが変わりました。古いコードで集計した表は、このコマンドで今のコードに直してから結合します。
| オプション | 意味 | 初期値 |
|---|---|---|
| x | 教区のコードのベクトル(数値または文字列) | なし |
# 古いコードで記録した教区ごとの宇治茶の量
furui <- data.frame(
cod = c("010101", "010102", "010150", "080253"),
kg = c(3, 4, 1, 6)
)
# コードを今のものに直す
furui$cod <- actualizar_codigo(furui$cod)
# 同じコードにまとまった教区の量を合計
aggregate(kg ~ cod, data = furui, FUN = sum)
cod kg
1 010150 8
2 080950 6ガラパゴス諸島を本土の横に移す:reubicar_galapagosコマンド
| オプション | 意味 | 初期値 |
|---|---|---|
| x | dpa_provin列を持ち、本土とガラパゴス諸島を含むgeoecuのsfオブジェクト。UTM 17S(crs = 32717)などの投影座標系がよい | なし |
| separacion | ガラパゴス諸島と本土の間隔。本土の幅に対する割合 | 0.06 |
# 宇治茶の量をUTM 17Sの州の地図に結合し、ガラパゴス諸島を本土の横に移す
mapa_utm <- geoecu_unir(cha, codigo = "cod", nivel = "provincia", crs = 32717)
mapa_utm <- reubicar_galapagos(mapa_utm)
# 移したあとの地図をプロット
ggplot(mapa_utm) +
geom_sf(aes(fill = kg)) +
scale_fill_gradient(low = "#E8F1DC", high = "#2F6B2F", na.value = "grey90") +
theme_void()移したあとの地図をプロット

ガラパゴス諸島の枠を作る:marco_galapagosコマンド
| オプション | 意味 | 初期値 |
|---|---|---|
| x | geoecuのsfオブジェクト。ふつうはreubicar_galapagos()を通したもの | なし |
| margen | 島の周りの余白。諸島の幅に対する割合 | 0.06 |
# 移したガラパゴス諸島を枠で囲んでプロット
ggplot(mapa_utm) +
geom_sf(aes(fill = kg)) +
geom_sf(
data = marco_galapagos(mapa_utm, margen = 0.1),
fill = NA, color = "grey40"
) +
scale_fill_gradient(low = "#E8F1DC", high = "#2F6B2F", na.value = "grey90") +
theme_void()移したガラパゴス諸島を枠で囲んでプロット

<おすすめのRに関する書籍です>
境界データが手元にあるかを確かめる:geoecu_datos_disponiblesコマンド
| オプション | 意味 | 初期値 |
|---|---|---|
| resolucion | 確かめる解像度。”baja”または”alta” | “baja” |
# 軽い版の境界データがダウンロード済みかを確かめる
geoecu_datos_disponibles()
[1] TRUE
# 詳しい版の境界データがダウンロード済みかを確かめる
geoecu_datos_disponibles(resolucion = "alta")
[1] FALSE境界データの置き場所を指定する:geoecu_usar_carpetaコマンド
インターネットにつながらない環境では、境界データのファイルを置いたフォルダを指定して読み込みます。戻り値は直前の設定なので、それを渡すと元に戻せます。
| オプション | 意味 | 初期値 |
|---|---|---|
| carpeta | フォルダのパス。NULLで既定の動き(キャッシュとダウンロード)に戻す | なし |
# 一時フォルダを境界データの置き場所にし、直前の設定を控える
anterior <- geoecu_usar_carpeta(tempdir())
# 控えた設定に戻す
geoecu_usar_carpeta(anterior)この記事が誰かの役に立ちますように。