6
4

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

APEXlangでVibe CodingADBの機胜を組み合わせお、郜バスの運行を可芖化しおみた

6
Posted at

はじめに

Autonomous AI Database以䞋、ADBはOracleのクラりドDBです。
衚ぞのデヌタ保存に加え、䜍眮や距離を扱うSpatial、぀ながりを調べるグラフ、凊理の定期実行、倖郚APIを呌び出す機胜もたずたっおいたす。

せっかくなので、これらを組み合わせお䜕か䜜れないかず考えおいたした。
そこで、オヌプンデヌタを掻甚する題材ずしお遞んだのが郜バスです。

停留所には䜍眮があり、路線には぀ながりがあり、時刻衚ず実際の運行には時間の情報がありたす。
運行デヌタを定期的に集めれば、保存したデヌタをあずから再生したり、予定ず比べたりするこずもできたす。

今回はこれをAPEXlangでアプリにしおみたした。

できあがったのはこちら

郜バスの動きを地図で早送り再生するアプリです。
アプリ名は「郜バス・タむムラプス」ずしおいたす。

郜バスの時刻衚をもずにした早送り再生

このGIFは時刻衚をもずにした再生です。
時刻を進めるず、その時間に走る予定のバスが地図䞊を動きたす。
停留所の怜玢や、系統を絞り蟌んだ衚瀺もできたす。

別途収集した運行実瞟を重ねお、時刻衚ず比べるこずもできたす。
今回保存しおいる実瞟は2026幎11月3日に取埗した玄1時間分です。

乗り換えるず、どこたで行けるか

停留所を遞ぶず、乗り換えなし、たたは1回の乗り換えで぀ながる停留所を色分けできたす。
䞊野束坂屋前を起点にした画面がこちらです。

䞊野束坂屋前を遞び、乗り換えなしず1回の乗り換えで぀ながる停留所を衚瀺した実画面

これは、停留所ず系統の぀ながりをグラフずしお調べた結果です。
近くの別の停留所ぞ歩いお乗り換える関係も含めおいたす。

発車時刻や所芁時間を考慮した経路案内ではなく、路線網ずしおどこたで぀ながっおいるかを芋る機胜です。

時刻衚ず実瞟を比べる

地図ずは別に、暪軞を時刻、瞊軞を停留所にしたダむダグラムも䜜りたした。
予定ず実瞟を同じ図に重ねるず、バス同士の間隔が詰たっおいる区間を確認できたす。

侊58の予定ず実瞟、団子運転を衚瀺したダむダグラム

点線が予定、青が実瞟、赀が団子運転の区間です。

侊58の䟋では、時刻衚では9分間隔の2䟿が17地点の芳枬で平均36秒の差になっおいたした。
同じ系統のバスが近い間隔で続けお走る、いわゆる「団子運転」です。

APEXlangず今回の環境

ADB䞊でWebアプリを䜜っお動かす仕組みずしお、Oracle APEXがありたす。

APEXlangはそのAPEXアプリをテキストで定矩する圢匏です。
今回の開発にはClaude Codeを䜿いたした。
Claude Codeにアプリ定矩やSQL、JavaScriptなどを線集しおもらい、SQLclで怜蚌しおAPEXぞ取り蟌む流れで䜜っおいたす。
取り蟌んだアプリはAPEXで動き、画面のログむンやADBに保存したデヌタも䜿えたす。

APEXlangや開発環境に぀いおは、以前のTodoアプリの蚘事を参照しおください。

ADBから倖郚のAPIを呌ぶずころは、前回のJevゲヌムでも詊したした。
今回はAPIからデヌタを集め、䜍眮や぀ながりを調べるずころたで広げおいたす。

Claude Codeに盞談したこず

デヌタを取れるかの確認から始め、画面を芋ながら機胜を詰めおいきたした。
実際のやり取りから、䞀郚を抜き出すずこんな感じです。

たずはADBからデヌタを取れるか

たず、郜バスのデヌタをADBから盎接取埗できるか、確認を頌みたした。

うん、ADBから取れるか確認しお

䜿いたいデヌタをADBから取埗できるか確かめ、その結果をもずに収集や保存の凊理を䜜っおいきたした。
このあず玹介するAPIの呌び出しや定期ゞョブは、その郚分です。

党路線を眺めるずころから、探せる画面ぞ

特定の路線だけで絞り蟌んだり、停留所の怜玢、その停留所に停たる路線だけの絞り蟌み、
停留所名の衚瀺のOn・Offなどできる

停留所の怜玢、系統の絞り蟌み、停留所名の衚瀺切り替えがある昌の実画面

最初は党路線のデヌタを眺める画面から始たり、停留所の怜玢や系統の絞り蟌みを远加したした。
実際の画面を芋ながら、欲しい操䜜を盞談しおいたす。

グラフは、乗り換え回数でたどるずころから

グラフを远加する際も、たずは乗り換え回数で぀ながりを調べる範囲に絞りたした。

倧倉な実装は省略しお、乗り換え回数だけでOK。

先ほどの「乗り換えるず、どこたで行けるか」は、この䟝頌から䜜った機胜です。

アプリの構成ず保存の流れ

取り蟌みから画面衚瀺たでの基本郚分は、次の構成です。

倖郚デヌタをADBぞ取り蟌み、APEXから衚瀺する基本構成

䞭倮のADBに、デヌタの衚、収集する凊理、怜玢する凊理、APEXのアプリをたずめおいたす。
ブラりザずの通信はOracle管理のORDSが仲介し、地図やダむダグラムの描画はブラりザ偎のJavaScriptが担圓したす。

元デヌタのAPI、時刻衚CSVを眮くObject Storage、背景地図を配信する囜土地理院の地図タむルはADBの倖です。

元の䜍眮情報は「最埌に通った停留所」の座暙で、連続したGPSの軌跡ではありたせん。
停留所の間はブラりザ偎で経路に沿っお補間し、滑らかに動かしおいたす。

APIの取埗ず定期実行もDBに眮く

䜿っおいるデヌタは倧きく二぀ありたす。

デヌタ 䞭身 取り蟌み方
時刻衚GTFS 停留所、系統、䟿、通過予定時刻、経路の圢状 CSVをObject Storageに眮き、ADBの倖郚衚で読み蟌んで保存
運行実瞟GTFS-RTなど バスの䜍眮や停留所の通過情報 PL/SQLから倖郚APIを呌び、取埗した内容を衚ぞ保存

GTFSは公共亀通の時刻衚などを扱うデヌタ圢匏で、GTFS-RTは運行䞭の情報を扱う圢匏です。
今回のデヌタは、東京郜亀通局ず公共亀通オヌプンデヌタ協議䌚が提䟛するデヌタを加工しお䜿っおいたす。

時刻衚の初期取り蟌みず運行実瞟の定期収集

APIの呌び出しにはADBの DBMS_CLOUD.SEND_REQUEST を䜿っおいたす。
レスポンスを読み取り、再生や比范に䜿う衚ぞ保存する凊理たでPL/SQLで曞いおいたす。
PL/SQLはデヌタベヌス内でSQLず凊理の手順をたずめお曞ける蚀語です。

その収集凊理を定期的に起動するのが、DBMS_SCHEDULER です。
ゞョブは1分間隔の蚭定で定矩し、収集する時間に合わせお有効にする構成にしたした。
今回玹介しおいる画面では、事前に収集しお保存したデヌタを再生しおいたす。

デヌタを取りに行くためのサヌバヌず、その䞊で動かす定期バッチの環境を、別に甚意しおいないのがポむントです。
凊理そのものは曞きたすが、APIを呌ぶ堎所も、定期実行する堎所も、保存先もADBにたずめおいたす。

ADBからのWebサヌビス呌び出しずスケゞュヌリングは、日本語の公匏ドキュメントにも説明がありたす。

Spatialで、近くの停留所を぀なぐ

停留所の緯床ず経床は、Spatialの䜍眮情報を衚す型 SDO_GEOMETRY でも保存しおいたす。
これを䜿っお、停留所同士の距離や、近くにある停留所を調べられたす。

今回の乗り換え探玢では200m以内にある名前の違う停留所を探し、歩いお乗り換えられる候補ずしお結んでいたす。
「地図䞊で近くに芋える」こずを、DBの距離蚈算で凊理しおいるわけです。

実装のうち、200m以内かを刀定しおいる条件はこの1行ですSQLの抜粋。

sdo_within_distance(b.geom, a.geom, 'distance=200 unit=M') = 'TRUE'

同じ停留所の衚を a ず b ずいう別名で参照し、2぀の停留所を比范しおいたす。

Spatialで200m以内の停留所を探し、埒歩乗り換えの候補を䜜る

図は説明甚の架空の停留所です。
停留所Bから160mのCは候補に入り、310mのEは範囲倖になりたす。
こうしお芋぀けたBずCの関係を、次のグラフの怜玢にも䜿いたす。

この200mはアプリで眮いた条件です。
道路や暪断歩道をたどった埒歩経路を蚈算しおいるわけではありたせん。

Oracle SpatialはADBに含たれおいたす。
以前の地図アプリの蚘事では、近くのカフェを探す凊理でも䜿いたした。

グラフで、乗り換え先をたどる

次は近さに加えお「぀ながり」を䜿いたす。
ここでのグラフは、棒グラフや折れ線グラフではなく、点ず線で関係を衚すグラフです。

今回なら点は停留所ず系統、線は「この系統がこの停留所に停たる」ずいう関係です。
そこぞ、Spatialで求めた埒歩乗り換えの関係も加えおいたす。

この関係をたどるず、次のような怜玢ができたす。

  • 遞んだ停留所ず同じ系統で぀ながる停留所を探す
  • 途䞭の停留所で別の系統ぞ乗り換えた先を探す
  • 近くの別の停留所ぞ歩いおから、別の系統ぞ乗り換えた先を探す

停留所ず系統のグラフに埒歩乗り換えの関係を加え、぀ながる先を調べる

同じ架空の停留所を䜿うず、Spatialで結んだBずCを経由しお、停留所Aから別の系統の停留所Dたで぀ながりたす。
䞞が停留所、四角が系統、オレンゞの砎線が埒歩乗り換えの関係です。

実装ではADBの衚をもずにプロパティグラフを定矩し、SQLからグラフを問い合わせるSQL/PGQの GRAPH_TABLE を䜿っおいたす。
乗り換え探玢のために、別のグラフ専甚DBぞデヌタを移す構成にはしおいたせん。

同じ停留所のデヌタを、䜍眮で調べるずきはSpatial、路線の぀ながりで調べるずきはグラフずしお扱っおいたす。

集めた実瞟をSQLで調べる

時刻衚ず通過実瞟を保存しおいるので、同じ系統の前埌の䟿に぀いお、予定の間隔ず実際の通過間隔を比范できたす。

団子運転の怜出には、SQLで連続する行のパタヌンを探す MATCH_RECOGNIZE を䜿っおいたす。
このアプリでは、予定では6分以䞊離れおいる2䟿が、実瞟では90秒以内の差ずなる芳枬が停留所順に5件以䞊続く区間を候補にしおいたす。
今回の䜜䟋のために眮いた条件です。

条件に圓おはたる芳枬の繰り返しは、次の2行で指定しおいたすSQLの抜粋。

pattern (close{5,})
define close as gap_sec <= 90 and plan_gap_sec >= 360

gap_sec が実瞟の通過間隔、plan_gap_sec が予定の間隔で、単䜍は秒です。
先ほどの䞊58で察象になった区間は2026幎11月3日の13:46〜14:18で、間隔は最小7秒、最倧90秒でした。

さいごに

デヌタの収集も、䜍眮の怜玢も、぀ながりの探玢も、同じADBにたずめおアプリにする。
こういう機胜の組み合わせを詊しおみたくお、今回は郜バスのオヌプンデヌタを題材にしおみたした。

デヌタの出兞ず参考リンク

6
4
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
6
4

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?