A base class for anything requiring access to the InstanceApi and instance of Vue app controlled by it.

APIScope

Hierarchy (view full)

Constructors

Properties

The instance of RampMap API scoped to a single Vue R4MP application.

APIScope

created: boolean = false

Indicates if the map has been created

esriView: undefined | MapView

The internal esri map view. Changes from outside of RAMP may break the instance. Use caution.

labelsDefault: RampLabelsConfig = ...

Any map labels defaulting

overviewGraphicLayer: GraphicLayer
overviewmapStore: any

Accessors

  • get $element(): App<Element>
  • Returns App<Element>

  • get $vApp(): ComponentPublicInstance
  • The instance of Vue R4MP application controlled by this InstanceAPI. This is just a shorthand for this.$iApi.$vApp.

    Returns ComponentPublicInstance

    APIScope

  • get viewPromise(): Promise<void>
  • A promise that resolves when the map view has been created

    Returns Promise<void>

Methods

  • Protected

    Applies the given basemap (or basemap with given id) to the esri map Throws error if basemap could not be found with the given id

    Parameters

    • basemap: string | Basemap

      the basemap id or object

    Returns void

  • Will generate the actual Map control objects and construct it on the page

    Parameters

    • config: RampMapConfig

      the config for the map

    • targetDiv: string | HTMLDivElement

      the div to be used for the map view

    Returns void

  • Protected

    Will generate a ESRI map view and add it to the page Must provide the basemap or basemap id to be used when creating the map view

    Parameters

    • basemap: string | Basemap

      the id of the basemap that should be used when creating the map view

    Returns void

  • Checks if mouse event intersects with extent graphic

    Parameters

    • e: MouseEvent | MapViewScreenPoint

    Returns Promise<boolean>

  • Will attempt to change to another basemap if the very first basemap failed. If nothing is defined, will do nothing but manage our watching state.

    This method is overidden as needed

    Parameters

    • basemapSchemaId: string

      the basemap schema id (where the fallback is defined)

    Returns void

  • Sets the overview map's basemap to the basemap with the given id. Will refresh the map view if set basemap uses different tile schema.

    Should only be called by the overview map component

    Parameters

    • basemapId: string

      the basemap id

    Returns boolean

    indicates if the schema has changed

  • Set's the map's pointZoomScale value to newScale. If newScale is not a positive number, a console error is thrown.

    The returned boolean indicates if the value has been successfully set.

    Parameters

    • newScale: number

      the new pointZoomScale value, which must be a positive number

    Returns boolean

    indicates if the value was set successfully

  • Updates overviewmap extent and graphic based on main map extent

    Parameters

    • newExtent: Extent

      new main map extent

    Returns Promise<void>

    A promise that resolves when the overviewmap has finished updating

  • Zooms the map to a given geometry.

    Parameters

    • geom: BaseGeometry

      A RAMP API geometry to zoom the map to

    • Optionalscale: number

      An optional scale value of the map. Is ignored for non-Point geometries

    • Optionalanimate: boolean = true

      Option to turn off the zoom animation. On by default

    • Optionalduration: number = 200

      Option to change animation duration (in milliseconds). Default of 200. Ignored if animate is off.

    • Optionaleasing: ZoomEasing = 'ease'

      Option to change animation easing function. Default of 'ease'. Ignored if animate is off.

    Returns Promise<void>

    A promise that resolves when the map has finished zooming