Widget reference

Map widget: volledige instelling reference

Map widgets tonen geolocaties met statuskleurregels, marker-iconen, info window velden, viewport gedrag en geavanceerde map options.

Veldmapping Viewport Markers en status Advanced options

1. Kernvelden en defaults

Map widget settings — Map widget editor met locatievelden, markerregels en map gedrag.

Defaults

defaultMarkerColor=#3367d6, showLegend=true, autoFit=true.
fitPadding=32, mapTypeId=roadmap, height=320px.
infoWindowEnabled=true, markerLimit=50.

Key	Type	Beschrijving
`filter`	object	Widget filter JSON.
`latField`, `lngField`	string	Bronvelden met coordinaten.
`titleField`, `subtitleField`, `descriptionField`	string	Tekstvelden in marker/info popup.
`statusField`	string	Statusbron voor kleurmapping.
`infoFields`	string[]	Extra velden in info window.
`trackByField`	string	Stabiele marker-identiteit over refreshes.

2. Kaartgedrag en viewport

Instelling	Beschrijving
`showLegend`	Toont statuslegend bij statuskleurregels.
`autoFit`	Auto zoom/center op marker-bounds.
`defaultZoom`	Fallback startzoom.
`maxAutoZoom`	Bovengrens voor auto-fit zoom.
`fitPadding`	Padding rondom marker-bounds in pixels.
`defaultCenter.lat/lng`	Fallback center als auto-fit niet mogelijk is.
`mapTypeId`	`roadmap`, `satellite`, `hybrid`, `terrain`.
`height`	CSS hoogte van de kaartcontainer.
`markerLimit`	Maximaal aantal markers dat gerenderd wordt.

3. Marker en statusconfiguratie

Status rules

statusColors is een map van statuswaarde naar kleur.
statusPriority bepaalt sorteer-/weergaveprioriteit.
defaultMarkerColor wordt gebruikt bij missende statusmatch.
colorByComparisonSet laat kleuren door compare-set context sturen.

Marker iconen

markerIconField gebruikt datawaarde als icon bron.
markerIconClass is statische fallback icon class.
infoWindow aan/uit bepaalt popup-rendering.
apiKey kan widget-specifieke map key overriden.

4. Geavanceerde opties

Key	Type	Notities
`libraries`	string[]	Komma-lijst in editor, als array opgeslagen.
`mapOptions`	object	Advanced map opties JSON; moet object zijn.
`apiKey`	string	Alleen invullen wanneer override nodig is.

Validatie

defaultCenter wordt alleen opgeslagen als zowel lat als lng numeriek zijn.
Ongeldige JSON in advanced options blokkeert save.
Statusregels zonder key/kleur worden genegeerd.

5. Voorbeeld map options JSON

{
  "latField": "latitude",
  "lngField": "longitude",
  "titleField": "store_name",
  "statusField": "store_status",
  "statusColors": {
    "open": "#22c55e",
    "maintenance": "#f59e0b",
    "closed": "#ef4444"
  },
  "defaultMarkerColor": "#3367d6",
  "autoFit": true,
  "maxAutoZoom": 13,
  "mapTypeId": "roadmap",
  "height": "360px",
  "infoFields": ["city", "region", "manager"],
  "markerIconClass": "pi pi-map-marker",
  "markerLimit": 200
}