Table of Contents |
---|
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.
Data source
API Points
Nomenclature basics: https://api-{locale}-points.easypack24.net/v1
Instance | Environment | Endpoint |
---|---|---|
PL | Production | https://api-pl-points.easypack24.net/v1 |
UK | Production | https://api-uk-points.easypack24.net/v1 |
IT | Production | https://api-it-local-points.easypack24.net/v1/points |
Responsive Web Design (RWD)
Integration
Basic integration (easypack.mapWdget())
Geowidget v4 can be easily integrated into any system or web page. Client web page should insert script in <head>
tag:
...
xample 2 - https://geowidget.easypack24.net/examples/basic-with-params.html
Parameters
Parameter name | Description | Defaults by instance | |||||||
---|---|---|---|---|---|---|---|---|---|
instance | Override default config by config prepared for instance. Default: Available: | ||||||||
apiEndpoint | URL to API Points which will be connected to Geowidget | pl: https://api-pl-points.easypack24.net/v1 uk: it: | |||||||
defaultLocale | Geowidget language that will be uses in front-end. Available: | pl: pl uk: uk | |||||||
locales | Languages that will be display as list in front layer. They can be dynamically changed. | pl: ['pl'] uk: ['uk'] | |||||||
mobileSize | Screen width below which mobile version is triggered. | 768 | |||||||
langSelection | Determines if language selection bar should be displayed. | false | |||||||
filters | Determines if filters (functions) bar should be displayed. | false | |||||||
addressFormat | Visible format of address | '{street} {building_number} <br> {post_code} {city}' | |||||||
listItemFormat | Visible format of address on list |
| |||||||
display | Enable/disable visible type filters and search bar |
| |||||||
mapType | Setup map type, available to use Open Street Map or Google Maps. Available:
| 'osm' | |||||||
searchType | Setup search type, available to use Open Street Map Nominatim or Google Maps Autocomplete. Available:
| 'osm' | |||||||
map | Setup map details. |
| |||||||
points | Setup points details Available functions:
|
| |||||||
customDetailsCallback | Allows to set custom callback for details action Available: | false | |||||||
customMapAndListInRow | Allow to change layout where list of point is below map. Points on list were paginated, number of point per page can be configured. |
| |||||||
listItemFormat | Allows to change default layout of point information on points list. |
| |||||||
mobileFiltersAsCheckbox | Option set to false make filter option as radio in mobile, option | true | |||||||
paymentFilter | visible:false, #zezwala na wyświetlenie filtra płatnosć w paczkomacie defaultEnabled: false, #włączony filtr dla płatności w paczkomacie już przy inicjalizacji showOnlyWithPayment: false #wymusza pokazywanie obiektów tylko z płatnością w paczkomacie | False |
Getting selected point data
If client wants to get point data that user selected on Geowidget, he can configure callback like this:
...
Example 3 - https://geowidget.easypack24.net/examples/basic-with-collect-only.html
Modal Map (easyPack.modalMap())
It is possible to display Geowidget inside modal and then select point also:
...
Example 4 - https://geowidget.easypack24.net/examples/modal.html
Dropdown Widget (easyPack.dropdownWidget())
It is possible to display Geowidget as dropdown for select point.
...
Example 5 - https://geowidget.easypack24.net/examples/dropdown-widget.html
Enable Google Maps
Defaults settings for display map and search place by address is setup to use Open Street Map.
...
Example 6 - https://geowidget.easypack24.net/examples/google.html
Functions of mapWidget
searchLockerPoint(pointName)
Function for search point by name and show it on map.
...
Example 7 - https://geowidget.easypack24.net/examples/search-locker-point.html
searchPlace(placeName)
Function fo search place by name and show it on map.
...
Example 8 - https://geowidget.easypack24.net/examples/search-place.html
Examples
Display points with different types
Params in init() | |||||||
---|---|---|---|---|---|---|---|
PARCEL_LOCKER_ONLY |
| ||||||
POP |
| ||||||
PARCEL_LOCKER |
| ||||||
PARCEL_LOCKER_SUPERPOP |
| ||||||
PARCEL LOCKER + POP |
| ||||||
PARCEL LOCKER + POP |
| ||||||
PARCEL LOCKER + POP |
|
Demo live links
Example 1 - https://geowidget.easypack24.net/examples/basic.html - Basic integration
...