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
4.4 KiB
Markdown
109 lines
4.4 KiB
Markdown
---
|
|
description: "Edit field metadata EXIF, IPTC, GPS, dan XMP dalam gambar tanpa mengenkode ulang piksel."
|
|
i18n_source_hash: a37746db11c3
|
|
i18n_provenance: human
|
|
i18n_output_hash: 9e6badffd745
|
|
---
|
|
|
|
# Edit Metadata {#edit-metadata}
|
|
|
|
Edit field metadata gambar termasuk EXIF, IPTC, koordinat GPS, tanggal, dan kata kunci. Menggunakan ExifTool di baliknya, sehingga metadata ditulis di tempat tanpa mengenkode ulang piksel, mempertahankan kualitas gambar penuh.
|
|
|
|
## API Endpoint {#api-endpoints}
|
|
|
|
### Edit Metadata {#edit-metadata-1}
|
|
|
|
`POST /api/v1/tools/image/edit-metadata`
|
|
|
|
Menulis field metadata ke gambar dan mengembalikan file yang dimodifikasi.
|
|
|
|
### Inspeksi Metadata {#inspect-metadata}
|
|
|
|
`POST /api/v1/tools/image/edit-metadata/inspect`
|
|
|
|
Mengembalikan metadata lengkap dari gambar via ExifTool sebagai JSON. Tidak memodifikasi gambar.
|
|
|
|
## Parameter (Edit) {#parameters-edit}
|
|
|
|
| Parameter | Tipe | Wajib | Default | Deskripsi |
|
|
|-----------|------|----------|---------|-------------|
|
|
| title | string | Tidak | - | Judul gambar (XMP/EXIF) |
|
|
| author | string | Tidak | - | Nama penulis |
|
|
| artist | string | Tidak | - | Nama artis (tag EXIF Artist) |
|
|
| copyright | string | Tidak | - | Pemberitahuan hak cipta |
|
|
| imageDescription | string | Tidak | - | Deskripsi gambar (EXIF) |
|
|
| software | string | Tidak | - | Tag perangkat lunak |
|
|
| dateTime | string | Tidak | - | Nilai EXIF DateTime |
|
|
| dateTimeOriginal | string | Tidak | - | Nilai EXIF DateTimeOriginal |
|
|
| setAllDates | string | Tidak | - | Atur semua field tanggal sekaligus |
|
|
| dateShift | string | Tidak | - | Geser semua tanggal berdasarkan offset (format: `+HH:MM` atau `-HH:MM`) |
|
|
| clearGps | boolean | Tidak | `false` | Hapus semua data GPS |
|
|
| gpsLatitude | number | Tidak | - | Atur lintang GPS (-90 hingga 90) |
|
|
| gpsLongitude | number | Tidak | - | Atur bujur GPS (-180 hingga 180) |
|
|
| gpsAltitude | number | Tidak | - | Atur ketinggian GPS dalam meter |
|
|
| keywords | string[] | Tidak | - | Kata kunci/tag yang ditambahkan atau diatur |
|
|
| keywordsMode | string | Tidak | `"add"` | Cara menangani kata kunci: `add` (tambahkan) atau `set` (ganti) |
|
|
| fieldsToRemove | string[] | Tidak | `[]` | Daftar nama field metadata spesifik yang dihapus |
|
|
| iptcTitle | string | Tidak | - | IPTC Object Name |
|
|
| iptcHeadline | string | Tidak | - | IPTC Headline |
|
|
| iptcCity | string | Tidak | - | IPTC City |
|
|
| iptcState | string | Tidak | - | IPTC Province/State |
|
|
| iptcCountry | string | Tidak | - | IPTC Country |
|
|
|
|
## Contoh Permintaan {#example-request}
|
|
|
|
Atur penulis dan hak cipta:
|
|
|
|
```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"}'
|
|
```
|
|
|
|
Atur koordinat 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}'
|
|
```
|
|
|
|
Hapus GPS dan tambahkan kata kunci:
|
|
|
|
```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"}'
|
|
```
|
|
|
|
Inspeksi metadata:
|
|
|
|
```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"
|
|
```
|
|
|
|
## Contoh Respons (Edit) {#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
|
|
}
|
|
```
|
|
|
|
## Catatan {#notes}
|
|
|
|
- Alat ini memerlukan ExifTool terpasang di server. Ini sudah disertakan dalam image Docker.
|
|
- Metadata ditulis di tempat, sehingga tidak terjadi enkode ulang piksel. Perubahan ukuran file minimal (hanya byte metadata).
|
|
- Parameter `dateShift` menggeser semua field tanggal berdasarkan offset yang ditentukan, berguna untuk memperbaiki kesalahan zona waktu (mis. `+02:00` atau `-05:30`).
|
|
- Jika tidak ada perubahan yang diminta (semua parameter dihilangkan atau kosong), file asli dikembalikan tanpa perubahan.
|
|
- Format yang didukung: JPEG, PNG, WebP, AVIF, TIFF, GIF, HEIC/HEIF.
|
|
- Untuk format yang tidak dapat dipratinjau di browser (HEIF, TIFF), respons menyertakan field `previewUrl` dengan pratinjau WebP.
|