Rozšíření plánování tras v REST API Mapy.com

1. 12. 2025

Rozšířili jsme funkci pro plánování tras v REST API Mapy.com. Změny vychází z častých podnětů našich uživatelů.

Nerozbíjíme zpětnou kompatibilitu – zachováváme stávající rozhraní a chování, pouze přidáváme nové vstupní a výstupní parametry. Existující integrace tak není nutné upravovat.

Nové vstupní parametry

avoidHighways
Ke stávajícímu parametru avoidToll (vyhnout se placeným úsekům) přidáváme nový parametr avoidHighways, který umožní při plánování tras vyhnout se dálnicím / rychlostním komunikacím.
departure
Volitelný čas odjezdu v lokálním čase (ISO-8601, např. 2025-01-01T00:00:00.000). Pokud není zadán, plánování používá „teď“. Parametr ovlivňuje časově závislá omezení (uzavírky, restrikce apod.).

Nové výstupní parametry

parts
Pole segmentů trasy mezi startem, případnými průjezdními body a cílem. Uživatel dostane pro každý úsek samostatně délku (length v metrech) a čas (duration ve vteřinách).
routePoints
Pole s detailními informacemi o startu, cíli a průjezdních bodech po „snapnutí“ do routovací sítě.
Hodnoty originalPosition, mappedPosition a snapDistance popisují posun vstupního bodu na nejbližší routovatelnou hranu.
Pokud je restricted = true, znamená to, že bod leží v oblasti, kam by se za běžných podmínek neplánovalo (např. omezená nebo nedostupná oblast), ale trasa byla přesto spočítána, protože byl bod explicitně zadán jako start, cíl nebo waypoint. Důvod omezení určuje atribut restrictionType.

Více najdete v dokumentaci