HERE Android SDK Developer's Guide

Starting and Stopping LiveSight

It is important to make a distinction between the two operating modes provided by the CompositeFragment, Map Mode and LiveSight Mode. Map Mode is the mode of operation that is the same as that provided by the MapFragment. As with MapFragment, Map Mode behavior and functionality are as described under Maps. LiveSight Mode is the mode of operation that provides the LiveSight experience and has separate functionality and behavior.

Note: It may be confusing that the map is still displayed even when LiveSight Mode is enabled. While this map view is a part of the LiveSight experience, it has different functionality and behavior than Map Mode.
Figure 1. Map Mode
Figure 2. LiveSight Mode

To switch between Map Mode and LiveSight Mode, two methods from the ARController, start() and stop(), are used. The start() method triggers the transition from Map Mode to LiveSight Mode, which includes a short cinematic transition animation by default. Calling start() while already in LiveSight Mode results in the Error.INVALID_OPERATION error code being returned. Use the stop() method to transition from LiveSight Mode to Map Mode. By default the CompositeFragment starts in Map Mode.

// Triggers the transition from Map Mode to LiveSight Mode
Error error = arController.start();
...
// Exits LiveSight Mode and returns to Map Mode
Error error = arController.stop(true);

Reading the Current Pose

The ARController provides a convenient way to retrieve the current positional and directional (pose) values of your LiveSight session. By calling ARController.getPose(), you can retrieve the ARPoseReading instance, which contains the following values:
  • Heading
  • Pitch
  • Roll
  • Latitude
  • Longitude
  • Altitude
  • Timestamp
Although these ARPoseReading values are derived from device sensors, they are interpolated and smoothed by the LiveSight engine.

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.