Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Geowidget v5 to lokalizator i selektor punktów zaprojektowany przez InPost.

Jego główne zadania to:

  •  Wyświetlanie mapy z punktami o różnych typach (np. paczkomaty, paczkopunkty)

  •  Dostarczenie informacji o tych punktach i umożliwienie integracji z zewnętrznymi systemami Klientów

Jest to oprogramowanie typu widget. Oznacza to, że cały kod i przetwarzanie odbywa się na serwerach InPost. Klienci zewnętrzni dołączają tylko link do tego kodu i określają konfigurację, która będzie używana w ich systemach.


Na tej stronie

Table of Contents
Note

Szanowni Państwo, jeżeli mają Państwo problemy z prawidłowym działaniem geowidgetu, prosimy o zgłaszanie problemów za pomocą formularza na stronie https://inpost.pl/formularz-wsparcie wybierając kategorię „Problem z dostępnością systemu”.

Środowisko Produkcyjne


Adres środowiska produkcyjnego: https://geowidget.inpost.pl

Generowanie dostępu

  1. Wejdź na stronę Managera Paczek https://manager.paczkomaty.pl

  2. W oknie logowania wpisz swój login i kliknij: Zaloguj

  3. Po zalogowaniu na konto przejdź do zakładki Moje Konto

  4. W zakładce Dane sprawdzić, czy wszystkie dane firmy są prawidłowo uzupełnione

Info

Pamiętaj, aby możliwe było wygenerowanie dostępu do API uzupełnione muszą być zarówno dane adresowe firmy, jak i dane do faktury.

5. Po weryfikacji przejdź do nowej zakładki API

6. Aby wygenerować nowy dostęp do Geowidget, rozwiń zakładkę Geowidget i kliknij Generuj


Środowisko Testowe

Adres środowiska testowego: https://sandbox-easy-geowidget-sdk.easypack24.net

Generowanie dostępu

  1. Wejdź na stronę Managera Paczek https://sandbox-manager.paczkomaty.pl

  2. W oknie logowania wpisz swój login i kliknij: Zaloguj

  3. Po zalogowaniu na konto przejdź do zakładki Moje Konto

  4. W zakładce Dane sprawdzić, czy wszystkie dane firmy są prawidłowo uzupełnione

Info

Pamiętaj, aby możliwe było wygenerowanie dostępu do API uzupełnione muszą być zarówno dane adresowe firmy, jak i dane do faktury.

5. Po weryfikacji przejdź do nowej zakładki API

6. Aby wygenerować nowy dostęp do Geowidget, rozwiń zakładkę Geowidget i kliknij Generuj


Integracja

Geowidget v5 można łatwo zaimplementować w dowolnym systemem lub stroną internetową przy użyciu poniższego kodu.

Code Block
languagehtml
<link rel="stylesheet" href="https://geowidget.inpost.pl/inpost-geowidget.css"/>
<script src='https://geowidget.inpost.pl/inpost-geowidget.js' defer></script>
<script> function afterPointSelected(point) { alert('Selected point: ' + point.name); } </script>


Aby nasłuchiwać na wybrany punkt, można też utworzyć listenera na nazwę eventu przekazaną przez atrybut onpoint, przykład:

Code Block
languagehtml
<link rel="stylesheet" href="https://geowidget.inpost.pl/inpost-geowidget.css"/>
<script src='https://geowidget.inpost.pl/inpost-geowidget.js' defer></script>
<script>
    document.addEventListener('onpointselect', (event) => alert(event.details.name));
</script>
 
<inpost-geowidget onpoint="onpointselect" token='token-for-geo' language='pl' config='parcelcollect'></inpost-geowidget>


W miejscu gdzie ma być osadzona mapa należy dodać następujący kod:

Code Block
languagehtml
<inpost-geowidget onpoint="afterPointSelected" token='token-for-geo' language='pl' config='parcelcollect'></inpost-geowidget>


Opis poszczególnych parametrów:

Parametr

Opis

onpoint

Parametr przyjmuje funkcje/nazwę jaka ma zostać wykonana po wybraniu punktu na mapie.

token

Parametr do którego należy przekazać PUBLICZNY token wygenerowany w aplikacji manager paczek:

language

Parametr pozwalający określić domyślny język widgetu - opcjonalny.
Dostępne opcje:

language='pl'

language='en'

Jeśli użytkownik już skorzystał z nowej wersji geowidget - interfejs zostanie wyświetlony w języku, którego używał poprzednio.

config

Parametr określający jakie funkcje/rodzaje mają posiadać punkty wyświetlone na mapie.


Opcje konfiguracyjne:

Opis

Opcja

functions

payment_available

location_247

Prezentowanie punktów odbioru dla zamówień opłaconych z góry

config='parcelCollect'

parcel_collect

(error)

(error)

Prezentowanie punktów odbioru dla zamówień pobraniowych

config='parcelCollectPayment'

parcel_collect

(tick)

(error)

Prezentowanie punktów odbioru dla zamówień Paczka w Weekend

config='parcelCollect247'

parcel_collect

(error)

(tick)

Prezentowanie punktów nadań

config='parcelSend'

parcel_send

(error)

(error)