app/org.scottishtecharmy.soundscape.geoengine

Package-level declarations

Types

open class GridState(val zoomLevel: Int = MAX_ZOOM_LEVEL, val gridSize: Int = GRID_SIZE, passedInTreeContext: CloseableCoroutineDispatcher? = null)

PositionedString

data class PositionedString(val text: String, val location: LngLatAlt? = null, val earcon: String? = null, val type: AudioType = AudioType.STANDARD, val heading: Double? = null)

ProtomapsGridState

open class ProtomapsGridState(val zoomLevel: Int = MAX_ZOOM_LEVEL, val gridSize: Int = GRID_SIZE, passedInTreeContext: CloseableCoroutineDispatcher? = null) : GridState

StreetPreview

class StreetPreview

StreetPreviewChoice

data class StreetPreviewChoice(val heading: Double, val name: String, val way: Way)

StreetPreviewEnabled

enum StreetPreviewEnabled : Enum<StreetPreviewEnabled>

StreetPreviewState

data class StreetPreviewState(val enabled: StreetPreviewEnabled = StreetPreviewEnabled.OFF, val choices: List<StreetPreviewChoice> = emptyList())

TextForFeature

data class TextForFeature(val text: String = "", val generic: Boolean = false)

TreeId

enum TreeId : Enum<TreeId>

UserGeometry

class UserGeometry(val location: LngLatAlt = LngLatAlt(), var phoneHeading: Double? = null, var fovDistance: Double = 50.0, val speed: Double = 0.0, val mapMatchedWay: Way? = null, val mapMatchedLocation: PointAndDistanceAndHeading? = null, val currentBeacon: LngLatAlt? = null, val ruler: Ruler = CheapRuler(location.latitude), val timestampMilliseconds: Long = 0, headingMode: UserGeometry.HeadingMode = HeadingMode.CourseAuto, travelHeading: Double? = null, headHeading: Double? = null, val inStreetPreview: Boolean = false)

UserGeometry contains all of the data relating to the location and motion of the user. It's aim is to reduces the number of arguments to many of the API calls and to concentrate some of the logic around heading choice.

Properties

GRID_SIZE

const val GRID_SIZE: Int = 2

MAX_ZOOM_LEVEL

const val MAX_ZOOM_LEVEL: Int = 15

The zoom level and grid size were constant when using soundscape-backend at 16 and 3 respectively. With protobuf tiles the tile grid for walking around will be 15 and 2, but we can also have a lower zoom level to allow us to give better context when we're travelling by faster means of transport e.g. inter city train. The lower zoom levels mean that we can search for the nearest village or town instead of just the nearest street or road.

PROTOMAPS_SERVER_BASE

const val PROTOMAPS_SERVER_BASE: String

The default tile server is the one out in the cloud where the tile JSON is at: https://server/protomaps.json

PROTOMAPS_SERVER_PATH

const val PROTOMAPS_SERVER_PATH: String

PROTOMAPS_SUFFIX

const val PROTOMAPS_SUFFIX: String

Functions

formatDistance

fun formatDistance(distance: Double, localizedContext: Context): String

We're going to round metric as documented for iOS: For metric units, we round all distances less than 1000 meters to the nearest 5 meters and all distances over 1000 meters to the nearest 50 meters.

getTextForFeature

fun getTextForFeature(localizedContext: Context?, feature: Feature): TextForFeature

getNameForFeature returns text describing the feature for callouts. Usually it returns a name or if it doesn't have one then a localized description of the type of feature it is e.g. bike parking, or style. Some types of Feature have more info e.g. bus stops and railway stations

localReverseGeocode

fun localReverseGeocode(location: LngLatAlt, gridState: GridState, settlementGrid: GridState, localizedContext: Context?): LocationDescription?

reverseGeocode

fun reverseGeocode(userGeometry: UserGeometry, gridState: GridState, settlementGrid: GridState, localizedContext: Context?): PositionedString?

Reverse geocodes a location into 1 of 4 possible states