MyBMWアプリのパブリックAPIを活用したスマートホーム連携：エンジニア視点での自作システム構築ガイド

1. BMW Developer Portalへのアクセス: https://developer.bmw.com/ にアクセスし、アカウントを作成またはログインします。

2. アプリケーションの登録: 「My Apps」セクションに進み、「Create new App」をクリックします。アプリケーション名、説明、そして最も重要な「Redirect URI」を設定します。Redirect URIは、OAuth2.0の認証プロセス後にBMWの認証サーバーがコードを送信する先のURLです。ローカル開発環境の場合は http://localhost:8080/callback など、ウェブサービスの場合はご自身のサービスのURLを指定します。

3. Client IDとClient Secretの取得: アプリケーション登録後、Client IDとClient Secretが発行されます。これらは非常に重要なので、安全な場所に保管してください。決して公開リポジトリなどに直接記述しないでください。

4. OAuth 2.0 認可コードフローの実装:
– ユーザーをBMWの認可エンドポイントにリダイレクトし、承認を求めます。
– 承認後、Redirect URIに「認可コード (Authorization Code)」が返されます。
– この認可コードとClient ID、Client Secretを使用して、BMWのトークンエンドポイントにリクエストを送信し、「アクセストークン (Access Token)」と「リフレッシュトークン (Refresh Token)」を取得します。

Pythonでの実装例では、requests_oauthlibのようなライブラリを使用すると比較的容易に実装できます。

from requests_oauthlib import OAuth2Session
import os

client_id = os.environ.get("BMW_CLIENT_ID")
client_secret = os.environ.get("BMW_CLIENT_SECRET")
redirect_uri = "http://localhost:8080/callback" # あなたのRedirect URI

authorization_base_url = "https://customer.bmwgroup.com/gcdm/oauth/authenticate"
token_url = "https://customer.bmwgroup.com/gcdm/oauth/token"
scope = ["vehicle_data", "remote_control"] # 必要なスコープを指定

oauth = OAuth2Session(client_id, redirect_uri=redirect_uri, scope=scope)

# 1. ユーザーを認可URLにリダイレクト
authorization_url, state = oauth.authorization_url(authorization_base_url)
print(f"Please go to {authorization_url} and authorize access.")

# 2. ユーザーが承認後、Redirect URIにコードが返される（手動でURLから取得するか、ウェブサーバーで受け取る）
# 例: code = input("Enter the full callback URL: ").split("code=")[1].split("&")[0]

# 3. 認可コードを使ってトークンを取得
# token = oauth.fetch_token(token_url, client_secret=client_secret, code=code)
# print(token)

# アクセストークンは短期間で期限切れになるため、リフレッシュトークンを使って定期的に更新します。
# new_token = oauth.refresh_token(token_url, refresh_token=token['refresh_token'], client_id=client_id, client_secret=client_secret)
# print(new_token)

BMW APIのベースURLは https://api.bmwgroup.com/ です。主要なエンドポイントの例を挙げます。

• 車両リストの取得: GET /v1/user/vehicles

  登録されている車両のVIN（車両識別番号）などの情報を取得できます。

  headers = {"Authorization": f"Bearer {access_token}"}
  response = requests.get("https://api.bmwgroup.com/v1/user/vehicles", headers=headers)
  vehicles_data = response.json()
  # {"vehicles": [{"vin": "WBA...", "model": "BMW iX3", ...}]}

• 特定車両のステータス取得: GET /v1/user/vehicles/{vin}/state

  指定したVINの車両の現在の状態（ドアロック状態、走行距離、燃料レベル、充電状態など）を取得できます。

  vin = "YOUR_BMW_VIN"
  response = requests.get(f"https://api.bmwgroup.com/v1/user/vehicles/{vin}/state", headers=headers)
  vehicle_state = response.json()
  # {"state": {"doorLockState": "LOCKED", "mileage": {"value": 12345, "unit": "km"}, ...}}

• ドアロックの操作: POST /v1/user/vehicles/{vin}/remote-control/door-lock

  車両のドアをロックします。リモート操作系はPOSTリクエストで実行します。

  response = requests.post(f"https://api.bmwgroup.com/v1/user/vehicles/{vin}/remote-control/door-lock", headers=headers)
  # 成功すれば200 OKが返る

• エアコンの起動 (プリコンディショニング): POST /v1/user/vehicles/{vin}/remote-control/climate-control/start

  車両のエアコンを起動します。乗車前に車内を快適な温度にしておくことができます。

これらのエンドポイントとJSONレスポンスの詳細は、BMW Developer PortalのAPIドキュメントを参照してください。リクエストの際には、Authorization: Bearer <access_token> ヘッダーを必ず含める必要があります。

1. 車両位置情報の取得: MyBMW APIの /v1/user/vehicles/{vin}/state エンドポイントから、position オブジェクト内の緯度・経度を取得します。

2. ジオフェンスの実装: サーバーレス関数（AWS Lambdaなど）を数分おきに実行し、取得した車両の緯度・経度と、あらかじめ設定しておいた自宅の緯度・経度を比較します。距離計算には、Haversineの公式やGeoPyライブラリなどが利用できます。特定の距離（例: 100m）以内に入ったら「自宅に接近」と判定します。

3. ガレージドアの制御: 「自宅に接近」と判定された場合、Home AssistantなどのホームオートメーションハブのAPIを呼び出します。Home Assistantでは、スマートガレージドアオープナー（例: Shelly 1、Meross Smart Wi-Fi Garage Door Openerなど）を統合しておき、そのエンティティの状態を切り替えるサービスコールを実行します。

# Pythonでの距離計算例
from geopy.distance import geodesic

home_coords = (YOUR_HOME_LATITUDE, YOUR_HOME_LONGITUDE)
vehicle_coords = (vehicle_state['state']['position']['latitude'], vehicle_state['state']['position']['longitude'])

distance_km = geodesic(home_coords, vehicle_coords).km

if distance_km < 0.1: # 100m以内
    print("Vehicle is near home. Opening garage door...")
    # Home AssistantのAPIを呼び出す処理

1. 充電ステータスの取得: 同様に /v1/user/vehicles/{vin}/state エンドポイントから chargingState を監視します。

2. 状態変化の検出: サーバーレス関数がポーリングするたびに、前回の充電ステータスと比較します。chargingState が CHARGING に変化した場合をトリガーとします。

3. スマートスピーカーへの通知: Home Assistantにスマートスピーカーを統合している場合、通知サービス（例: tts.google_say）を使って音声メッセージを再生できます。直接スマートスピーカーのAPIを叩くことも可能ですが、Home Assistant経由の方が統合が容易なことが多いです。

# Pythonでの充電ステータス確認例
if vehicle_state['state']['chargingState'] == 'CHARGING' and previous_charging_state != 'CHARGING':
    print("Charging has started! Announcing on smart speaker...")
    # Home Assistantの通知APIを呼び出す（例: MQTTやREST）
    # payload = {"message": "BMWの充電が開始されました。"}
    # requests.post("http://homeassistant:8123/api/services/tts/google_say", headers=ha_headers, json=payload)