Raleigh Civic Data
City of Raleigh の公共の市民データとサービスを利用するための読み取り専用 CLI です。稼働中の ArcGIS Hub カタログからデータセットを検出し、ArcGIS レイヤーをクエリし、画像をエクスポートし、住所のジオコーディングと逆ジオコーディングを行い、GoRaleigh の GTFS および GTFS-Realtime フィードを読み取り、ゲスト公開の Permit and Development Portal を検索し、公開されている RaleighNC.gov のコンテンツを一覧表示し、公開 eSCRIBE 会議の情報を抽出します。
すべての操作は読み取り専用で、固定されたエンドポイントの仕様を使用します。明示的に了承した RFD レポートの検索を除き、HTTPS が必須です。RFD レポートの検索では、接続先サイトがプレーン HTTP のみをサポートしています。API キー、サインイン、支払い、送信のフローは実装されていません。
クイックスタート
# List live datasets
scripts/raleigh catalog
# Search the catalog
scripts/raleigh search "food inspection"
# Show a dataset's live metadata
scripts/raleigh info "Raleigh Dog Parks"
# Query records
scripts/raleigh query "Food Inspections" --where "SCORE < 70" --limit 20
# Export to CSV
scripts/raleigh download "Raleigh Dog Parks" -f csv -o dog_parks.csv
コマンド
データセットの検出
| コマンド | 目的 | 例 |
|---|
catalog | 稼働中の Hub データセットを一覧表示 | scripts/raleigh catalog --json |
search | カタログのメタデータを検索 | scripts/raleigh search "building permit" --limit 10 |
info | タイトルまたは ID でデータセットを表示 | scripts/raleigh info "Raleigh Dog Parks" --json |
query | フィルターを指定してレコードをクエリ | scripts/raleigh query "Food Inspections" --where "SCORE<70" --limit 20 |
download | CSV、GeoJSON、または JSON にエクスポート | scripts/raleigh download "Parcels" -f geojson -o parcels.geojson |
categories | カタログのカテゴリを一覧表示 | scripts/raleigh categories |
catalog-check | キャッシュされたエンドポイントを検証 | scripts/raleigh catalog-check --sample 10 |
画像
| コマンド | 目的 | 例 |
|---|
imagery catalog | ImageServer サービスを一覧表示 | scripts/raleigh imagery catalog --json |
imagery info | サービスのメタデータを表示 | scripts/raleigh imagery info Orthos2025 |
imagery export | 範囲を指定して画像をエクスポート | scripts/raleigh imagery export Orthos2025 --bbox=-78.7,35.7,-78.6,35.8 --size 400,400 -o ortho.jpg |
imagery identify | 指定地点のピクセル値を特定 | scripts/raleigh imagery identify Orthos2025 --point=-78.65,35.75 |
imagery statistics | 範囲の統計情報を計算 | scripts/raleigh imagery statistics Orthos2025 --bbox=-78.7,35.7,-78.6,35.8 |
imagery catalog は、公開されているサービスのみを一覧表示します。
一覧表示にトークンが必要なフォルダー（現在は Imagery と
Utilities）はスキップされ、コマンドを失敗させずに制限対象として報告されます。毎日の稼働中カナリアも同様にこれらを追跡します。
ジオコーディング
| コマンド | 目的 | 例 |
|---|
geocode | フォワードジオコーディング | scripts/raleigh geocode "222 W Hargett St" |
reverse-geocode | 逆ジオコーディング | scripts/raleigh reverse-geocode --lat 35.78 --lon -78.64 |
suggest | 住所の自動補完 | scripts/raleigh suggest "222 W Har" |
geocode-batch | CSV の一括ジオコーディング | scripts/raleigh geocode-batch addresses.csv --address-field address -o out.csv |
一括処理の出力では、元の CSV のすべての列が保持され、input_id、
match_address、score、lat、lon、status が追加されます。入力にこれらの名前がすでに使われている場合、追加される結果列には geocode_ プレフィックスが付きます。
交通機関
| コマンド | 目的 | 例 |
|---|
transit routes | 路線を一覧表示 | scripts/raleigh transit routes --json |
transit stops | 停留所を一覧表示 | scripts/raleigh transit stops --near 35.78,-78.64 --limit 10 |
transit schedule | 路線の時刻表 | scripts/raleigh transit schedule --route 1 --date 20260723 |
transit arrivals | 停留所への到着情報 | scripts/raleigh transit arrivals --stop S1 |
transit vehicles | 車両のリアルタイム位置 | scripts/raleigh transit vehicles --json |
transit alerts | 運行アラート | scripts/raleigh transit alerts |
transit trip-updates | リアルタイムの便の更新情報 | scripts/raleigh transit trip-updates --json |
transit download-gtfs | 静的フィードを保存 | scripts/raleigh transit download-gtfs |
開発記録
| コマンド | 目的 | 例 |
|---|
development search | 公開記録を検索 | scripts/raleigh development search permits --query "2024-001" |
development search project | 公開プロジェクトを検索 | scripts/raleigh development search project --query "downtown" |
development permit | 許可の詳細 | scripts/raleigh development permit BP-2024-001 |
development inspections | 記録の検査 | scripts/raleigh development inspections --record BP-2024-001 |
development code-cases | 法令違反案件 | scripts/raleigh development code-cases --query "nuisance" |
development licenses | ライセンス | scripts/raleigh development licenses --query "coffee" |
市民向けコンテンツ
| コマンド | 目的 | 例 |
|---|
news | RaleighNC.gov のニュース | scripts/raleigh news --limit 10 |
events | イベント | scripts/raleigh events --from 2026-07-01 --to 2026-07-31 |
projects | プロジェクト | scripts/raleigh projects --search "park" |
places | 場所 | scripts/raleigh places --search "library" |
services | サービス | scripts/raleigh services --search "trash" |
directory | ディレクトリエントリー | scripts/raleigh directory --search "parks" |
alerts | 公開アラート | scripts/raleigh alerts |
rss | RSS フィード | scripts/raleigh rss --limit 10 |
警察事件
| コマンド | 目的 | 例 |
|---|
police incidents | NIBRS 事件を検索（2014 年 6 月～現在） | scripts/raleigh police incidents --since 7d --category burglary |
police recent | CrimeMapper の過去 90 日間のフィードを検索 | scripts/raleigh police recent --days 30 --district Downtown |
police previous-day | 前日の事件を検索 | scripts/raleigh police previous-day --json |
police history | 過去の事件を検索（SRS または NIBRS） | scripts/raleigh police history --reporting-system srs --since 30d |
police stats | 公式公開統計の利用状況とドキュメントへのリンク | scripts/raleigh police stats --year 2025 |
police reports | 公式の年次・四半期レポートへのリンク | scripts/raleigh police reports --year 2025 --quarter 4 |
火災事件
| コマンド | 目的 | 例 |
|---|
fire incidents | RFD の事件を検索（全履歴：2007 年～現在、または過去 1 か月） | scripts/raleigh fire incidents --since 30d --group Fire |
fire response-times | ラベル付きの対応所要時間を計算 | scripts/raleigh fire response-times --since 1y --group Fire |
fire protection | Wake County MAR の消防防護近接検索 | scripts/raleigh fire protection --address "222 W Hargett St" |
fire stats | 公式公開の事件件数とスプリンクラーによる救助の統計 | scripts/raleigh fire stats --year 2026 |
fire reports | 公開集計レポートへのリンク、または特定の事件レポートの検索 | scripts/raleigh fire reports --year 2025 --quarter 1 |
fire reports --date | 正確な ArcGIS 事件レポートの概要（任意で、保護された RFD フォールバックを使用） | scripts/raleigh fire reports --date 2026-07-24 |
fire inspections | 取り扱いに注意が必要な RFD HTML を介した事業者・住所の検査検索 | scripts/raleigh fire inspections --business "Example" --acknowledge-insecure-rfd |
発生中の事件（RWECC）
| コマンド | 目的 | 例 |
|---|
incidents active | RWECC から現在発生中の公開事件を取得 | scripts/raleigh incidents active --agency raleigh-fire |
incidents active --json | ソースのメタデータ付き JSON 出力 | scripts/raleigh incidents active --agency raleigh-police --json |
公開会議
| コマンド | 用途 | 例 |
|---|
meetings upcoming | 今後の会議 | scripts/raleigh meetings upcoming --json |
meetings list | 委員会または年で絞り込み | scripts/raleigh meetings list --body "City Council" --year 2026 |
meetings search | 会議を検索 | scripts/raleigh meetings search "budget" |
meetings show | 会議の詳細 | scripts/raleigh meetings show 37126a80-175a-4b38-974d-a7006bc7db85 |
meetings download-agenda | 議題をダウンロード | scripts/raleigh meetings download-agenda 37126a80-175a-4b38-974d-a7006bc7db85 -o agenda.pdf |
meetings download-minutes | 議事録をダウンロード | scripts/raleigh meetings download-minutes 37126a80-175a-4b38-974d-a7006bc7db85 -o minutes.pdf |
出力フラグ
| フラグ | 効果 |
|---|
--json | JSON 出力 |
--refresh | カタログキャッシュをバイパス |
--cache-dir DIR | カスタムキャッシュディレクトリを使用 |
--timeout SECONDS | HTTP タイムアウト（デフォルトは 30） |
参考資料
| 参考資料 | 読み込むタイミング | ファイル |
|---|
| API コントラクトとエンドポイント | カスタムクエリの作成時 | references/api-reference.md |
| 画像データと ImageServer の詳細 | 航空写真またはラスターサービスを扱うとき | references/imagery-reference.md |
| GTFS と GTFS-Realtime | 交通機関のコマンド | references/transit-reference.md |
| Guest 開発ポータル | 許可証および開発記録 | references/development-reference.md |
| 市民向けコンテンツ | JSON:API と RSS | references/civic-content-reference.md |
| 公開会議 | eSCRIBE の抽出 | references/meetings-reference.md |
| 警察の事件 | RPD のデータソース、フィールドスキーマ、プライバシーに関する注意事項 | references/police-reference.md |
| 火災の事件 | RFD のデータソース、2026 年のスキーマ移行、期間、プライバシーに関する注意事項 | references/fire-reference.md |
| 火災の報告と検査 | ArcGIS を優先するコントラクト、RFD のフォーム、安全でない通信、対象外の項目 | references/fire-reports-reference.md |
| 公開されている警察・消防統計 | 公式ページのコントラクト、レポートのインデックス、構造化された合計値、プライバシーの境界 | references/public-safety-statistics-reference.md |
| 発生中の事件（RWECC） | 文書化されていないフィードのコントラクト、スキーマガード、無効化スイッチ | references/incidents-reference.md |
注意事項
- ライブカタログ：カタログは実行時に Hub から検出されます。繰り返し使用する場合は、
--cache-dir でキャッシュしてください。
- ImageServer：ImageServer のルートに
/0 を追加しないでください。専用の imagery コマンドを使用してください。
- MapServer のテーブル：一部のレイヤーはテーブル形式（
type: Table）です。CLI は空間情報を持たないレイヤーのジオメトリを自動的に省略します。
- WHERE 句：文字列はシングルクォートで囲む必要があります：
NAME='Millbrook-Exchange'。
- ArcGIS の日付：Unix ミリ秒で返されます。標準のタイムスタンプにするには 1000 で割ってください。
- ゲスト開発ポータル：文書化されていない公開アプリケーション API を使用します。このアダプターは独立しており、上流の UI が変更されると動作が変わる可能性があります。個別に無効化するには
RALEIGH_DISABLE_DEVELOPMENT=1 を設定してください。
- Civic のリレーションシップ：公開コンテンツのコマンドでは
--relationship FIELD=ID を指定できます。テキスト、日付、リレーションシップの照合は、上限付きページネーション後にクライアント側で行われます。
- eSCRIBE：HTML ベースの抽出であり、構造化 API より互換性の保証が弱くなっています。
- 警察の事件：位置情報はブロック単位で、ランダム化または秘匿されている場合があります。空の座標は抑制され、ポイントとして表示されません。このデータには逮捕、有罪判決、処分は含まれません。CrimeMapper の 90 日間フィードは、厳選された Hub カタログには含まれておらず、アイテム ID で解決されます。
- 火災の事件：RFD は 2026-01-01 以降の記録について
incident_type／incident_type_description を廃止し、incident_group_name、incident_subgroup_code、incident_type_name に置き換えました。fire コマンドは、異なる時期のデータを架空の対応関係を作らずに安定した _ キーへ正規化し、生のフィールドは JSON に保持します。EMS／プライバシー上の理由により、RFD は事件タイプ 300–399 および 661 を除外しています。全履歴の station フィールドは 2021 年初頭以降のほとんどの記録で未入力です。過去 1 か月分のフィードでは station_name が提供されます。
- 火災レポートと検査：レポートの概要には、構造化された ArcGIS の過去 1 か月分のレイヤーを最初に使用します。RFD のフォールバック、説明文、検査の検索は暗号化されていない HTTP を経由するため、呼び出しのたびに
--acknowledge-insecure-rfd が必要です。日付のフォールバックには --allow-rfd-fallback も必要で、ArcGIS がレコードを返さなかった場合にのみ実行されます。検索結果が空の場合、リダイレクト、予期しないマークアップ、スキーマの変更があった場合は、処理を安全側に停止します。請求書へのリンクはたどらず、公開もしません。
- 公開されている公共安全統計：
police stats/reports と年別の fire stats/reports は、実行時に公式の RaleighNC.gov 公開インデックスを読み取ります。インラインの値には official_published_statistics とラベルが付けられます。PDF へのリンクは返されますが、その内容は抽出されません。これらの出力は事件レコードから再計算されません。RFD の医療関連の合計値は集計値のみです。プライバシー上除外された事件レコードと結合したり、そこから推測したりしてはなりません。
- 消防設備：Wake County MAR Fire Protection テーブルは、CSAID をキーとする非空間テーブルです。住所入力は Raleigh のロケーターと Wake County MAR Addresses レイヤーを通じて処理されます。住所を一意の CSAID に解決できない場合は、
--csaid を直接指定してください。距離はソースが提供する道路網に基づく値であり、ソースには単位の記載がありません。このデータでは最寄りの消火栓までの距離のみが公開され、消火栓の位置は公開されません。緊急対応に使用してはなりません。
- 対応中の事件（RWECC）：文書化されていない公開アプリケーションのエンドポイント（
incidents.rwecc.com/getdata）を使用します。このアダプターは独立しており、上流の仕様が変更されると動作しなくなる可能性があります。個別に無効化するには RALEIGH_DISABLE_INCIDENTS=1 を設定してください。これは絞り込まれた対応中事件のフィードであり、すべての 911 通報を含むものではなく、緊急事態の正式な状況を示すものでもありません。応答が空でも、事件がゼロであることの証明にはなりません。キャッシュの有効期間は 90 秒です。
- URL の許可リスト：参照できるのは固定された公開ホストのみです。任意の URL は拒否されます。
- 交通機関のリアルタイム情報：
google.protobuf>=6.31.1,<7 が必要です。ベンダー提供の GTFS-Realtime バインディングは protoc 31.1 で生成されており、ランタイムを置き換えるものではありません。
安全境界
- 読み取り専用の操作のみです。認証、書き込み、支払い、送信、個人データ用のエンドポイントはありません。
- すべてのリモートホストとパスは固定されています。一般クライアントは引き続き HTTPS のみを使用します。分離された RFD アダプターは、明示的な承認後に限り、ドキュメントに記載された 4 つの HTTP 読み取りコントラクトのみを許可します。
- キャッシュデータは、
--refresh を指定した場合、またはキャッシュの有効期限が切れた場合に更新されます。
- エンドポイントが古い、または利用できない場合は、
catalog-check で報告してください。
使用しない場合
- 個人用、認証が必要な、または非公開の市データには、このスキルを使用しないでください。サインイン、手数料の支払い、フォームの送信、内部システムへのアクセスはできません。
- ローリー市以外の管轄区域には使用しないでください。ホスト許可リストは City of Raleigh と GoRaleigh のエンドポイントに固定されています。
- 書き込み操作、リアルタイムの緊急出動、または法的に権威のある記録には依存しないでください。データは読み取り専用で、キャッシュされている場合があります。
- タスクで GTFS-Realtime が必要で、互換性のある
protobuf ランタイムが利用できない場合は使用しないでください。先に protobuf>=6.31.1,<7 をインストールするか、静的 GTFS コマンドを使用してください。
- 一般的なウェブスクレイピング、ローリー市の市民向けデータ以外の調査、または対話的なブラウザー操作には、代わりにより適切なスキルを使用してください。
