---
search:
  tags:
    - デバイス
    - POST
seo:
  description: >-
    ONVIF に対応したカメラの首振り・ズームを操作します。カメラに ONVIF… Reference for the POST
    /devices/{id}/ptz endpoint in the ThingsConnect REST API.
sidebar:
  label: カメラの向きを変える（PTZ）
  badge: POST
title: カメラの向きを変える（PTZ）
type: openapi-operation
---
ONVIF に対応したカメラの首振り・ズームを操作します。カメラに ONVIF の接続情報を設定しておく必要があります（→ [カメラの設定](/docs/guides/camera)）。

| `action` | 動き | 使う項目 |
| --- | --- | --- |
| `relative` | 今の位置から指定した量だけ動かす | `pan`・`tilt`・`zoom`（-1〜1） |
| `absolute` | 指定した位置へ動かす | `pan`・`tilt`（-1〜1）、`zoom`（0〜1） |
| `preset` | カメラに登録したプリセットへ動かす | `presetToken` |
| `stop` | 動きを止める | なし |

カメラが動き始めた時点で返ります。映像は数秒遅れて届くので、動いた結果を画像で確かめるときは少し待ってから撮ってください。スコープは `data:write` が要ります。

`POST /devices/{id}/ptz`