Constructor

# new Map(opts)

Generate object with options. You must provide at least one of the following parameters: token, apiKey, geoKey, or impersonationKey.

Parameters:

Name	Type	Attributes	Default	Description
`opts`	object			Map core options.
`target`	string			Div name where interactive map will reside
`token`	number	<optional>		The authentication token, required if no other authentication method is provided.
`apiKey`	number	<optional>		The authentication api key, required if no other authentication method is provided.
`geoKey`	number	<optional>		The authentication geo key, required if no other authentication method is provided.
`impersonationKey`	number	<optional>		The authentication impersonation key, required if no other authentication method is provided.
`mapId`	target	<optional>		Map Id. IMPORTANT. If no ID is informed, the used map will be the first map assigned to the user ordered alphabetically.
`center`	Array.<number>	<optional>		The initial center for the view.
`zoom`	number	<optional>		Zoom level for the view.
`maxZoom`	number	<optional>		The maximum zoom level used to determine the resolution constraint.
`minZoom`	number	<optional>		The minimum zoom level used to determine the resolution constraint.
`mode`	string	<optional>	"2D"	Initial mode in which the map will be initialized
`image`	string	<optional>		Initial image in which the map will be initialized, necessary 3D mode
`orientation`	string	<optional>	"N"	Initial orientation in which the map will be initialized
`initialConfig`	Map~InitOpts	<optional>	{overlays:null,imageryLayers:null,center:true,zoom:true,callback:null}	Object to establish which map config it´s applied.
`restrictedExtent`	Extent	<optional>		The extent that the map will be restricted to.

Tutorials:

Fires:

Example

Create basic map. Always need at least a target container and token

const map = new Vexcel.Map({
      target: "map",
      token: API_KEY,
      });

Classes

Map

Methods

# changeMap(mapId)

Change map.

Parameters:

Name	Type	Description
`mapId`	number	Map Id. IMPORTANT. If no ID is informed, the used map will be the first instance assigned to the user ordered alphabetically.

Returns:

CoreMap

# getCollectionManager() → {CollectionManager}

Get collection manager

Returns:

Type: CollectionManager

# getImageryLayer() → {ImageryLayer}

Get imagery layer object that manage the imagery data

Returns:

Type: ImageryLayer

# getMapStatusView() → {MapStatusView}

Get map status view that allow to visualize the status of the map

Returns:

Type: MapStatusView

Type Definitions

# InitOpts

Properties:

Name	Type	Attributes	Default	Description
`overlays`	Map~VisibilityConfig	<optional>	null	Overlays visibility config at start.
`imageryLayers`	Map~VisibilityConfig	<optional>	null	ImageryLayers visibility config at start. Value from VexcelLayers
`center`	boolean	<optional>	true	Use center defined in instance config. Use over map config.
`zoom`	boolean	<optional>	true	Use zoom defined in instance config. Use over map config.
`callback`	function	<optional>		Callback called when the map finish the initialization.

# VisibilityConfig

Properties:

Name	Type	Attributes	Default	Description
`visible`	Array.<string>	<optional>	null	Names visible at start.
`disabled`	Array.<string>	<optional>	null	Names invisible at start.

Events

Type: object

# CENTER_DATE_IMAGE

Event triggered when center image change

Type: object

# CHANGE_MEASURE

Event triggered after creating or editing a new measurement with the measurement tools

Parameters:

Name	Type	Description
`event`	object	Internal event

Properties:

Name	Type	Description
`measure`	Measure	Measure object

Type: object

# CLICK

Event Triggered when user single clicks on the map. This event is not triggered if drawing tools are enabled or if the user clicks on a feature on the map.

Properties:

Name	Type	Description
`location`	Location	Location of the coordinates for this event
`drawing`	boolean	Return if any of drawing/measurement tools are enabled

# COMPLETE_COLLECTIONS

Event triggered when map loads all collections

Type: object

# FEATURES_CLICK

Event Triggered when user clicks on a space on the map occupied by multiple features. Only fired if there is more than one feature

Properties:

Name	Type	Description
`location`	Location	Location for point clicked
`features`	Array.<Feature>	List of features when you click

Example

Listener in map to listen on features click

core.addListener(Vexcel.Events.MapEvents.FEATURES_CLICK, (e) => {
        e.features.map(feat => console.log(JSON.stringify(feat)));
    });
  }
});

Type: object

# FIND_IMAGES_LOADED

Event triggered after map loads images for the center of the map in the viewport

Properties:

Name	Type	Description
`images`	Array.<object>	List of images loaded for the center of the map
`point`	Array.<number>	Point of the center of the image
`epsg`	string	Epsg code for point coordinates

Type: object

# FINISH_MEASURE

Event triggered after finish a new measurement with the measurement tools

Parameters:

Name	Type	Description
`event`	object	Internal event

Properties:

Name	Type	Description
`measure`	Measure	Measure object

Type: object

# MAP_INITIALIZE

Event triggered after map is initialized and layers are loaded

Properties:

Name	Type	Description
`map`	Map	Map object
`status`	MapStatus~status	Object with the status of the map

Type: object

# MAP_STATUS_EVENT

Dispatches a map status update event.

Parameters:

Name	Type	Description
`status`	MapStatus	The updated map status.

Fires:

event:MapStatusEvent

Type: object

# MOVE_END

Event Triggered after the map is moved.

Type: object

# NO_3D_IMAGES

Event triggered when no images to 3D mode

Type: object

# POINTER_MOVE

Event triggered when a pointer is moved. Note that on touch devices this is triggered when the map is panned, so it is not the same as moving the mouse.

Properties:

Name	Type	Description
`location`	Location	Location for point

Type: object

# START_MEASURE

Event triggered after start a new measurement with the measurement tools

Parameters:

Name	Type	Description
`event`	object	Internal event

Properties:

Name	Type	Description
`measure`	Measure	Measure object

# TILES_END_LOAD

Event triggered when the map finishes loading the tiles

# TILES_START_LOAD

Event triggered when the map starts loading the tiles