메뉴
指定の道路・エリアの現在の交通量を JARTIC 交通量 API (国土交通省) から取得する手順。「国道◯号の今の交通量」「◯◯付近の混雑」など、特定の道路や地点の最新交通量を聞かれた際に使う。 地名・道路名を国土地理院ジオコーディングで緯度経度へ変換し、WFS 2.0.0 GetFeature を BBOX と時間コードで叩く。対象は高速自動車国道と一般国道のみで、県道・市道は取得できない。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | jartic-traffic-volume |
| description | 指定の道路・エリアの現在の交通量を JARTIC 交通量 API (国土交通省) から取得する手順。「国道◯号の今の交通量」「◯◯付近の混雑」など、特定の道路や地点の最新交通量を聞かれた際に使う。 地名・道路名を国土地理院ジオコーディングで緯度経度へ変換し、WFS 2.0.0 GetFeature を BBOX と時間コードで叩く。対象は高速自動車国道と一般国道のみで、県道・市道は取得できない。 |
指定の道路・エリアの現在の交通量を取得する手順。実体は GeoServer の WFS 2.0.0 GetFeature であり、エンドポイントは 1 本のみ。
https://api.jartic-open-traffic.org/geoserverhttps://msearch.gsi.go.jp/address-search/AddressSearchhttps://mreversegeocoder.gsi.go.jp/reverse-geocoder/LonLatToAddress?lat=<緯度>&lon=<経度>GetFeature を叩く。API は常時観測点に紐づく道路種別でしか道路を区別しない。値は次の 2 種のみ。
| 道路種別 | 値 | 備考 |
|---|---|---|
| 高速自動車国道 | 1 | 観測点は全国で数十点と希薄。主要な高速道路の都市近郊は含まれにくい (下記注記)。 |
| 一般国道 | 3 | 全国に多数。通常はこちらで取得する。 |
緯度経度・BBOX・常時観測点コードを直接渡された場合は、ジオコーディングを省略してそれを使う。地名や道路名しか無い場合は国土地理院でジオコーディングする。
curl -sS -G 'https://msearch.gsi.go.jp/address-search/AddressSearch' \
--data-urlencode 'q=三軒茶屋'
geometry.coordinates は [経度, 緯度] の順 (緯度経度が逆なので注意)。properties.title が地名。title を見て依頼の文脈 (都市・駅・路線) に最も合う候補を選ぶ。判別できなければユーザに確認する。BBOX(ジオメトリ, 最小経度, 最小緯度, 最大経度, 最大緯度, 'EPSG:4326')。経度が先である。「現在の交通量」は 5 分間交通量 (様式 1) を既定とする。
| 様式 | typeNames | 観測機器 | 集計単位 | 検索可能期間 |
|---|---|---|---|---|
| 様式 1 | t_travospublic_measure_5m | 常設トラカン | 5 分間交通量 | 過去 1 か月分 |
| 様式 2 | t_travospublic_measure_1h | 常設トラカン | 1 時間交通量 | 過去 3 か月分 |
| 様式 3 | t_travospublic_measure_5m_img | CCTV トラカン | 5 分間交通量 | 過去 1 か月分 |
| 様式 4 | t_travospublic_measure_1h_img | CCTV トラカン | 1 時間交通量 | 過去 3 か月分 |
時間コードは YYYYMMDDhhmm。5 分値は分を 5 の倍数へ切り捨て、1 時間値は分を 00 へ切り捨てる。現在 (JST) を 5 分単位へ切り捨てた時間コードは次で得る。
TZ=Asia/Tokyo date +%Y%m%d%H%M | awk '{printf "%s%02d\n", substr($0,1,10), int(substr($0,11,2)/5)*5}'
t_travospublic_measure_1h) を使い、分を 00 へ切り捨てる。t_travospublic_measure_5m_img) を試す価値がある。両者は別系統の観測点である。${TC} は時間コード、${minLon} 〜 ${maxLat} は BBOX、道路種別=3 は一般国道の例 (高速は 1)。
curl -sS -G 'https://api.jartic-open-traffic.org/geoserver' \
--data-urlencode 'service=WFS' \
--data-urlencode 'version=2.0.0' \
--data-urlencode 'request=GetFeature' \
--data-urlencode 'typeNames=t_travospublic_measure_5m' \
--data-urlencode 'srsName=EPSG:4326' \
--data-urlencode 'outputFormat=application/json' \
--data-urlencode 'exceptions=application/json' \
--data-urlencode "cql_filter=道路種別=3 AND 時間コード=${TC} AND BBOX(ジオメトリ,${minLon},${minLat},${maxLon},${maxLat},'EPSG:4326')"
service version request typeNames srsName outputFormat は必須。exceptions=application/json を付けるとエラーも JSON で返る (未指定時は XML)。cql_filter は CQL 文字列。フィールド名と値を 道路種別=3 のように素で書く形式で動作する (OpenAPI 仕様書の "道路種別"='3' のクォート形式も有効)。常時観測点コード=01234567 (8 桁 0 埋め) を指定できる。このとき道路種別も不要になる (コードで一意のため)。置換後の完全形は cql_filter=時間コード=${TC} AND 常時観測点コード=03310890。ジオコーディングも省略する。成功時は GeoJSON の FeatureCollection。features[] の 1 件が 1 観測点である。
properties は方向別 (上り/下り) × 車種別 (小型/大型/車種判別不能) の交通量を持つ。単位は様式 1 が台/5 分、様式 2 が台/時。上り・小型交通量 上り・大型交通量 上り・車種判別不能交通量 (下りは 下り・…) であり、上り・小型 のような略記ではない。集計前に features[0].properties の実キーを 1 度確認すると取り違えを防げる。上り・欠測/下り・欠測 が "1" なら欠測で、交通量は null になる。停電/ループ異常/超音波異常 が "1" の点も異常である。null や異常値は合計から除くか、注記を添える。時間帯 は hhmm、時間コード は YYYYMMDDhhmm、常時観測点コード で観測点を識別する。座標は geometry.coordinates ([経度, 緯度])。上り・自動車交通量（集計値） などを持つ。カメラプリセット位置 が "1" (異常) の場合は交通量が null になる。features が空配列で crs が null。一般国道 (種別 3) なら時間コードを遡る、BBOX を少し広げる、で対処する。{"message": ...}: 必須パラメータ (typeNames など) の欠落。{"version": ..., "exceptions": [...]}: typeNames などの値が不正 (exceptions=application/json 指定時)。{"errorMessage": ..., "errorType": ...}: ペイロードサイズ超過。BBOX か期間を狭める。登山対象の山の天気を、てんくらの登山指数 (A/B/C) ・気象庁の麓の天気・Open-Meteo の山頂標高指定の数値予報・標高差からの推定で判断する手順。 「○○山の天気」「登山の天気」「明日山に登れるか」「登山指数」「山頂の気温」などを聞かれた際に使う。 てんくらの登山指数は無料のサーバ HTML から取得でき、気象庁の麓・登山口周辺の気象と Open-Meteo の山頂標高指定の数値予報を併せて判断する。 山頂のピンポイント気象数値そのものは保証されないため、指数・麓の天気・数値予報・推定で総合判断し、その限界をユーザに伝える。
指定ユーザ (主に自分自身) の Bluesky の情報を公開 API から取得する手順。直近の投稿内容・関心トピック・フォローしている人・フォローされている人を把握したい際に使う。「最近何を投稿したか」「旅行の写真を見たい」「誰をフォローしているか」「フォロワーは誰か」などが対象。フォロー先の傾向から関心分野を推し量る用途にも使う。 AT Protocol の公開 AppView (public.api.bsky.app) を認証なしで叩く。投稿は app.bsky.feed.getAuthorFeed、プロフィールと各種件数は app.bsky.actor.getProfile、フォロー/フォロワーは app.bsky.graph.getFollows / getFollowers を使う。画像はダウンロード後に ffmpeg でリサイズして表示する。 対象は公開情報のみ。いいね一覧など認証必須のデータの取得や、投稿・フォローの作成/削除はできない。
Discord の REST API を curl で叩いてサーバ (ギルド) を操作する手順。メッセージの送信・取得・検索、リアクション付与、スレッドの作成・名前変更、チャンネルやメンバーの一覧・検索が対象。「Discord にメッセージを送る」「チャンネルの発言を読む」「スレッドを立てる」「スレッド名を変える」「メンバーを検索する」などで使う。 bot トークンを Authorization の Bot ヘッダで渡し、 https://discord.com/api/v10 を叩く。トークンは環境変数 DISCORD_BOT_TOKEN から取る。メッセージ検索の API は bot に無いため、履歴を取得して jq でフィルタする。 対象は bot トークンで操作できる範囲のサーバ機能。レート制限 (429) は自前で Retry-After を見て待つ。ユーザ DM や OAuth が要る操作、Gateway (リアルタイム受信) は扱わない。
JARTIC (日本道路交通情報センター) が公開する渋滞「予測」データを取得する手順。ゴールデンウィーク・お盆・年末年始・行楽期の高速道路の渋滞予測、ピーク日時、◯◯祭りなどイベント周辺の一般道渋滞と迂回路を聞かれた際に使う。 `www.jartic.or.jp` の JSON を curl で取得し、路線名・年月・都道府県を `jq` で絞り込む。返るのは将来の予測であって現在の実況交通量ではない。今この瞬間の交通量・渋滞長を求められた場合はこの手順では取得できない。
指定テーマの最新ニュースを優先ソースから N 件集め、各記事をタイトル・要約・公開日・個別 URL の形にまとめて返す手順。「バイクの最新ニュースを集めて」「セキュリティ分野の注目記事を要約して」「最近の登山界隈の動きをまとめて」のように、特定テーマの新着記事を収集して要約したい際に使う。 優先ソースに RSS/Atom があればフィードを先に取得し、無ければ一般 Web 検索で補う。期間と除外リストでフィルタし、件数分を選んで各記事を要約する。 出力はタイトル・要約・公開日・個別 URL の中立フォーマット。Discord 等への整形・投稿は呼び出し側で行う前提で、この skill には含めない。
ユーザの登山履歴・各山行のタイム・ペース、および登山計画 (予定行程) をヤマレコ (yamareco.com) から取得する手順。登山計画の所要時間予測や、過去実績からのペース倍率の集計、ヤマレコに登録済みの計画の予定行程・距離・累積標高の確認を求められた際に使う。 山行リスト・計画リストは API、個別山行および個別計画の詳細は公開設定のもののみ HTML から抽出する。