1. これはなに？

「浜松で地域課題解決やらまいか！データ・フュージョン・キャンプ2024」にて作成した、浜松市のイベントデータのオープンデータのCSVファイルをダウンロードし、FIWARE Orion と送受信するサンプルコードです。

２．概要

FIWARE Orion Context Brokerを使用してイベントデータを送受信するプログラムです。

送信プログラム: イベントデータをFIWARE Orionに送信します。
受信プログラム: 指定した日付のイベントデータをFIWARE Orionから取得し、日本語の項目名でJSONファイルに出力します。

必要な環境とライブラリ

Python 3.x
以下のコマンドで必要なPythonライブラリをインストールします:
```
pip install -r requirements.txt
```

環境変数の設定

.envファイルを作成し、以下の情報を設定してください。

FIWARE_AUTHORIZATION=yourauthorizationkey
FIWARE_ORION_ENDPOINT=http://yourendpoint/
FIWARE_SERVICE=hamamatsu_event
FIWARE_SERVICE_PATH=/events
CSV_URL=https://example.com/yourdata.csv

FIWARE_AUTHORIZATION: 認証トークン（必要な場合のみ）
FIWARE_ORION_ENDPOINT: FIWARE OrionのエンドポイントURL
FIWARE_SERVICE: FIWAREのサービス名
FIWARE_SERVICE_PATH: FIWAREのサービスパス
CSV_URL: CSVファイルのURL

送信プログラムの使い方

プログラムの実行

python push.py

プログラムの概要 .envで指定したURLからCSVファイルをダウンロードし、翌日のイベント分をFIWARE Orionに送信します。環境変数から取得した情報を使用して、リクエストヘッダーを設定します。

受信プログラムの使い方

プログラムの実行

python pull.py YYYY-MM-DD

YYYY-MM-DD: 取得したいイベントの日付

プログラムの概要

指定した日付のイベントをFIWARE Orionから取得し、日本語の項目名でJSONファイルに出力します。
出力ファイルはevents_YYYY-MM-DD.jsonという形式になります

プログラムのフロー図

送信プログラムのフロー図

flowchart TD
    A[開始] --> E[.envファイルから環境変数を読み込む]
    E --> F[リクエストヘッダーを準備]
    F --> G[送信するデータを準備]
    G --> H[FIWARE Orionにデータを送信]
    H --> I{レスポンスは成功か?}
    I -- はい --> J[成功メッセージを表示]
    I -- いいえ --> K[エラーメッセージを表示して終了]
    J --> L[終了]
    K --> L

受信プログラムのフロー図

flowchart TD
    A[開始] --> B{日付引数が指定されているか?}
    B -- いいえ --> C[使用法を表示して終了]
    B -- はい --> D[指定された日付をパース]
    D --> E[.envファイルから環境変数を読み込む]
    E --> F[リクエストヘッダーを準備]
    F --> G[クエリパラメータを作成]
    G --> H[最初のクエリを送信]
    H --> I{レスポンスは成功か?}
    I -- いいえ --> J[エラーメッセージを表示して終了]
    I -- はい --> K[2つ目のクエリを送信]
    K --> L{レスポンスは成功か?}
    L -- いいえ --> J
    L -- はい --> M[結果を結合し重複を排除]
    M --> N[属性名を日本語にマッピング]
    N --> O[JSONファイルに書き込む]
    O --> P[成功メッセージを表示]
    P --> Q[終了]
    C --> Q
    J --> Q

３．ライセンス

このプロジェクトはMITライセンスの下で公開されています。

４．作者

TEAM AMEOTOKO

ryomrt/eventdata_to_orion