Morocco communes

モロッコのコミューン

モロッコの行政区画に関するオープンデータセットと HTTP API です。12 のレジオン、75 のプロヴィンスおよびプレフェクチュール、8 のプレフェクチュール・ダロンディスマン、213 のセルクル、1,503 のコミューン、41 のダロンディスマンを収録しています。HCP の公式地理コード、フランス語名とアラビア語名、2024 年と 2014 年の人口、両年の HCP 国勢調査に基づく年齢、教育、言語、仕事、住居に関する数値、2024 年の経済事業所数、農村コミューンのドゥアール、OpenStreetMap に基づく境界も含まれます。

HCP は国勢調査データをスプレッドシートで公開しています。このプロジェクトでは、それらと OpenStreetMap からデータセット、API、サイトを構築し、その手順を公開しています。

データセット

data/v1/ はコミットされ、バージョン管理されているため、API を使わずに利用できます。 CHANGELOG.md には各バージョンで追加された内容が記載されています。ビルド時に、記載のないバージョンは拒否されます。

ディレクトリ	内容	ライセンス
attributes/	すべての行政区画、JSON および CSV	HCP、CC BY 4.0 条件
geometry/	レジオンごとの TopoJSON、および隣接するコミューンの一覧	ODbL、継承
indicators/	すべての行政区画の国勢調査指標、2024 年と 2014 年、JSON および CSV	HCP、CC BY 4.0 条件
economy/	すべての行政区画の 2024 年の経済事業所数、JSON および CSV	HCP、CC BY 4.0 条件
housing/	2024 年の都市部の住宅ストック、住戸ごと、JSON および CSV	HCP、CC BY 4.0 条件
douars/	2024 年の農村コミューンにある 33,189 のドゥアール、フラクションごと、JSON および CSV	HCP、CC BY 4.0 条件
crosswalk/	2014 年 ↔ 2024 年の対応表	HCP、CC BY 4.0 条件
insights/	各コミューンで特筆すべき 2024 年の数値。近隣の数値と 2014 年の数値も併記、JSON	このリポジトリ独自の行、数値は HCP、CC BY 4.0 条件
sources.json	各ソースのダイジェスト、ライセンス、データ時点

ライセンスはディレクトリごとに異なり、geometry/ には独自の LICENSE が含まれます。各コミューンの 5 つのフィールド（centroid、bbox、osm、areaKm2、density）は OpenStreetMap に由来し、これらも ODbL の対象です。provenance.geometry でその由来を示しています。すべての行政階層に、アラビア語を含め Excel で問題なく開ける CSV があります。

pnpm dataset:build で再構築できます。同じキャッシュからの出力はバイト単位で同一です。

pnpm build はさらに、上記の TopoJSON から境界を GeoJSON として書き出します。各コミューンの境界に加え、コミューンの境界から描画した各プロヴィンスとレジオンの境界も出力します。これらはコミットされず、データセットとともに提供されます。

API

3 つの階層があり、どの階層から応答が返されたかは X-Api-Tier ヘッダーで確認できます。

事前レンダリング。 ビルド時に書き出された 12,723 個のファイルを、コードを実行せずに Cloudflare Pages からそのまま配信します。無料で、利用量に制限はありません。

GET /api/regions.json                        GET /api/regions/01.json
GET /api/regions/01/provinces.json           GET /api/regions/01/communes/page/1.json
GET /api/provinces/01.511.json               GET /api/provinces/01.511/cercles.json
GET /api/cercles/01.511.05.json              GET /api/communes/01.511.01.0.json
GET /api/communes/page/1.json                GET /api/communes/type/urban/page/1.json
GET /api/communes/01.511.01.0/arrondissements.json
GET /api/communes/09.581.01.07/neighbours.json
GET /api/communes/01.511.01.0/indicators.json
GET /api/communes/09.581.01.07/economy.json
GET /api/communes/09.163.07.17/douars.json
GET /api/communes/01.511.01.0/neighbourhoods.json
GET /api/arrondissements/01.511.01.05.json   GET /api/indicators.json
GET /api/economy.json                        GET /api/version.json
GET /data/v1/**

エイリアス。 クエリ文字列を含む形式と、拡張子のない形式です。パスをキーとするアセットストアではクエリ文字列に一致させられないため、Worker はこれらを回答がすでに格納されているファイルに解決し、そのファイルを Content-Location で示します。

GET /api/communes?province=01.511&page=1     GET /api/communes?type=urban
GET /api/communes/tanger                     GET /api/communes/001511010
GET /api/communes/tanger/indicators          GET /api/communes/tiznit/economy

計算。 ファイルに格納されていない回答です。

GET /api/search?q=tanger&levels=commune&limit=10
GET /api/douars/search?q=tachdirt
GET /api/communes/near?lat=33.5731&lng=-7.5898&radius=15
GET /api/communes/at?lat=35.786&lng=-5.8125
GET /api/communes?province=01.511&type=urban
GET /api/communes?sort=-population&min_population=100000
GET /api/communes?region=01&sort=-labour.unemploymentRate
GET /api/communes?sort=-economy.establishments.jobs

一覧は、国勢調査の任意の指標またはパスで並べ替えられます。また、一覧に含まれる各コミューンには、並べ替えに使った数値が付されます。パスの前に 2014. を付けると 2014 年の数値で並べ替えられ、change. を付けると国勢調査間でコミューンがどれだけ変化したかで並べ替えられます。事業所数は economy. の下にあります。

検索にはフランス語、アラビア語、スラッグ、またはコードを使えます。名前に実際に含まれるアレフの異体字、ター・マルブータ、アレフ・マクスーラを正規化し、実際には含まれないものの入力されることのあるタトウィールや母音記号も処理します。子音が同じで綴りが異なる名前にも一致するため、titwan で Tétouan が、jdida で El Jadida が見つかります。01.511.01.0、001511010、1511010、tanger は、いずれも同じコミューンを指します。また、文字の正規化だけでは Fez から Fès、あるいは Port Lyautey から Kénitra を見つけられないため、18 個の別名を手作業で登録しています。地区名から、その地区が属するコミューンまたは区を検索できます。5 桁の郵便番号でも同様です。ドゥアールはアラビア文字またはラテン文字で個別に検索でき、tachdirt と tashdirt はどちらも تشديرت を見つけます。

カウント対象。 エイリアスと計算の各ルート、および MCP サーバーは、Workers Analytics Engine でそれぞれの利用状況を記録します。コードを除いたルート、または MCP メッセージがツールを呼び出した場合はそのツール名、そうでない場合はそのメソッド、MCP クライアントが名乗る名前、User-Agent の最初の単語、国、ステータス、所要時間が記録されます。事前レンダリングされたファイルはコードを実行しないため、カウントされません。pnpm stats でデータを読み出せます。npm、PyPI、GitHub の数値も表示されます。

別のストアである D1 では、5 種類の行をカウントします。検索、開かれた場所、アシスタントが呼び出したツール、MCP クライアントが名乗る名前、ダウンロードされたファイルです。MCP サーバー経由で接続するアシスタントは、名乗った名前でカウントされます。また、呼び出した各ツールは、そのツール名と問い合わせた場所でカウントされます。1 行には 1 日分と少数のカテゴリが記録され、別の行と紐付けられるキー、Cookie、アドレスは含まれません。pnpm demand でデータを読み出せます。サイトの /docs/privacy/ ページに、保存する内容が正確に記載されています。

pnpm deploy:live で有効になります。ライブデータベースにマイグレーションを適用し、そのデータベースから最も検索されたページを読み込んでサイトをビルドし、デプロイした後、夜間ロールアップ Worker をデプロイします。通常の pnpm build はデータベースに問い合わせず、そのページは空のままです。書き込みに失敗してもエラーは無視されるため、デプロイから 1 日後に pnpm demand を実行すると、行が追加されているか確認できます。

すべての応答は data、meta、links でラップされます。エラーは RFC 9457 の問題ドキュメントで返されます。形式が正しいものの存在しないコードは 404、検索できないものは 400 になります。CORS はオープンです。

完全なリファレンス：api/README.md。

プログラムとエージェント向け

• /api/openapi.json：すべてのルートを記述した OpenAPI 3.1 の仕様です。Worker が制限値を読み込むのと同じモジュールから生成されるため、記載されたデフォルト値と上限・下限が実際に適用される値と一致します。多くのエージェントフレームワークでは、これを直接ツールに変換できます。
• /llms.txt：llmstxt.org の形式に沿った、API とデータセットの簡潔な Markdown マップです。サイトを読む LLM 向けです。
• /mcp：13 個の読み取り専用ツール（search、get_commune、get_unit、communes_near、commune_at、list_communes、get_indicators、get_economy、get_housing、get_insights、get_neighbourhoods、get_douars、search_douars）を備えた MCP サーバーです。Claude、Claude Code、その他の MCP クライアントから、国勢調査の数値も含め、データを直接検索できます。各クライアントのセットアップ方法は、サイトの /docs/mcp/ ページに記載されています。

フォームまたはオフラインで

• /components/commune-picker.js：静的ファイルから地域、県、コミューンを<select>に入力するカスタム要素です。これにより、フォームからコミューンのHCPコードを送信できます。オープンCORSで配信され、/docs/components/にはReact版もあります。
• morocco-communes：packages/morocco-communes/にある、npmパッケージとしてのデータセットです。コード、名称、親項目、人口を、レベルごとに型付きのESモジュールとして収録しています。OpenStreetMapのフィールドを含まないため、ODbLの条項は適用されません。pnpm npm:buildでdata/v1からビルドし、パッケージにはデータセットのバージョン番号が適用されます。
• PyPIのmorocco-communes：分析担当者向けの同じデータセットで、packages/morocco-communes-py/にあります。行政単位、2回分の国勢調査、施設、対応表を収録しています。各テーブルはpandasのDataFrame、または標準ライブラリ以外は不要なas_frame=Falseを指定した場合の辞書のリストとして利用できます。pnpm py:buildでdata/v1からデータを圧縮してビルドし、データセットと同じバージョンが適用されます。

ドキュメントサイト

site/ は、英語、フランス語、アラビア語に対応した Astro サイトです。ライトテーマとダークテーマを備え、どちらかを選ぶか、システム設定に従うかを切り替えられます。静的 HTML としてビルドされます。トップページ、注目データのページ、比較ページ、ドゥアールのページ、11 のドキュメントページ（API リファレンス、MCP のセットアップ、コンポーネント、npm パッケージ、Python パッケージ、ダウンロード、国勢調査の数値、用語集、注目データの選定方法、ドゥアールの命名方法、サイトで集計している内容）、そして各地方、県、コミューンのページを生成し、合計 4,845 ページになります。

トップページには、密度、2014 年以降の変化、都市部・農村部のいずれかで色分けされた、すべてのコミューンの地図が表示されます。カーソルを合わせると数値が表示され、クリックするとそのページが開きます。各コミューンのページには、その数値と順位、県の地図、隣接するコミューン、すべてのコミューンの中での変化の位置付け、そして国勢調査の数値が掲載されています。国勢調査の数値には、男女の年齢ピラミッド、女性および全国の数値と並べた主要指標、住民が使う言語が含まれます。すべてのコミューンの一覧は、フランス語またはアラビア語で入力すると絞り込まれます。

JavaScript を使うのは、地図のホバー表示と切り替え、一覧の絞り込み、プレイグラウンド（デプロイ先で利用できる任意の API にクエリを送信し、各レスポンスの X-Api-Tier を表示する Solid アイランド）、コンポーネントページの選択機能、コピー ボタンです。

データや API について説明する内容はすべて、site/scripts/ 以下のスクリプトによってビルド時に生成されます。

• map.ts は、API が提供する TopoJSON からトップページの地図を描画します。共有する境界線は 1 本のアークとして表現し、隣り合う両方のコミューンで同じように簡略化するため、塗りつぶしの間に隙間ができません。色は、どちらのテーマでもコントラストと色覚特性による識別性を確認しています。

• hierarchy.ts は、地方からアロンディスマンまでの実際の階層をたどるコードの連鎖を構築します。

• charts.ts は、地方ごとの人口変化、コミューンの規模の分布、人口の半数が暮らす土地の狭さ、人口が減少したコミューンの数、そしてコードが変わった 207 の対応付け済みコミューンと、コードが変わらなかった 1,286 のコミューンの成長率の分布を計算します。最後のグラフは、照合結果をそれ自体で検証するものです。2 つの分布はほぼ重なります。

• downloads.ts は、data/v1 以下のファイルを実際のサイズとともに一覧表示し、ファイルが存在しない場合はビルドを失敗させます。

• reference.ts は buildOpenApi から API リファレンスを生成します。各例には、生成されたファイルまたは Worker 自体の関数から取得した実際のレスポンスを使用し、クライアントをサーバーに接続して MCP ツールを一覧表示します。フランス語とアラビア語のページでは、仕様書の各行の翻訳を読み込みます。翻訳の欠落や余分な翻訳がある場合、ビルドは失敗します。

地方、県、コミューンのページは site/src/lib/places.ts から生成されます。このファイルはビルドごとに一度 data/v1 を読み込み、順位、共有境界上の点を照合して求めた各コミューンの隣接関係、トップページと同じ方法で描画した小さな地図を作成します。

グラフはインライン SVG と CSS で作成されているため、JavaScript もグラフ描画ライブラリも必要ありません。

アラビア語のページは /ar/ 以下にあり、右から左に読みます。各行政区分のアラビア語名を先に示し、その横に HCP のラテン文字表記を添えます。また、数値はモロッコのアラビア語表記に合わせ、1.503 や 12,8% のように記載します。すべての国勢調査項目には、HCP 独自の用語を使ったアラビア語名が site/src/i18n/fields.ts に定義されています。英語のページと同様に、HCP のフランス語表記もその横に保持します。ヒストグラムや比較用ストリップなど、目盛りのあるグラフは左から右のままです。一覧、棒グラフなど、ページのそれ以外の部分は右から左に切り替わります。

サーバーを必要とする機能がないため静的サイトとなっており、手書きの Worker だけが Worker として残り、ページの配信コストはかかりません。

インサイト

行政区画のページには、2024年の数値のうち、特に目立つものを最大3つ表示できます。行政区画の中で最も高い、または低い数値、2014年以降に他の行政区画より大きく増減した数値、あるいは県の数値から大きく離れている数値です。それぞれの数値には、隣接する行政区画の中央値、最も大きな差がある隣接行政区画、そして2回の国勢調査を比較できる場合は2014年の数値とモロッコ全体の推移も併記します。データに誤りがある可能性がある数値、2回の国勢調査で一致しない数値がある行政区画、男女の割合は除外しています。

pnpm insights は data/v1/ からすべてを算出し、data/v1/insights/ に書き出します。モデルもネットワーク呼び出しも必要ありません。API は同じファイルを /api/communes/{code}/insights.json で提供し、MCP サーバーの get_insights はそれらをアシスタントに渡します。手法のページでは各数値の選び方を説明しており、insights/pilot/ には、言語モデルに理由を尋ねた以前の設計に関する調査を収めています。

ドゥアール

HCP は2024年の国勢調査を、農村部の行政区画にある村や集落であるドゥアール単位まで公開しています。ドゥアールは33,189か所あり、1,279の行政区画に属する5,203の地区に分かれていて、名前はアラビア語のみです。data/v1/douars/ には各ドゥアールの世帯数と人口が収録されています。30世帯以上のドゥアールについては、国籍、性別、年齢、住民登録、婚姻状況別の人口、世帯が住む住宅の種類、住宅から舗装道路、小学校、中学校、高校、保健センターまでの距離も収録されています。HCP はこれらの情報を、規模の小さいドゥアールについては非公開としており、その場合は null になります。

ドゥアールのラテン文字表記は、その名前を記載している情報源から取得します。具体的には、国民教育省の公立学校一覧、OpenStreetMap、GeoNames で、HCP のアラビア語表記と同じ行政区画内のドゥアールを照合します。14,710のドゥアールに表記があります。照合処理はそれぞれ、誤った行政区画に対してももう一度実行し、そこで見つかった件数から偶然一致した割合を算出します。学校一覧では1.0%、地図データの2つの処理では1.7%と4.1%です。割合が5%を超える処理では、何も書き出しません。

情報源に名前がないその他のドゥアールについては、サイトがアラビア語からラテン文字表記を生成します。この処理は api/src/lib/spell.ts にあり、両方の文字体系で記された名前から学習した単語の表と、フランス語によるモロッコの名前の表記規則を使います。 pnpm translit --eval は、学習に使わなかった名前でその精度を評価します。情報源に名前がないドゥアールについて、訪問者が表記を提案できます。提案が公開される前に、同じ処理系で毎晩確認します。

API は行政区画のドゥアールを /api/communes/{code}/douars.json で提供し、MCP サーバーの get_douars はそれらをアシスタントに渡します。 名前のページでは、それぞれの名前の出典を確認できます。

実行方法

pnpm install
pnpm dataset:build     # rebuilds data/v1 from the cached sources
pnpm insights          # rebuilds data/v1/insights from the rest of data/v1
pnpm build             # the docs site, then the API tree, into dist/
pnpm api:dev           # wrangler pages dev on :8788, serving the site and the API together
pnpm api:smoke         # probes a running deployment
pnpm check             # typecheck both trees, then the tests
pnpm eval              # asks a model 49 questions through the MCP server; see evals/

デプロイ用ビルドには、配信元のオリジンを指定します。正規 URL、リンクプレビュー画像、サイトマップ、MCP ページの設定スニペットは、すべてこの値から生成されます。

SITE_URL=https://your-deployment pnpm build

指定しなくてもサイトはビルドされ、その旨が表示されますが、これら4つは含まれません。

pnpm build 内の実行順序は重要です。Astro は出力ディレクトリを消去するため、先にサイトをビルドし、その後、同じ dist/ に API ツリーを書き出します。

pnpm site:dev はホットリロードで Astro のみを実行しますが、この方法ではプレイグラウンドから API を呼び出せません。両方を確認するには pnpm api:dev を使ってください。

Node 22 以降が必要です。デプロイには Cloudflare アカウントが必要です。api/README.md を参照してください。

データの作成方法

HCPは国勢調査データをExcel形式で公開しています。コード列は数値として保存されているため先頭のゼロが失われ、コードは7桁、8桁、または9桁で届きます。階層はコードの数値規則ではなく、文書内の行順から復元し、コードの数値規則は親子関係の確認にのみ使用します。都市部と農村部も同じ行順から判定します。Cercleの見出しより前に記載されたコミューンは自治体です。

境界データはOpenStreetMapのadmin_level=8リレーションから取得し、1,503件すべてに付与されたref:MA:HCPタグでHCPのデータと結合します。Overpassは各境界を順序のないウェイ断片として返すため、データを出力する前に断片の端と端をつないでリングを復元します。1,503件中1,502件を取得できました。Sidi Mohamed Benmansourのリレーションには閉じた外周リングがないため、推測で修復せず、ジオメトリフィールドをnullとして収録します。41件の行政区も同じ方法でadmin_level=10リレーションからすべて取得します。それぞれが自分のコミューン内に収まり、全体として市域を網羅している必要があります。

HCPの指標ワークブックには同じコードの単位が記載されているため、コードで結合します。1,852件すべての単位と164件の都市中心部が対象です。通勤データは各国勢調査で個別のワークブックとして提供され、同じ単位が同じ順序で並んでいるため、配置する前に行ごとに結合します。各列にはHCPが付けた見出しをそのまま使用し、見出しが移動している場合はビルド時にワークブックを拒否します。さらに、各単位の人口と世帯数が人口ファイルの値と一致すること、および数値が合計と一致することを確認します。詳細はindicators/README.mdを参照してください。

国勢調査では都市部の住宅ストックも調査しており、各町の住宅数、空き家数、住宅の種類や築年数、建材、接続設備が個別のワークブックにまとめられています。世帯ではなく住宅を数えているため、国勢調査の指標ではなくhousing/に収録されており、784件の単位にデータがあります。

国勢調査では事業所も調査しています。HCPの現地調査チームがすべての経済事業所を地図化し、コミューンごとの件数を公開しており、1,847件の単位に収録されています。数値は各単位につき22項目で、地図化された事業所数から、業種別、従業員数別、設立年代別の事業者数までを含みます。各単位内では内訳の合計が総数と一致し、全国では各数値が階層全体で合計される必要があります。ワークブックが行政区ごとに集計している6つの市については、各市の正確な合計をbasisとして記録しています。これは2014年人口データと同じ方法です。詳細はeconomy/README.mdを参照してください。

2014年の国勢調査でも同種の数値が個別のワークブック4冊で公開されており、現在の単位に対応付けています。1,979行中1,965行を、コード、クロスウォーク、またはコミューン内の名称で対応付けています。ワークブックのうち3冊は同じレイアウトのため、それぞれ固有のフィールドリストを使って同じ読み取り処理を行います。72項目は2024年の項目と同じなので差分を算出できます。残りは母数や分類が変更された項目、または2014年にのみ存在する項目、すなわち人々の職業、従事していた業種、取得していた卒業資格です。それぞれの処理方法を記載しています。詳細はindicators/2014/README.mdを参照してください。対応先のない14行はindicators/2014/unplaced.jsonに記載されています。

境界データからは、どのコミューン同士が隣接しているかもわかります。境界線の一部を共有する場合、2つのコミューンは隣接しています。OpenStreetMapでは、その境界線は両方のリレーションで同じノードとして表されるため、許容誤差ではなく厳密に照合できます。共有する境界線の長さとともに、4,134組を記録しています。いずれかのコミューンから隣接関係をたどると、境界データのある1,502件すべてに到達できます。これにより、国全体が複数ではなく1つのグラフになっていることを確認します。

2015年の改革で207件のコミューンのコードが変更され、現在のコードに対応する2014年の数値がありません。crosswalk/では、決定論的な2段階の処理でこれらを照合し、すべての対応付けについて根拠を記録しています。各行を信頼に頼らず検証できます。

クレジットと先行する取り組み

• Haut-Commissariat au Plan：RGPH 2024 と RGPH 2014。すべてのコード、名称、人口の数値、国勢調査の指標の出典です。
• OpenStreetMap contributors：ODbL に基づくすべての境界、重心、バウンディングボックス。
• mahdiboughrous/moroccan-administrative-division-data と zeys/regionsPrefecturesProvincesCommunesMaroc： 行政区画の先行するオープンリストです。このデータセットの作成にあたって最初に行った監査では、両方を国勢調査と照合しました。
• tn-municipality-api：このプロジェクトのモデルとなったチュニジアのプロジェクトです。
• Bouazzi Maghribi：サイトでアラビア語の表示に使っているマグリブ書体です。Alef Type Foundry が SIL Open Font License のもとで提供しています。ライセンスで元の名称の使用が制限されているため、サイトではこれを Communes Maghribi として提供し、ݣ、ڭ、گ、ک、پ、چ、ﻻは site/scripts/font.py で独自の文字と点から作成しています。

引用と修正

CITATION.cff に引用情報が記載されており、GitHub では「このリポジトリを引用」として表示されます。名称、数値、境界に誤りがある場合は、データに関する問題報告フォームから報告できます。このフォームでは、正しい情報を確認できる出典を求めています。プッシュのたびにテストを実行し、すべてをビルドして、wrangler dev で動作を確認します。

ライセンス

コードは MIT ライセンスです。データのライセンスは、上記のとおりディレクトリごとに異なります。