URL Mapy.cz
S dokumentovanými URL Mapy.cz můžete snadno sestavit URL, kterým rozumí Mapy.cz (web i mobilní aplikace). Provoláním této URL zavoláte vybranou funkci (zobrazení mapy, vyhledávání, plánování,…).
Díky těmto URL můžete snadno spouštět/otvírat Mapy.cz z vašeho webu či aplikace. Provoláním na webu se otevře web Mapy.cz. Provoláním na mobilu se spustí mobilní aplikace Mapy.cz (je-li nainstalovaná, jinak též webová verze).
Prefix všech URL: https://mapy.cz/fnc/v1
URL Mapy.cz jsou volně a zdarma dostupné. Pro své volání nevyžadují API klíč.
/showmap
Slouží pro nastaveni zobrazeni mapy na definovaných souřadnicích a k zobrazeni bodu
Parametry:
mapset | string | Definuje mapset na zobrazené mapě. Výchozí hodnota je “basic”. Validní hodnoty jsou: basic, outdoor, winter, aerial, traffic. |
center | string | Definuje střed mapy (zároveň i pozici bodu, pokud je parametr marker nastaven na true). Výchozí hodnota je prázdný řetězec. Formát: lon,lat. |
zoom | number | Definuje zoom mapy. Výchozí hodnota je prázdný řetězec. |
marker | boolean | Určuje, zda se má na zadaných souřadnicích (parametr center) zobrazit marker. Výchozí hodnota je false. |
Příklady:
- https://mapy.cz/fnc/v1/showmap
- https://mapy.cz/fnc/v1/showmap?mapset=winter
- https://mapy.cz/fnc/v1/showmap?mapset=winter¢er=14.4203523,50.0313731
- https://mapy.cz/fnc/v1/showmap?mapset=winter¢er=14.4203523,50.0313731&zoom=16
- https://mapy.cz/fnc/v1/showmap?mapset=winter¢er=14.4203523,50.0313731&zoom=16&marker=true
/search
Slouží pro zobrazení výsledků hledání
Parametry:
mapset | string | Definuje mapset na zobrazené mapě. Výchozí hodnota je “basic”. Validní hodnoty jsou: basic, outdoor, winter, aerial, traffic. |
center | string | Definuje střed mapy. Výchozí hodnota je prázdný řetězec. Formát: lon,lat. |
zoom | number | Definuje zoom mapy. Výchozí hodnota je prázdný řetězec. |
query | string | Definuje hledaný dotaz. Výchozí hodnota je prázdný řetězec. |
Příklady:
- https://mapy.cz/fnc/v1/search
- https://mapy.cz/fnc/v1/search?query=restaurace
- https://mapy.cz/fnc/v1/search?query=restaurace&mapset=outdoor
- https://mapy.cz/fnc/v1/search?query=restaurace&mapset=outdoor¢er=14.4203523,50.0313731
- https://mapy.cz/fnc/v1/search?query=restaurace&mapset=outdoor¢er=14.4203523,50.0313731&zoom=16
/route
Slouží pro zobrazení plánované trasy
Parametry:
mapset | string | Definuje mapset na zobrazené mapě. Výchozí hodnota je “basic”. Validní hodnoty jsou: basic, outdoor, winter, aerial, traffic. |
start | string | Definuje startovací bod. Výchozí hodnota je prázdný řetězec. Formát: lon,lat. |
end | string | Definuje cílový bod. Výchozí hodnota je prázdný řetězec. Formát: lon,lat. |
routeType | string | Definuje typ plánování. Výchozí hodnota je “car_fast”. Validní hodnoty jsou: car_fast, car_fast_traffic, car_short, foot_fast, bike_road, bike_mountain. |
waypoints | string | Definuje průjezdní body (max 15). Výchozí hodnota je prázdný řetězec. Formát: lon,lat; lon,lat;… |
navigate | boolean | Určuje, zda se má v mobilní aplikaci rovnou zapnout navigace. Výchozí hodnota je false. Pozn. tento parametr podporují pouze novější verze aplikací – vydaných od dubna 2024 dále. Starší aplikace pouze otevřou trasu a navigaci je možné spustit ručně. |
Příklady:
- https://mapy.cz/fnc/v1/route
- https://mapy.cz/fnc/v1/route?mapset=traffic
- https://mapy.cz/fnc/v1/route?mapset=traffic&start=14.4606,50.0878
- https://mapy.cz/fnc/v1/route?mapset=traffic&end=14.3681,50.0292
- https://mapy.cz/fnc/v1/route?mapset=traffic&start=14.4606,50.0878&routeType=car_fast_traffic
- https://mapy.cz/fnc/v1/route?mapset=traffic&end=14.3681,50.0292&routeType=car_short
- https://mapy.cz/fnc/v1/route?mapset=traffic&start=14.4606,50.0878&end=14.3681,50.0292
- https://mapy.cz/fnc/v1/route?mapset=traffic&start=14.4606,50.0878&end=14.3681,50.0292&routeType=car_fast_traffic
- https://mapy.cz/fnc/v1/route?mapset=traffic&start=14.4606,50.0878&end=14.3681,50.0292&routeType=car_fast_traffic&waypoints=14.5087,50.0335
- https://mapy.cz/fnc/v1/route?mapset=traffic&start=14.4606,50.0878&end=14.3681,50.0292&routeType=car_fast_traffic&waypoints=14.5377,50.0831;14.5087,50.0335
- https://mapy.cz/fnc/v1/route?mapset=traffic&start=14.4606,50.0878&end=14.3681,50.0292&navigate=true
- https://mapy.cz/fnc/v1/route?mapset=traffic&start=14.4606,50.0878&end=14.3681,50.0292&routeType=car_fast_traffic&waypoints=14.5377,50.0831;14.5087,50.0335&navigate=true