Copy page

Dokumentace

Mapový widget

Mapový widget umožňuje vložit do vašich stránek interaktivní mapu se všemi podacími a výdejními místy podporovaných dopravců. Zákazník si na mapě vybere konkrétní místo a vy dostanete jeho identifikátor zpět do vaší aplikace — typicky pro vyplnění pickup_branch/delivery_branch v objednávce zásilky.

Vyzkoušet

Widget je stejný, jaký běží na produkci — funguje tedy i zde. Zvolte parametry a otevřete mapu.

Načítám widget…

Vložení do vlastní stránky

Widget se načte jako externí skript a ovládá se funkcí zslt.openMap(), která vrací Promise s vybraným místem.

Code
window.zslt = {};

const script = document.createElement("script");
script.id = "zaslat-map";
script.async = true;
script.src = "https://app.zaslat.cz/map/zaslat-map.umd.min.js";
document.head.appendChild(script);

function openMap() {
  zslt
    .openMap({
      addressType: "recipient",
      addressQuery: "Brno",
      territory: "cz",
      carriers: ["balikovna", "dpd", "gls", "ppl", "zasilkovna"],
      lang: "cz",
      prices: {
        balikovna: "59 Kč",
        dpd: "59 Kč",
        gls: "59 Kč",
        ppl: "59 Kč",
        zasilkovna: "59 Kč",
      },
      style: {
        colorPrimary: "#000",
      },
      value: null,
    })
    .then(function (point) {
      console.log(point);
    });
}

Konfigurační parametry

Parametr	Typ	Popis	Povinný
addressType	sender | recipient	Režim mapy — výběr podací nebo výdejní adresy	ne
addressQuery	string	Adresa, město nebo PSČ, na které se mapa po otevření vycentruje (např. doručovací adresa z košíku)	ne
carriers	array	Omezí mapu na vybrané dopravce	ne
territory	cz | sk	Vycentrování mapy na zemi (výchozí filtr země)	ne
lang	cz | sk | en	Jazyk widgetu	ne
prices	object	Zobrazení ceny u jednotlivých dopravců	ne
style	object	Vzhled widgetu (např. colorPrimary)	ne
value	id místa	Otevře mapu s předvybraným místem	ne

Výchozí poloha mapy

Kde se mapa po otevření zobrazí, určuje první z těchto voleb, která je zadaná:

1. value — mapa se otevře přímo na předvybraném místě.
2. addressQuery — text se geokóduje (město, ulice s číslem, PSČ) a mapa se vycentruje na nalezenou adresu. Hodí se pro předvyplnění z doručovací adresy, kterou má zákazník v košíku.
3. Bez obou voleb se widget pokusí použít polohu z prohlížeče (se souhlasem uživatele), jinak zobrazí výchozí pohled podle territory.

Jiné parametry pro polohu (search, city, zip, center, zoom) widget nezná a ignoruje je.

Návratová hodnota Promise obsahuje vybrané místo ve tvaru odpovídajícímu objektu ParcelPoint z API reference.