Copy page

Mapový widget

Mapový widget v2

Mapový widget je mapa podacích a výdejních míst, kterou vložíte do své stránky, typicky do košíku e-shopu v kroku výběru dopravy. Zákazník na jedné mapě vidí výdejní boxy a pobočky všech podporovaných dopravců, vybere si místo jedním klepnutím a vaše aplikace dostane vybrané místo zpět. Mapu načtete jedním skriptem; dopravce, jazyk, ceny i vzhled si nastavíte podle svého.

Mapu si s vlastními parametry vyzkoušíte v interaktivní ukázce. Vložení skriptu, konfiguraci a všechny možnosti mapy popisuje technická dokumentace na webu widgetu (v angličtině).

Níže je náhled mapy: stejná mapa, jen bez tlačítka pro výběr místa. Tlačítkem v pravém horním rohu ji otevřete přes celou stránku.

Načítám mapu…

Vložení do stránky

Celá integrace je jeden skript:

Code
<script type="module">
  import { ZaslatMap } from 'https://map.zaslat.cz/v2/2/sdk/main.js'

  const map = new ZaslatMap()
  const point = await map.open({ country: 'cz' })
</script>

Volání open() otevře mapu přes celou stránku a vrátí vybrané místo. Když zákazník mapu zavře křížkem nebo klávesou Escape, vrátí null.

Mapa se nastavuje na dvou místech:

• Konfigurace (config) je argument new ZaslatMap(config). Platí po celou dobu života mapy a říká, jak mapa u vás funguje: jazyk rozhraní, ceny výdeje u jednotlivých dopravců, případně vlastní vzhled dopravců.
• Možnosti otevření (openOptions) jsou argument map.open(openOptions). Platí pro jedno otevření a říkají, co má mapa právě ukázat: zemi, povolené dopravce, jen boxy nebo jen pobočky, adresu, na které se mapa otevře, nebo dříve vybrané místo.

Obojí je nepovinné. Úplný výčet polí najdete v technické dokumentaci: konfigurace a možnosti otevření.

Jak zapadá do Zaslat

Vybrané místo se vrací jako objekt s kódem místa (code) a kódem dopravce (carrierCode), spolu s názvem, adresou a souřadnicemi. Tyto dva údaje předáte při založení zásilky přes API v2: endpoint cart/create je přijímá v parametrech deliveryBranch a carrierCode. Podací místo, kam odesílatel zásilku odnese, se předává stejně v parametru pickupBranch. Popis endpointu je v API Referenci v2.

Verze

Tato stránka popisuje aktuální verzi 2.2. Widget je verzovaný a verze je součástí adresy, ze které se skript načítá:

Code
https://map.zaslat.cz/v2/2/sdk/main.js

Opravy vycházejí na stejné adrese, vaše integrace je tedy dostává bez zásahu do kódu. Nová verze widgetu dostane vlastní adresu, takže integrace zůstává na verzi, na kterou odkazuje, dokud adresu sami nezměníte. Pro novou integraci vždy použijte adresu uvedenou na této stránce.