Interface IvionInterface

interface IvionInterface {
    getLanguage(): string;
    getMainView(): MainViewInterface;
    getMapView(): MapViewInterface;
    getMenuItems(): SidebarMenuItemInterface[];
    getPoiRepository(): PoiRepositoryInterface;
    getPoiTypeRepository(): PoiTypeRepositoryInterface;
    getShareUrl(): string;
    isLicensed(): boolean;
    isMoving(): boolean;
    moveToDataset(datasetId: number, imageFileId?: number, viewDir?: ViewOrientationInterface): Promise<void>;
    moveToGeoLocation(loc: Vector3, isLocal: boolean, viewDir: ViewOrientationInterface, fixedLat: number, fov: number, normal: Vector3, forceLoc: boolean, sameFloor?: boolean): Promise<void>;
    moveToImage(image: ImageInterface, viewDir?: ViewOrientationInterface, viewDistance?: number, fov?: number): Promise<void>;
    moveToImageId(imageId: number, viewDir: ViewOrientationInterface, fov: number): Promise<void>;
    moveToPoi(poi: PoiInterface, hideDetails: boolean, viewDir: ViewOrientationInterface, fov: number): Promise<void>;
    moveToPoiId(poiId: number, hideDetails: boolean, viewDir: ViewOrientationInterface, fov: number): Promise<void>;
    moveToSiteModelEntity(entity: SiteModelEntityInterface, showDetails: boolean, viewDir?: ViewOrientationInterface): Promise<void>;
    moveToSiteModelEntityId(entityId: number, showDetails: boolean, viewDir?: ViewOrientationInterface): Promise<void>;
    moveToStartingLoc(): Promise<void>;
    reinit(): Promise<void>;
    resetView(): void;
    setLanguage(key: string): void;
    setPoiTypesVisibility(visible: boolean, types?: number[]): void;
}

Methods

  • Get language (example: returns en for English).

    Returns string

    Language key. See setLanguage for the list of supported languages.

  • Menu items organized in a tree structure with an array on the root level.

    Supported actions that can be performed on the retrieved items structure:

    • Adding new items in any place of the tree
    • Updating existing items
    • Deleting existing items

    Returns SidebarMenuItemInterface[]

    Menu items

  • Get share URL containing information about current image, longitude and latitude.

    Returns string

    Share URL.

  • Checks whether the instance key includes the module for the frontend API.

    Returns boolean

    Whether frontend API is included in the license

  • Return whether the view is currently being moved to another location, e.g., because moveToImage() had been called earlier.

    Returns boolean

    Movement active.

  • Moves user to a specified dataset. If image file ID is given, move is done to that image in dataset.

    Parameters

    • datasetId: number

      Dataset's ID.

    • OptionalimageFileId: number

      ID of image file. If not given or not found, first image from dataset is used.

    • OptionalviewDir: ViewOrientationInterface

    Returns Promise<void>

    Promise that is resolved when the moving transition is completely finished.

  • Move to specified geographic location by locating the closest image floor location and moving the view there. Images without geo-registration (i.e. where location is null) are ignored. If no image is found nearby but the location is still contained in a dataset, the view will be moved to the exact location and the point cloud will be activated.

    Parameters

    • loc: Vector3

      Geographic location in WGS-84 or local

    • isLocal: boolean

      If false, coordinate is transformed from WGS-84 to local

    • viewDir: ViewOrientationInterface

      View orientation. If undefined, camera is oriented to view the location.

    • fixedLat: number

      If is not undefined then this value will override the viewing direction's latitude value.

    • fov: number

      Field of view as number. If undefined, the FOV is left unchanged.

    • normal: Vector3

      Normal vector of the destination. Used to determine if destination is floor/wall/ceiling.

    • forceLoc: boolean

      Flag to force movement to specified location even if an image is found nearby.

    • OptionalsameFloor: boolean

      If true, only images of the current floor are considered as destination.

    Returns Promise<void>

    Promise that is resolved when the moving transition is completely finished.

    If viewDir is undefined, the viewing direction is determined automatically.

  • Moves user to an image's location.

    Parameters

    • image: ImageInterface

      Image object.

    • OptionalviewDir: ViewOrientationInterface

      View orientation. If undefined, current view direction is left unchanged.

    • OptionalviewDistance: number

      Radius parameter. Image meshes are scaled to this radius before animation starts.

    • Optionalfov: number

      Field of view as float. If undefined, the FOV is left unchanged.

    Returns Promise<void>

    Promise that is resolved when the moving transition is completely finished.

    If viewDistance is not specified, a server-side raycast query for the center of the screen is performed in order to find the scene depth (assuming the user is focusing on the screen center).

  • Moves user to an image's location, uses numerical ID of the image object.

    Parameters

    • imageId: number

      Image's ID. If not provided or undefined, defaults to first image.

    • viewDir: ViewOrientationInterface

      View orientation. If undefined, current view direction is left unchanged.

    • fov: number

      Field of view as float. If undefined, the FOV is left unchanged.

    Returns Promise<void>

    Promise that is resolved when the moving transition is completely finished.

  • Moves user to a location closest to the POI and sets the viewing direction such that the user is looking at the POI.

    Parameters

    • poi: PoiInterface

      The POI object.

    • hideDetails: boolean

      By default NavVis IVION auto opens POI details panel, If true then that action is prevented.

    • viewDir: ViewOrientationInterface

      View orientation. If undefined, the default direction is used.

    • fov: number

      Field of view as float. If undefined, the FOV is left unchanged.

    Returns Promise<void>

    Promise that is resolved when the moving transition is completely finished.

  • Similar to moveToPoi, uses numerical ID of POI.

    Parameters

    • poiId: number

      The POI's ID.

    • hideDetails: boolean

      By default NavVis IVION auto opens POI details panel, If true then that action is prevented.

    • viewDir: ViewOrientationInterface

      View orientation. If undefined, the default direction is used.

    • fov: number

      Field of view as float. If undefined, the FOV is left unchanged.

    Returns Promise<void>

    Promise that is resolved when the moving transition is completely finished.

  • Moves user to the center of a specified site model entity.

    Parameters

    Returns Promise<void>

    Promise that is resolved when the moving transition is completely finished.

  • Moves user to the center of a specified site model entity.

    Parameters

    • entityId: number

      ID of the entity to move to.

    • showDetails: boolean

      Whether to open the details panel or not.

    • OptionalviewDir: ViewOrientationInterface

      View orientation. If undefined, the direction is not changed.

    Returns Promise<void>

    Promise that is resolved when the moving transition is completely finished.

  • Move to configured starting location.

    Returns Promise<void>

    Promise that is resolved when the moving transition is completely finished.

  • Reinitialize NavVis IVION instance and re-fetch all data from database.

    Returns Promise<void>

    Promise that is resolved when the NavVis IVION instance has reinitialized. The promise will not be rejected.

  • Moves the camera/user back to the center of the last visited image's sphere.

    Returns void

  • Set language (example: en for English).

    Parameters

    • key: string

      Language key. Supported language keys are:

      • cs: Czech
      • en: English
      • es: Spanish
      • de: German
      • ja: Japanese
      • zh: Simplified Chinese
      • zh_tw: Traditional Chinese

    Returns void

  • Set visibility for all or only given POI types.

    Parameters

    • visible: boolean

      true to show and false to hide POI types. If parameter is not correct boolean type, function has no effect

    • Optionaltypes: number[]

      Array with POI type IDs to set visibility. If not given, all POI types are set

    Returns void