mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
SnapOtterandGitHub
4963ab3bbd
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
109 lines
5.1 KiB
Markdown
109 lines
5.1 KiB
Markdown
---
|
||
description: "ピクセルを再エンコードせずに、画像のEXIF、IPTC、GPS、XMP メタデータフィールドを編集します。"
|
||
i18n_source_hash: a37746db11c3
|
||
i18n_provenance: human
|
||
i18n_output_hash: cc4a554a90d8
|
||
---
|
||
|
||
# メタデータ編集 {#edit-metadata}
|
||
|
||
EXIF、IPTC、GPS座標、日付、キーワードを含む画像メタデータフィールドを編集します。内部でExifToolを使用するため、メタデータはピクセルを再エンコードせずにその場で書き込まれ、画像品質が完全に保持されます。
|
||
|
||
## API エンドポイント {#api-endpoints}
|
||
|
||
### メタデータ編集 {#edit-metadata-1}
|
||
|
||
`POST /api/v1/tools/image/edit-metadata`
|
||
|
||
メタデータフィールドを画像に書き込み、変更されたファイルを返します。
|
||
|
||
### メタデータ検査 {#inspect-metadata}
|
||
|
||
`POST /api/v1/tools/image/edit-metadata/inspect`
|
||
|
||
ExifTool経由で画像の全メタデータをJSONとして返します。画像は変更しません。
|
||
|
||
## パラメータ（編集） {#parameters-edit}
|
||
|
||
| パラメータ | 型 | 必須 | デフォルト | 説明 |
|
||
|-----------|------|----------|---------|-------------|
|
||
| title | string | いいえ | - | 画像タイトル（XMP/EXIF） |
|
||
| author | string | いいえ | - | 作成者名 |
|
||
| artist | string | いいえ | - | アーティスト名（EXIF Artistタグ） |
|
||
| copyright | string | いいえ | - | 著作権表示 |
|
||
| imageDescription | string | いいえ | - | 画像の説明（EXIF） |
|
||
| software | string | いいえ | - | ソフトウェアタグ |
|
||
| dateTime | string | いいえ | - | EXIF DateTime値 |
|
||
| dateTimeOriginal | string | いいえ | - | EXIF DateTimeOriginal値 |
|
||
| setAllDates | string | いいえ | - | すべての日付フィールドを一度に設定 |
|
||
| dateShift | string | いいえ | - | すべての日付をオフセット分ずらす（形式: `+HH:MM` または `-HH:MM`） |
|
||
| clearGps | boolean | いいえ | `false` | すべてのGPSデータを削除 |
|
||
| gpsLatitude | number | いいえ | - | GPS緯度を設定（-90〜90） |
|
||
| gpsLongitude | number | いいえ | - | GPS経度を設定（-180〜180） |
|
||
| gpsAltitude | number | いいえ | - | GPS高度をメートル単位で設定 |
|
||
| keywords | string[] | いいえ | - | 追加または設定するキーワード/タグ |
|
||
| keywordsMode | string | いいえ | `"add"` | キーワードの扱い方: `add`（追加）または `set`（置換） |
|
||
| fieldsToRemove | string[] | いいえ | `[]` | 削除する特定のメタデータフィールド名のリスト |
|
||
| iptcTitle | string | いいえ | - | IPTC Object Name |
|
||
| iptcHeadline | string | いいえ | - | IPTC Headline |
|
||
| iptcCity | string | いいえ | - | IPTC City |
|
||
| iptcState | string | いいえ | - | IPTC Province/State |
|
||
| iptcCountry | string | いいえ | - | IPTC Country |
|
||
|
||
## リクエスト例 {#example-request}
|
||
|
||
作成者と著作権を設定:
|
||
|
||
```bash
|
||
curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata \
|
||
-H "Authorization: Bearer si_your-api-key" \
|
||
-F "file=@photo.jpg" \
|
||
-F 'settings={"author": "Jane Smith", "copyright": "2024 Jane Smith"}'
|
||
```
|
||
|
||
GPS座標を設定:
|
||
|
||
```bash
|
||
curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata \
|
||
-H "Authorization: Bearer si_your-api-key" \
|
||
-F "file=@photo.jpg" \
|
||
-F 'settings={"gpsLatitude": 48.8566, "gpsLongitude": 2.3522, "gpsAltitude": 35}'
|
||
```
|
||
|
||
GPSを削除してキーワードを追加:
|
||
|
||
```bash
|
||
curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata \
|
||
-H "Authorization: Bearer si_your-api-key" \
|
||
-F "file=@photo.jpg" \
|
||
-F 'settings={"clearGps": true, "keywords": ["landscape", "sunset"], "keywordsMode": "add"}'
|
||
```
|
||
|
||
メタデータを検査:
|
||
|
||
```bash
|
||
curl -X POST http://localhost:1349/api/v1/tools/image/edit-metadata/inspect \
|
||
-H "Authorization: Bearer si_your-api-key" \
|
||
-F "file=@photo.jpg"
|
||
```
|
||
|
||
## レスポンス例（編集） {#example-response-edit}
|
||
|
||
```json
|
||
{
|
||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/photo.jpg",
|
||
"originalSize": 2450000,
|
||
"processedSize": 2452000
|
||
}
|
||
```
|
||
|
||
## 補足 {#notes}
|
||
|
||
- このツールはサーバーにExifToolがインストールされている必要があります。Dockerイメージには含まれています。
|
||
- メタデータはその場で書き込まれるため、ピクセルの再エンコードは発生しません。ファイルサイズの変化は最小限です（メタデータのバイト分のみ）。
|
||
- `dateShift` パラメータはすべての日付フィールドを指定したオフセット分ずらします。タイムゾーンエラーの修正に便利です（例: `+02:00` または `-05:30`）。
|
||
- 変更が要求されない場合（すべてのパラメータが省略または空）、元のファイルが変更されずに返されます。
|
||
- 対応形式: JPEG、PNG、WebP、AVIF、TIFF、GIF、HEIC/HEIF。
|
||
- ブラウザでプレビューできない形式（HEIF、TIFF）の場合、レスポンスにはWebPプレビューを含む `previewUrl` フィールドが含まれます。
|