# 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](/api/v1/customs_shipment_order).

## Vyzkoušet

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

<MapWidgetDemo />

## 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.

```javascript
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](/api-v1/~schemas#parcelpoint) z API reference.