障害物写真
マップの障害物写真は Current Map エンティティカメラプロキシを介して表示されます。




プレビューは Dreame Vacuumカード
によって提供されます/api/camera_map_obstacle_proxy/{entity_id}?token={access_token}&index={obstacle_index}&crop={is_cropped}&file={download_file}
- entity_id: 現在のマップエンティティのID (
camera.{vacuum_name}_map) - access_token: カメラエンティティのアクセス トークン (
camera.{vacuum_name}_mapエンティティ属性から取得可能) - obstacle_index(任意、デフォルト = 1):障害物のインデックス(
camera.{vacuum_name}_mapエンティティ属性から取得可能) - is_cropped(任意、デフォルト = 1):アプリは一部のデバイスで境界が表示されないように障害物写真をトリミングしてレンダリングします。このパラメータは 0 に設定して元の障害物画像をレンダリングすることもできます。
- download_file(任意、デフォルト = 0):障害物の写真をダウンロードする場合は 1 に設定できます。
ヒント
要求された障害物が存在しない場合、404 を返します。
例:
text
http://local.homeassistant/api/camera_map_obstacle_proxy/camera.vacuum_map?token=5df93cfcf8ecc23fa17b233ca938cc52f41e2b17a46ca291865be3f9ba64d89b&index=2&crop=1ダッシュボード例
このエンドポイントの使用例については、カスタムカードテンプレートページの 障害物カード を参照してください。
履歴マップからの障害物写真
履歴マップの障害物写真は Current Map エンティティカメラプロキシを介して表示されます。
/api/camera_map_obstacle_history_proxy/{entity_id}?token={access_token}&history_index={history_index}&cruising={is_cruising_history}&index={obstacle_index}&crop={is_cropped}&file={download_file}
- entity_id: 現在のマップエンティティのID (
camera.{vacuum_name}_map) - access_token: カメラエンティティのアクセス トークン (
camera.{vacuum_name}_mapエンティティ属性から取得可能) - history_index (省略可能、デフォルト = 1): 1から25までの履歴エントリのインデックス (
sensor.{vacuum_name}_cleaning_historyエンティティ属性から取得可能) - is_cruising_history (省略可能、デフォルト = 0): 清掃履歴の代わりに巡回履歴を取得する場合は1に設定可能(巡回機能を持つデバイスのみ)
- obstacle_index(任意、デフォルト = 1):障害物のインデックス(
camera.{vacuum_name}_mapエンティティ属性から取得可能) - is_cropped(任意、デフォルト = 1):アプリは一部のデバイスで境界が表示されないように障害物写真をトリミングしてレンダリングします。このパラメータは 0 に設定して元の障害物画像をレンダリングすることもできます。
- download_file(任意、デフォルト = 0):障害物の写真をダウンロードする場合は 1 に設定できます。
ヒント
要求された履歴マップまたは障害物が存在しない場合、404 を返します。
例:
text
http://local.homeassistant/api/camera_map_obstacle_history_proxy/camera.vacuum_map?token=5df93cfcf8ecc23fa17b233ca938cc52f41e2b17a46ca291865be3f9ba64d89b&history_index=2&index=3