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",
      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
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

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