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

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

Rで解析:エクアドルの州・郡・教区の地図を読み込み手元の表と結合する「geoecu」パッケージ

「geoecu」パッケージは、エクアドルの州・郡・教区の境界を、行政区分コード(DPA)付きの地図データとして1行で読み込めるパッケージです。渡すのは州や郡のコード、または名前の列を持つデータフレームで、Excelから持ってきて先頭の0が落ちたコードでも、そのまま地図に結合して塗り分けられます。地図データはsfオブジェクトで返るのでsfパッケージが要り、初回だけ境界データをインターネットからダウンロードします。地図向けの軽い版と、空間解析向けの詳しい版の2種類から選べます。エクアドルの統計や調査の結果を、地域ごとに地図で確かめるときに役立てることができるのではないかと考えます。

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

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

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

# パッケージのインストール
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()

郡を面積で塗り分けてプロット

教区の境界を読み込む: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"

手元の表を地図に結合する:geoecu_unirコマンド

オプション意味初期値
datos行政区分コードの列を持つデータフレームなし
codigodatosのうち、コードが入っている列の名前なし
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コマンド

オプション意味初期値
xdpa_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コマンド

オプション意味初期値
xgeoecuの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()

移したガラパゴス諸島を枠で囲んでプロット

境界データが手元にあるかを確かめる: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)

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

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