Common simple tasks

Last update: API 0.9.0

Check the first steps to get a basic overview of common patterns in Locus API.

Get app core information

Object LocusInfo hold all core information about certain Locus Map application.

val locusInfo = ActionBasics.getLocusInfo(ctx, lv)

With known LocusInfo, you may get answers on

locusInfo.isRunning()

locusInfo.getRootDirectory()

And so on. Check Javadocs for LocusInfo object to see all available options.

Object UpdateContainer hold a lot of various information about the current map view, location, navigation system etc.

val uc = ActionBasics.getUpdateContainer(ctx, lv)

The container is re-generated once per 1/2 second, so more frequent requests result in the same object.

Since Locus version 279, all intents that Locus send contains it's packageName, so you may use

val lv = LocusUtils.createLocusVersion(ctx, intent)

to immediately construct required LocusVersion from received intent.

LocusUtils.callStartLocusMap(ctx)