Api (Class)

Namespace: Wrld

Fields

Name Type Description
Instance Api Single static instance of the Api class. Is used to access other APIs and methods.

Methods

void Create (String apikey, CoordinateSystem coordinateSystem, Transform parentTransformForStreamedObjects, ConfigParams configParams)

Initializes the API instance. This starts up the streaming system. Preferably, this should be called from within Awake() and before accessing the Api.Instance. Any subsequent calls to Api.Create will throw an exception.

Argument Type Description
apikey String Your WRLD API key
coordinateSystem CoordinateSystem The world space map behaviour. Cannot be changed once map is loaded.
parentTransformForStreamedObjects Transform Parent object to attach streamed objects to.
configParams ConfigParams Configuration data needed by the map when loading.

void StreamResourcesForCamera (Camera camera)

Calculates the ECEF origin point from the camera, builds up a frustum and updates these values in the native plugin which then uses this data to make streaming requests. This should be called once per frame in the Update() method.

Argument Type Description
camera Camera A Unity camera that can provide the frustum for streaming.

void StreamResourcesForBuiltInCamera (Camera camera)

Argument Type Description
camera Camera  

void Update ()

Updates Wrld map resources. Should be called once per frame in Unity Mono Update().

void Destroy ()

Uninitializes the API instance. This frees up any resources allocated by the plugins including all streamed meshes in the scene. Preferably, this should be called from within the OnApplicationQuit() method.

void SetOriginPoint (LatLongAltitude lla)

This function has different behaviour depending on the coordinate system in use. UnityWorld - Resets the root latitude and longitude of the map so that the local space origin (0,0,0) of the map’s game object is centered at that point. ECEF - Sets the maps world position to that latitude and longitude so that the camera is positioned at that point.

Argument Type Description
lla LatLongAltitude the latitude, longitude and altitude of the new point.

void OnApplicationPaused ()

void OnApplicationResumed ()

void UpdateCollisions (bool terrain, bool road, bool buildings)

Allows you to enable or disable the generation of collision meshes for terrain, road and buildings when they stream in. This does not enable or disable collision meshes for terrain, road and buildings which have already streamed in.

Argument Type Description
terrain bool Whether to enable or disable the generation of collision meshes for terrain.
road bool Whether to enable or disable the generation of collision meshes for road.
buildings bool Whether to enable or disable the generation of collision meshes for buildings.

Properties

CameraApi CameraApi

Allows accessing the camera API endpoints to interact with the map.

CameraApi CameraApi { get; private set; } 

BuildingsApi BuildingsApi

Allows accessing the buildings API endpoints to interact with buildings on the map.

BuildingsApi BuildingsApi { get; private set; } 

IndoorMapsApi IndoorMapsApi

Allows access of the indoor map API endpoints to interact with indoor maps.

IndoorMapsApi IndoorMapsApi { get; private set; } 

IndoorMapEntityInformationApi IndoorMapEntityInformationApi

Obtain information about features on indoor maps.

IndoorMapEntityInformationApi IndoorMapEntityInformationApi { get; private set; } 

GeographicApi GeographicApi

Allows accessing the geographic API endpoints to position objects on the map.

GeographicApi GeographicApi { get; private set; } 

SpacesApi SpacesApi

Allows accessing the SpacesAPI endpoints

SpacesApi SpacesApi { get; private set; } 

PositionerApi PositionerApi

Allows accessing the PositionerAPI endpoints

PositionerApi PositionerApi { get; private set; } 

EnvironmentFlatteningApi EnvironmentFlatteningApi

Allows access to the Environment flattening apis

EnvironmentFlatteningApi EnvironmentFlatteningApi { get; private set; } 

PathApi PathApi

Get accessor for the path API

PathApi PathApi { get; private set; } 

PrecacheApi PrecacheApi

Get accessor for the data precaching API

PrecacheApi PrecacheApi { get; private set; } 

PropsApi PropsApi

Get accessor for the props API

PropsApi PropsApi { get; private set; } 

TransportApi TransportApi

Get accessor for the transport network API

TransportApi TransportApi { get; private set; } 

Events

Action OnInitialStreamingComplete

This event is raised when the initial map scene has completed streaming all resources.

v0.8.17