Data Accessor Functions

These functions are exposed via globalThis.MaptaskrControlManager.getControl(controlId) and let you search, navigate, manage layers & sublayers, work with shapes, retrieve map state, highlight data, and manage selected features.

Usage Pattern

const control = globalThis.MaptaskrControlManager.getControl(controlId);

Each function below assumes you already have a control reference as shown.

The table below lists the currently supported functions grouped by category (sourced from the individual pages in this folder). Anything not listed here is deprecated, internal, or not yet documented.

Category	Function	Signature	Returns	Description
Navigation	navigateToLatLong	(latitude: number, longitude: number, zoom: number)	`void`	Pan & zoom to a coordinate
Navigation	navigateToExtent	(minLat: number, minLon: number, maxLat: number, maxLon: number)	`void`	Fit map to extent
Navigation	navigateToAddress	(item: SearchResult)	`Promise<void>`	Center on an address result
Navigation	navigateToRegion	(item: SearchResult)	`Promise<void>`	Center on a region result
Navigation	navigateToFeature	(item: SearchResult)	`Promise<void>`	Center on a feature result
Searching	parseLocation	(possibleCoordinate: string)	`SearchResult \| undefined`	Parse free‑text lat/long
Searching	searchAddressesByLocation	(lat: number, lon: number)	`Promise<SearchResult[]>`	Reverse geocode nearby addresses
Searching	searchAddresses	(searchTerm: string)	`Promise<SearchResult[]>`	Search addresses
Searching	searchRegions	(searchTerm: string)	`Promise<SearchResult[]>`	Search regions
Searching	searchFeatures	(searchTerm: string)	`Promise<SearchResult[]>`	Search features
Searching	searchLayers	(searchTerm: string)	`Promise<SearchResult[]>`	Search layers (metadata)
Searching	setRecordAddress	(item: SearchResult)	`void`	Apply address to current record
Layer Management	getGalleryLayers	()	`Promise<CustomAvailableLayer[]>`	List available gallery layers
Sublayers	getSublayerAttributes	(sublayerId: string)	`Promise<SublayerAttributes>`	Attribute metadata for a sublayer
Layers	createSublayerInstance	(sublayerId: string)	`Promise<string>`	Enable sublayer (returns instanceId)
Layers	createSublayerInstanceWithFilter	(sublayerId: string, filter: Filter)	`Promise<string \| void>`	Enable sublayer with initial filter
Layers	getEnabledSublayerInstances	()	`Promise<ILayerInstance[]>`	All enabled sublayer instances
Layers	showSublayerInstance	(subLayerInstanceId: string)	`Promise<void>`	Make instance visible
Layers	hideSublayerInstance	(subLayerInstanceId: string)	`void`	Hide instance
Layers	removeSublayerInstance	(subLayerInstanceId: string)	`void`	Remove instance (disable)
Layers	navigateToSublayerInstance	(subLayerInstanceId: string)	`void`	Zoom to instance extent
Layers	filterSublayerInstance	(subLayerInstanceId: string, filter: Filter)	`void`	Apply / replace filter
Layers	clearFilterFromSublayerInstance	(subLayerInstanceId: string)	`void`	Clear filter
Layers	updateSublayerInstanceOpacity	(subLayerInstanceId: string, opacity: number)	`Promise<void>`	Change opacity
Layers	getVisibleSublayerInstanceData	(subLayerInstanceId: string, pageNumber: number, pageToken?: string)	`Promise<FeaturesResponse>`	Paged visible data
Layers	getAllSublayerInstanceData	(subLayerInstanceId: string, pageNumber: number, pageToken?: string)	`Promise<FeaturesResponse>`	Paged full data
Layers	showVisibleDataTabForSublayerInstance	(subLayerInstanceId: string)	`void`	Show data tab (visible extent)
Layers	showAllDataTabForSublayerInstance	(subLayerInstanceId: string)	`void`	Show data tab (all data)
Layers	hideDataTabForSublayerInstance	(subLayerInstanceId: string)	`void`	Hide single data tab
Layers	hideAllDataTabs	()	`void`	Hide all data tabs
Shapes	getShapes	(id?: string)	`MaptaskrShape[]`	Get shapes (optional scope id)
Shapes	addOrUpdateShape	(customShape: CustomShape)	`Promise<MaptaskrShape[]>`	Create or update shape
Shapes	deleteShape	(shape: MaptaskrShape)	`Promise<void>`	Delete a shape
Map State	downloadMap	()	`void`	Download current view
Map State	getMapCenter	()	`MaptaskrCoordinate`	Current map center
Map State	getMapExtent	()	`Extent`	Current extent
User Highlights	addUserHighlight	(geoJsonObject: FeatureCollection)	`void`	Add / replace highlight overlay
User Highlights	clearUserHighlight	()	`void`	Remove highlight overlay
Selected Features	getSelectedFeatures	()	`SelectedFeature[]`	Current selected features
Selected Features	setSelectedFeatures	(features: SelectedFeature[] \| null \| undefined)	`void`	Replace / clear selected features
Map Filtering	setMapFilter	(filter: MapGeometryFilter)	`Promise<void>`	Create / replace map filter
Map Filtering	disableMapFilter	()	`void`	Temporarily disable active filter
Map Filtering	enableMapFilter	()	`void`	Re-enable previously disabled filter
Map Filtering	clearMapFilter	()	`void`	Remove active filter definition

Usage Pattern​

Usage Pattern