API pro statickou Panoramu

Panorama na Mapy.cz je funkce podobná Street View, která vám umožní procházet většinu ulic v ČR a rozhlížet se do všech směrů.

Pro vývojáře jsou k dispozici aktuálně dva způsoby, jak Panoramu využít:

• JS Panorama – JavaScriptová komponenta, která poskytne vašim uživatelům podobný zážitek jako na Mapy.cz. Umožňuje volné rozhlížení a pohyb v panoramatickém zobrazení přímo ve vaší aplikaci. Více se dočtete v kapitole JS Panorama.
• Statická panorama (té se věnuje tato kapitola) – REST API, které vrací statický obrázek pohledu na zvolené místo. Stačí jej vložit například pomocí <img src="...">, přičemž v parametrech určíte polohu a směr pohledu. Obrázek je pevný a nelze s ním dále otáčet.

Obrázek vpravo je vygenerován právě pomocí funkce statické panoramy pomocí tohoto kódu.

<img src="https://api.mapy.cz/v1/static/pano?width=400&height=250&lon=16.6&lat=49.19&yaw=0&apikey={yourApiKey}" >

Na další příklady použití se podívejte v Tutoriálu pro Statickou panoramu.

Kde použít statickou panoramu

• Statickou panoramu vyžijete nejčastěji ve scénářích, kdy potřebujeme zobrazit fotku daného místa, a žádnou nemáme k dispozici. Místo fotky zobrazíme pohled na toto místo pomocí panoramy.
• Dále je možné ji využít jako rychle načteného zástupce tam, kde chcete uživatelům zpřístupnit dynamickou panoramu. Aby nebylo nutné rovnou načítat javaskripty „velké“ panoramy, zobrazí se pouze statický pohled a teprve po jeho prokliknutí uživatelem se spustí dynamická JS Panorama.

Technická dokumentace

https://api.mapy.cz/v1/docs/static/

Technická dokumentace obsahuje přesný popis vstupních parametrů návratových hodnot, dále omezení, výchozí hodnoty, chybové stavy a další podrobnosti.

Popis funkcí

• Statická panorama– funkce vrací obrázek ve formátu JPEG, který má zvolenou velikost a obsahuje pohled z určeného místa určený směrem. Samozřejmě pouze tehdy, pokud je panorama dostupná v blízkém okolí zvoleného místa.

Vstupní parametry