https://github.com/unyacat/westjr
JR西日本列車走行位置 非公式API Pythonライブラリ
https://github.com/unyacat/westjr
python3 westjr
Last synced: 9 months ago
JSON representation
JR西日本列車走行位置 非公式API Pythonライブラリ
- Host: GitHub
- URL: https://github.com/unyacat/westjr
- Owner: unyacat
- License: unlicense
- Created: 2021-03-27T15:57:06.000Z (over 5 years ago)
- Default Branch: develop
- Last Pushed: 2025-09-22T17:34:45.000Z (9 months ago)
- Last Synced: 2025-09-22T19:30:40.023Z (9 months ago)
- Topics: python3, westjr
- Language: Python
- Homepage:
- Size: 302 KB
- Stars: 30
- Watchers: 1
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# WestJR
[](https://results.pre-commit.ci/latest/github/unyacat/westjr/master)
JR西日本列車走行位置 非公式API Pythonライブラリ
* 列車走行位置取得 (`/api/v3/{LINE}.json`)
* メンテナンス予定取得 (`/api/v3/area_{AREA}_maintenance.json`)
* 路線名取得 (`/api/v3/area_{AREA}_master.json`)
* 駅一覧取得 (`/api/v3/{LINE}_st.json`)
* 運行情報取得 (`/api/v3/area_{AREA}_trafficinfo.json`)
* 列車環境取得 (`/api/v3/trainmonitorinfo.json`)
* 列車走行位置駅名，列車停車種別の変換
## Notice
* 動作を完全には確認していません．
## Installation
```bash
pip install WestJR
```
## Usage
[Wiki](https://github.com/unyacat/westjr/wiki) に情報があります．
```python
import westjr
jr = westjr.WestJR()
# あらかじめ area や line をセットする
jr = westjr.WestJR(line="kobesanyo", area="kinki")
```
### Example
#### 列車走行位置取得
```python
print(jr.get_trains())
# TrainPos(update='2023-03-21T16:54:54.612Z', trains=[TrainsItem(no='502C', ...
```
#### メンテナンス予定取得
```python
print(jr.get_maintenance())
# 平常時:
# AreaMaintenance(status=0, notification=Notification(groupId=0, text='', duration=''), ...
# 異常時:
# AreaMaintenance(status=1, notification=Notification(groupId=2023012802, text='1月24日から1月31日を, ...
```
#### 路線一覧取得
```python
print(jr.get_lines())
# AreaMaster(lines={'ako': Line(name='赤穂線', range='相生〜播州赤穂', relatelines=None, st='...
```
#### 駅一覧取得
```python
print(jr.get_stations())
# Stations(stations=[StationsItem(info=Info(name='新大阪', code='0415', stopTrains=[1, 2, 5], typeNotice=None, ...
```
#### 運行情報取得
```Python
print(jr.get_traffic_info())
# 平常時:
# TrainInfo(lines={}, express={})
# 異常時:
# TrainInfo(lines={'bantan': Info_LineItem(...)}, express={'bantan': Info_ExpressItem(...)})
```
#### エリア名一覧表示
```python
print(jr.areas)
# ['hokuriku', 'kinki', 'okayama', 'hiroshima', 'sanin']
```
#### 路線名一覧表示
```python
print(jr.lines)
# ['hokuriku', 'kobesanyo', 'hokurikubiwako', 'kyoto', 'ako', 'kosei', 'kusatsu', 'nara', 'sagano', 'sanin1', 'sanin2', 'osakahigashi', 'takarazuka']
```
#### 列車環境取得
```python
print(jr.get_train_monitor_info().trains["3489M"][0].cars[0].congestion)
# 26(%)
print(jr.get_train_monitor_info().trains["3489M"][0].cars[0].temp)
# 23(°C)
```
#### 駅に停車する種別を id から名称に変換する
```python
station = jr.get_stations(line="kyoto").stations[0]
print(station.info.name)
# 山科
print(jr.convert_stopTrains(station.info.stopTrains))
# ['新快速', '快速', '特急']
```
#### 列車走行位置の場所を前駅と次駅の名前に変換する
```python
train = jr.get_trains(line="kobesanyo").trains
tr = train[0]
prev, next = jr.convert_pos(train=tr)
print(prev)
# 塚本
```
## Contribution
* develop ブランチにお願いします
* インストールしていなければ [poetry](https://python-poetry.org/docs/master/) をインストールしてください
* 初回は `poetry install && poetry run pre-commit install` を実行することで `poetry` と `pre-commit` のセットアップが行えます
* `poetry shell` を実行すると仮想環境で開発することができます