Tizen Native API
Maps Service

The Maps Service provides an Application Developer with Maps Service APIs.

Required Header

#include <maps_service.h>

Overview

Maps API provides a developer with a set of functions, helping to create Maps aware applications
Maps API comprises following features:

  • Geocoding and reverse geocoding
  • Discovering Place information
  • Calculating Route

Maps API allows a Developer to choose one of Map Providers which are being included as plugins

Features

Geocoding

  • The Maps Geocoding API allows mapping an address to its geographical location defined in terms of latitude and longitude; the input can be a qualified and structured address or a free-formed search text with full or partial address information.
  • The example below shows a structured address:
    • housenumber=117,
    • street=Invaliden street
    • city=Berlin,
    • postalcode=10115,
    • country=Germany,
    • state=Berlin

Reverse Geocoding

  • The Maps Reverse Geocoding API allows to inverse mapping a geographical location (longitude, latitude) to an address; it can be used to answer the question "Where am I?".

Route

  • The Maps Route API provides ways to calculate a route that defines a path between a start and a destination and may, optionally, pass through specific intermediate locations.
  • Route Preferences:
    • Travel Mode (car, pedestrian, public transit, truck),
    • Optimization (fastest, shortest),
    • Avoid/Prefer Preferences (toll road, motorway, ferry, public transit, tunnel, dirt road, parks, car-pool lane).
  • Route Calculations
    • Way points and preferences as input values,
    • Route geometry and maneuver (instructions for guidance) as result values:
      • Geometry consists of points that visually represent the determined route,
      • Maneuver contains turn-by-turn instruction and position.

Places

  • The Maps Place API allows you to find place information
  • Place search
    • Depending on the location context, the number of relevant places might be large. Therefore this query may not only return places, but also suggestions for additional filter criteria that allow users to interactively refine the classes of places they are interested in.
  • Nearby Search: search for places within a specified area. You can refine your search request by supplying keywords, Name of Points of Interests, or Proximity
  • Category Search: search for popular places for the given location context and matching the category filter criteria. You can refine your search request by specifying the categories of place you are searching for.
  • Result item type of searching
    • id, name, location, distance, URI, rating, category.
  • Place information allows to fetch details about a place. The following place content is supported:
    • Base Attribute includes name, location, categories, contacts, id, ratings, icon path, image content, review content, and editorial content.
    • Extended Attribute refers to opening hours, payment methods, annual closings, disabled access.

The developer is allowed to choose one of map providers by manipulating map plug-ins.