Category |
Use case |
Note by GENIVI |
GENIVI requirement |
GENIVI API |
Map Viewer |
|
|
|
|
Map Loading |
To load the map according to vehicle's position. Vehicle's position should be at the center of the map |
covered by mapviewer |
yes |
Set/GetFollowCarMode |
Location Detection |
To provide the app a means to detect the vehicle's position, such as the coordinates value, or the city where the vehicle is |
covered by enhanced position and map matched position |
yes |
GetPosition, GetAddress |
Map Layer Type Control |
To provide the app a means to configure the map layer type. E.g. Satellite Map Layer, Real-time Traffic Map Layer, etc. |
covered by mapviewer |
yes |
Set/GetMapViewObjectVisibility |
Map Zooming |
To provide the app a means to get / set the zoom level of map |
covered by mapviewer |
yes |
Set/GetCameraDistanceFromTargetPoint |
Map Panning |
To provide the app a means to pan the map |
covered by mapviewer |
yes |
Set/GetMapViewPan |
Map Rotating |
To provide the app a means to rotate the map |
covered by mapviewer |
yes |
Set/GetMapViewRotation |
Map Language |
To provide the app a means to configure the displaying language on map |
covered by configuration |
yes |
Set/GetLocale |
Map Center |
To provide the app a means to get / set the center position of map |
covered by mapviewer |
yes |
Set/GetTargetPoint |
Get Resolution |
To provide the app a means to get the map resolution, meter/pixel |
set is covered by mapviewer, get is missing |
partially |
To add GetMapViewScaleByMetersPerPixel |
Map Layer Overlay |
To provide the app a means to overlay more than one map layers together |
the mapviewer API allows to manage instances of map, the overlay feature is out of scope |
yes |
CreateMapViewInstance , GetMapViewType, SetMapViewVisibilityMode ... |
Map Marker |
To provide the app a means to add, move, delete, or configure (e.g. label, marker icon, etc.) a marker on map |
covered by mapviewer |
yes |
Display/HideCustomElements |
Track Playback |
Play back the track the vehicle went through |
It's possible to play the route in simulation mode. To play back the track, it's needed to extend the API. |
no |
To add an extension to guidance |
POI |
|
|
|
|
Key word searching in chosen city |
To get a list of poi results within chosen city according to the keyword, POI type (optional, e.g. hotel, cinema, restaurant, scenic, etc.) |
covered by poisearch |
yes |
StartPoiSearch,RequestResultList ... |
Key word searching nearby |
To get a list of poi results in nearby according to the keyword. The nearby range can be defined by vehicle's position and radius. If found, the distance from the vehicle should be returned |
covered by poisearch |
yes |
SetCenter, SetCategories (to set the radius per category) |
Key word searching within bound |
To get a list of poi results within a pre-defined bound, according to the keyword. If the bound is rectangle, then the position of southwest and northeast should be provided. If the bound is polygon, the position of each node should be provided in order |
not covered by poisearch, search is only into a circle |
no |
To add an extension to poisearch |
Get Detailed POI info |
Get detailed info of searched poi result. Info could be: name, type (e.g. hotel, restaurant, cinema, etc.), location (coordinates value), address, tel, website, city name, postcode, email, and more detailed description |
covered by poisearch |
yes |
SetCategories, SetAttributes, GetPoiDetails |
Get Detailed Hotel POI info |
If the poi result is type of hotel, the detailed description could include: rating, star level, introduction, lowest price, facility rating, health rating, environment rating, service rating, how to get there, info source, etc. |
covered by poisearch, except 'how to get there' |
partially |
To add something to provide the 'how to get there', maybe by using the route calculation ? |
Get Detailed Cinema POI info |
If the poi result is type of cinema, the detailed description could include: introduction, rating, parking, opening time, info source, etc. |
covered by poisearch |
yes |
SetCategories, SetAttributes, GetPoiDetails |
Get Detailed restaurant POI info |
If the poi result is type of restaurant, the detailed description could include: cuisine, introduction, rating, info source, taste rating, environment rating, service rating, cost, recommend, atmosphere, ordering link, opening time, etc. |
covered by poisearch |
yes |
SetCategories, SetAttributes, GetPoiDetails |
Get Detailed scenic POI info |
If the poi result is type of scenic, the detailed description could include: introduction, rating, info source, price, recommended season, recommended spots, theme, ordering link, opening time, etc. |
covered by poisearch |
yes |
SetCategories, SetAttributes, GetPoiDetails |
Driving Route Planning |
|
|
|
|
Driving Route Planning |
To get a list of driving routes, according to input origin and destination and via points if needed (coordinates or name string), and policy (e.g. time least, cost least, distance least, taking real traffic into account or not, etc.). If found, the list of driving routes should be returned. For each driving route, it should include e.g. distance, consuming time, list of driving segments (driving through one straight road could be considered as one segment. If taking a turn, then next segment begins). For each segment, start and end position, distance, consuming time, orientation, road name, driving instruction, action may be done after completing current segment e.g. should be provided. |
covered by routing |
yes |
GetRouteSchedule, GetWaypoints , GetRouteSegments , GetRouteOverview ... |
Route Planning including public transport, or walking |
To get a list of routes (driving+walking, driving+public transport, driving+public transport+walking), according to input origin and destination and via points if needed (coordinates or name string).
- For public transport segment, the result can be calculated based on policy (e.g. time least, cost least, walk least, transfer least, etc.). The result will include start and end name/position, cost, time, distance, transport mode (BUS, SUBWAY, RAILWAY), - For walking segment, the result will include start and end name/position, time, distance, list of road info (road start/end position, walking orientation, walking instruction, action may be done after completing current road, etc.) of the walking route |
covered by routing |
yes |
GetAllRoutes and get the info for each of the routes |
Result Display |
The driving route should be drew on the map. If real traffic is considered to calculate the route, the congestion condition of each segment will be marked, by different colors. To give user a direct view of the route condition |
covered by map viewer (if guidance is on) |
yes |
DisplayRoute, ... |
Search Road Info |
|
|
|
|
Search Road |
To get the info of one road within the chosen city according to the road name. It will return info such as road type, center coordinates of this road, road path (a list of coordinates values, which can be used to draw the road path), recommended list of road names if no match, etc. |
not covered |
no |
to be added to mapmatched position or routing ? |
Search Crossroad |
To get the info of one crossroad within the chosen city according to the crossroad name. It will return info such as coordinates of this crossroad, names of the two roads, recommended list of crossroad names if no match, etc. |
not covered |
no |
to be added to mapmatched position or routing ? |
Search Administrative Division |
|
|
|
|
Search Administrative Division |
To get the info of administrative division according to keyword, and optional division level. It will return info such as its name, center position (coordinates), a list of coordinates values that can draw boundary on map, a list of subdivisions if contain, etc. |
not covered |
no |
to be added to mapmatched position or routing ? |
Geocoding |
|
|
|
|
Forward Geocoding |
Enrich a description of a location, typically a place name, with geographic coordinates. |
not covered by existing API |
no |
To be added to map matched position |
Reverse Geocoding |
Enrich geographic coordinates with a description of the location, most typically a place name, or nearby POI |
not covered by existing API |
no |
To be added to map matched position |
System Interface |
|
|
|
|
touchscreen control |
To provide the user a direct means to inteface with the app. |
out of scope of GENIVI for the moment |
no |
|
Text to Speech Feedback |
To provide the app a means to use any txt to speech that may be available. |
covered by speech output |
yes |
wil be available for release L (spring 2016) |