res.tmimg.cz

Tato služba je mimo API (nemusíte mít zřízený přístup), avšak je vhodná v kombinaci při práci s API.

Zavoláním konkrétní URL získáte obrázek v požadované velikosti a úpravách. Tento je později na serveru cacheován (včetně respektování HTTP hlaviček jako Last-Modified, E-tag apod.) tj. toto URL můžete používat i ve Vaší aplikaci!

Zmenšení obrázků na požadovanou velikost

Zmenšení se provede zavoláním URL ve tvaru

http(s)://res.tmimg.cz/{agenda (t|d|p)}/i/{floor(ID inzerátu/1000)}/{ID inzerátu}_{ID obrázku}/{šířka}x{výška}{mód (m|c|f|r)}{-parametry}.{format}

Jednotlivé možnosti:

Lze volat http nebo https
{agenda} - odkazuje na agendu: t pro motocykly, d pro díly a p pro příslušenství.
Tuto lze okopírovat i ze standardního URL obrázku.
{šířka}x{výška} - šířka a výška obrázku v pixelech
Pro určité módy ořezu lze jeden z parametrů vynechat
{format}
- jpg
- png
- webp

Základní příklad - je-li např. URL:

https://d.tmimg.cz/d/i/12/12345_9.jpg

Základní URL pro resize tedy bude:

https://res.tmimg.cz/d/i/12/12345_9/800x600.jpg

Pokročilé možnosti:

{mód}
- m - max
  Výchozí mód (není-li vyplněný)
  V tomto módu se zvětší na největší z daných rozměrů - druhý se dopočítá tak, abyc nedošlo ke změně poměru foto.
  Lze neuvést jeden z rozměrů, pak bude vždy zvětšeno na konkrétní šířku nebo výšku obrázku.
- c - crop
  Dojde k úpravě, že fotka vyplní celý zadaný prostor a bude oříznuta tak, aby nedošlo ke změně poměru stran
- f - fill
  Fotka se zmenší přesně na danou velikost a chybějící místo se doplní parametrem bg
- r - resize
  Fotka se upraví přesně na danou velikost i za cenu nedodržení poměru.
{-parametry}
Parametry nejsou povinné. Každý parametr se zapisuje ve stylu -nazev_hodnota a může jich být za sebou více
Seznam parametrů:
- e - engine
  Vyberte engine, který provede úpravu obrázků.
  - im - ImageMagick (resp. pro WebP kombinace ImageMagick + CWebP)
  - gd - GD knihovna
- q - quality
  Kvalita. Výchozí hodnota 75.
  - JPEG (0-100)
  - PNG (0-100, pro GD hodnota 0-9)
  - WebP (0-100)
- c - compress method
  Metoda komprese
  - JPEG (p) - je-li hodnota p, udělá progresivní JPEG
  - WebP (pouze pro ImageMagick 0-6, výchozí 4) - odpovídá parametru -m u cwebp
- bg - background
  Pozadí pro mód ořezu fill. Zapisuje RGB v hodnotách 0-255 s podtržítky - např.: -bg_255_0_0 pro červené pozadí
  Výchozí barva - bílá (255_255_255)
- f - filter
  Pouze pro ImageMagick - doplňuje zvolený filtr. Výchozí hodnota: CATROM
  Možné hodnoty: UNDEFINED, POINT, BOX, TRIANGLE, HERMITE, HANNING, HAMMING, BLACKMAN, GAUSSIAN, QUADRATIC, CUBIC, CATROM, MITCHELL, LANCZOS, BESSEL, SINC
- nc - no-cache
  Bez hodnoty - pouze parametr -nc
  Ignoruje obrázek v cache (je-li uložen) a vygeneruje znovu (tento opět uloží do cache)

Příklad URL:

https://res.tmimg.cz/t/i/123/123456_7/800x600f-q_80-bg_0_0_255.jpg

Vytvoří z obrázku č. 7 u moto-inzerátu ID 123456 JPEG obrázek v kvalitě 80 ve velikosti 800x600 - obrázek bude doplněný na modrém pozadí.

Informace o velikostech obrázku

Systém poskytuje i informace o velikosti obrázku a to zavoláním URL ve tvaru:

http(s)://res.tmimg.cz/{agenda (t|d|p)}/i/{floor(ID inzerátu/1000)}/{ID inzerátu}_{ID obrázku}.{format}

Jednotlivé možnosti:

Lze volat http nebo https
{agenda} - odkazuje na agendu: t pro motocykly, d pro díly a p pro příslušenství.
Tuto lze okopírovat i ze standardního URL obrázku.
{format}
- json - vrací data ve formátu JSON
- xml - vrací data ve formátu XML

Základní příklad - je-li např. URL:

https://d.tmimg.cz/d/i/12/12345_9.jpg

Základní URL pro získání velikostí tedy bude:

https://res.tmimg.cz/d/i/12/12345_9.xml

Resize v API

Na základě Vašich požadavků byla změna velikosti obrázků byl zabudován i do API - podagenda resize patřící pod agendu photo.
Reálně je realizováno zasíláním požadavků na res.tmimg.cz