FOXPOST logó

FOXPOST térképes kereső alkalmazás dokumentáció

FOXPOST 2in1 térképes kereső alkalmazás

A FOXPOST térképes kereső alkalmazása egy weboldalba ágyazható widget, mely lehetővé teszi a felhasználók számára, hogy egyszerűen kiválasszák a számukra megfelelő átvételi pontot a FOXPOST - Packeta Group hálózatából, amely egy oldalon jeleníti meg a térképes és listás nézetet.
Az alkalmazás automatikusan igazodik a képernyő felbontásához (reszponzív).
Használata:
Az alkalmazás jobb oldalán található egy szabadszavas kereső, melyben kereshető az összes elérhető automata lényegi paramétere.
A beágyazáshoz egy iframe kódot kell elhelyezni a weboldal forráskódjában kódot kell elhelyezni a forráskódjában az alábbi az alábbi példa alapján. Az 'Átvevőhely kereső' listában megjelenő automaták a megadott szűrőfeltételek alapján szűkíthetőek.
Szűrőfeltételeket jelölő     ikon:

Szűrőfeltételek:

  1. Kézbesítési pont típusa:
    1. Összes
    2. FOXPOST
    3. Z-BOX
    4. Z-Pont
  2. Nyitvatartás
    1. 0-24 / Non-stop
    2. Szombaton nyitva
    3. Vasárnap nyitva
  3. Elérhető szolgáltatások:
    1. Csomagfeladás és -átvétel
    2. Csak csomagátvétel
  4. Fizetési lehetőségek:
    1. Minden
    2. Fizetés bankkártyával
    3. Fizetés Packeta applikáción keresztül
    4. Fizetés készpénzzel
    5. Fizetés linken keresztül
A szűrőfeltételeknek megfelelően visszakapjuk az elérhető automaták találatszámot. A szűrők közt lehet ugrálni és a bepipált feltételek nem vesznek el.
A "Kiválasztom" gombra kattintva az alkalmazás továbbítja a kiválasztott automata adatait a beágyazó weboldal kódjának, amely azt egy esemény figyelő kód megírásával tudja fogadni további felhasználásra. (példát lásd lentebb).
A "Mutasd a térképen" gombra kattintva az adott automatához navigál a térkép.
A "Csak akciós automaták mutatása" jelölőnégyzetet bejelölve a térképen és a listában csak azok az automaták jelennek meg melyekbe a listaárnál kedvezőbb áron küldhető csomag.
A "Megjelenés" jelölőnégyzetet bejelölve lehetőségünk van asztali, tablet vagy mobil nézetet megjeleníteni.
Az összes automatánál a bal oldalon megjelenített fizetési ikonok egy mouseover-es megoldással működnek, ahol kurzor odavitelére megjelenik a releváns szöveg:
  • készpénz ikon: Fizetés készpénzzel 
  • bankkártya ikon: Fizetés bankkártyával
  • applikáció ikon: Fizetés Packeta applikáción keresztül
  • hiperhivatkozás ikon: Fizetés linken keresztül
Minden automatához a hozzátartozó ikon kerül hozzárendelésre, így az egyes végpontok vizuálisan is könnyen megkülönböztethetők.
Ikonkészlet
FOXPOST
Z-BOX
Z-Pont
Az ikonokat egy telítettségi színjelzés veszi körül, amely információt nyújt a felhasználónak az adott végpont aktuális telítettségéről.
Telítettségi színmagyarázat:
  • Zöld: Az automata nem telített, a csomagfeladás zavartalan, kiszállítási késedelem nincs. 
  • Narancssárga: Az automata közepesen telített, csomagfeladásnál esetenként előfordulhat, hogy nincs szabad fiók, a kiszállításban átlagosan 1-2 napos késés lehetséges. 
  • Piros: Az automata nagyon telített, csomagfeladásnál előfordulhat szabad rekesz hiánya, kiszállításban 2-3 napos késés várható. 
  • Szürke: Jelenleg nem áll rendelkezésre információ az átvevőhely telítettségéről.

FOXPOST térképes kereső beágyazása


Alkalmazás megjelenése
Alkalmazás nyelve
Akciós automaták megjelenítése
Térkép elrejtése
Megjelenés

Az alkalmazásban történő automata keresés után lehetőség van a kiválasztott automata adatainak kinyerésére. A "Kiválasztom" gombra kattintva az alkalmazás továbbítja a beágyazó oldal felé a kiválasztott automata adatait. Ennek az adatnak a feldolgozásához egy javascript nyelven megírt esemény figyelő kód megvalósítása szükséges.

function receiveMessage(event) {
    // if (event.origin !== 'https://cdn.foxpost.hu') {return};
    var apt = JSON.parse(event.data);

    console.log(apt.name, apt.findme);
}

window.addEventListener('message', receiveMessage, false);

Átadásra kerülő adat formátuma


{
  "place_id": 1250198,
  "operator_id": "hu5516",
  "name": "Győrújbarát Gabi Cukrászat",
  "ssapt": "",
  "sdapt": "",
  "address": "9081 Győrújbarát, István utca 67.",
  "zip": "9081",
  "city": "Győrújbarát",
  "street": "István utca 67.",
  "findme": "HU5516 számú kültéri automatánk az épület oldalán, a cukrászda gazdasági bejáratánál található.",
  "geolat": 47.604433,
  "geolng": 17.652372,
  "allowed2": "ALL",
  "depot": "Győr Depo",
  "load": "normal loaded",
  "isOutdoor": true,
  "apmType": "Rollkon",
  "substitutes": [],
  "open": {
    "hetfo": "00:00-24:00",
    "kedd": "00:00-24:00",
    "szerda": "00:00-24:00",
    "csutortok": "00:00-24:00",
    "pentek": "00:00-24:00",
    "szombat": "00:00-24:00",
    "vasarnap": "00:00-24:00"
  },
  "fillEmptyList": [
    {
      "emptying": "11:45:00",
      "filling": "12:45:00"
    }
  ],
  "iconUrl": "https://www.exemaple.hu/logo",
  "country": "hu",
  "cardPayment": true,
  "cashPayment": true,
  "variant": "FOXPOST",
  "paymentOptions": "cash",
  "paymentOptionsString": "Fizetés bankkártyával",
  "service": "pick up",
  "serviceString": "Csak csomagátvétel"
}

            

Példa beágyazás:

Kattints a Kiválasztom gombra a térképes keresőben.