Note: Dear user the section "New Integration of Geowidget" shows the new way to integrate the Geowidget map, if you are looking for information about the previous possibilities to integrate Geowidget V4, go to the section "OLD version Integration of Geowidget"

New Integration of Geowidget

To use Geowidget v4, add the following lines to your page headers.

script async src="https://geowidget.easypack24.net/js/sdk-for-javascript.js"></script>
<link rel="stylesheet" href="https://geowidget.easypack24.net/css/easypack.css"/>

To initialize the map using the defined contexts, specify values for instance, context, and token in the parameters. Point selection is implemented as an event callback to the mapWidget function (example below).

<script type="text/javascript">           
    easyPack.init({
        instance: 'pl',
        context: "context name",
        token: "a token generated in the Parcel Locker Manager for API Points"
    });
    var map = easyPack.mapWidget('easypack-map', function(point) {
        console.log(point);
    });               
/script>
  
<div id="easypack-map"></div>

Parameter Description:

Configuration options:

Example: https://geowidget.easypack24.net/examples/multi-maps-contexts.html

...

OLD Version integration of Geowidget

Basic info

GEOv4 (also known as Geowidget v4) is a point locator and picker designed by Integer sp. z o.o. It's main goal is to show map of points with several types (for example machines), provide informations about this points and give possibility to integrate with clients external systems. GEOv4 is a widget-type software, it means that whole code and processing is held on Integer servers, external clients only attach link to this code and specify configuration that will be used on theirs systems.

...

instance

apiEndpoint

pl: https://api-pl-points.easypack24.net/v1

uk: https://api-uk-points.easypack24.net/v1

it: https://api-it-points.easypack24.net/v1

defaultLocale

pl: pl

uk: uk

locales

pl: ['pl']

uk: ['uk'] 

mobileSize

768

langSelection

false

filters

false

addressFormat

'{street} {building_number} <br> {post_code} {city}'

listItemFormat

[
	"<b>{name}</b>",
	"{address_details.street} {address_details.building_number}"
]

display

{
	showTypesFilters: true,
	showSearchBar: true,
}

mapType

'osm'

searchType

'osm'

map

{
	googleKey: '', // required to use Google Maps API
	useGeolocation: true,
	initialZoom: 13,
	detailsMinZoom: 15, // minimum zoom after marker click
	autocompleteZoom: 14,
	visiblePointsMinZoom: 13,
	defaultLocation: [52.229807, 21.011595],
    initialTypes: ['pop', 'parcel_locker'], // which type should be selected by default. Options: parcel_locker_only, parcel_locker, pop
}

points

{
	types: ['pop', 'parcel_locker'],  # Options: parcel_locker_only, parcel_locker, pop     
    allowedToolTips: ['pok', 'pop'],
    functions: []
}

customDetailsCallback

false

customMapAndListInRow

{
	enabled: false,
	itemsPerPage: 8
}

listItemFormat

[
	"<b>{name}</b>",
	"<strong>{address_details.street}</strong> {address_details.building_number}"
]

mobileFiltersAsCheckbox

true

Getting selected point data

...

Example 4 - https://geowidget.easypack24.net/examples/modal.html - Open map as modal

Example 5 - https://geowidget.easypack24.net/examples/dropdown-widget.html - Open as dropdownExample 6 - https://geowidget.easypack24.net/examples/google.html - Enable Google Maps

Example 7 6 - https://geowidget.easypack24.net/examples/search-locker-point.html - Function searchLockerPoint()

Example 8 7 - https://geowidget.easypack24.net/examples/search-place.html - Function searchPlace()

Example 9 8 - https://geowidget.easypack24.net/examples/multi-maps.html - Open multi maps with different initial parameters

Example 10 9 - https://geowidget.easypack24.net/examples/payment-filter.html - Basic integration with payment filter

...