Child pages
  • Interoperability API
Skip to end of metadata
Go to start of metadata

Interoperability API

Just added some non formal specs for some parts of the API.
COMPLETE ME!

Introduction

The Android SDK provides a set of APIs to facilitate apps interoperate among them. Some of those APIs are Intents , Services or Broadcast Receivers

The idea is to provide gvSIG Mini with a simple API based on the Android SDK interoperability mechanisms so a third party app could easily consume some of the functionalities of gvSIG Mini. The API should be as generic as possible so any other GIS Android app could implement it.

Non formal specs:

  • Show map: Just opens the map
  • Show location: Shows a given location in the map. Should we use geoURI? inputs: longitude, latitude, zoom level. Optional inputs: layer name (i.e. OPEN STREET MAP), forceGPSLocation (will show the location given by the GPS)
  • Show marker: Shows the map centered in a given location, shows a marker and a return activity. inputs: same as Show Location + marker img (path to a png to symbolize the marker) + description (text to show in the popup) + returnActivity (name of the activity to return when the user taps on the marker). Optional inputs: properties (key-value pairs of properties to attach to the marker) in this case the returnActivity class has no sense as the properties will be shown in a gvSIG Mini activity.
    This action should be easily extandable to provide a list of points, lines or polygons
  • Get point: Opens the map, the user touches a point and returns the coordinates to the return activity. Outputs: longitude, latitude
  • Get GPS locations: Should this be a service?
  • Distance in meters between two points.
  • Orientation between two points
  • Open a vector file from the SD card (KML, GML, GPX, GeoJSON, SHP, ...): Provide the path of a file in the SD card, gvSIG Mini automatically selects the driver and shows the layer. It will be usefull provide the return Activity, so any time a feature is selected in the map, gvSIG Mini will return the feature (geometry + properties) to the return activity.
  • Open a remote vector file: Same as previous but should we use geoURI?
  • Export a file to another file type
  • Export an in memory loaded layer to a file type
  • Configure automatically a WMS server from a link from a webpage (or more general from a URI). There are many web pages from SDIs that publish their WMS urls and provide a link to the getCapabilities request. gvSIG Mini should register to that kind of URI and automatically call the getCapabilities to configure the layer.
  • Reverse geocode: Given a location return the place name and the service that provides it (geonames, nominatim, google, yahoo, etc.)
  • Geocode: Given a place name return the coordinates and the service that provides them.
    Those two operations could be services or an action that shows in the map the location and a popup with the description of the location
  • Move a point: Given a point, the action opens the map and the user can move the point to another location. The output will be the new location of the point.
  • Draw geometry: An action to open the map and as the user touches the screen a geometry is drawn. It could be configurable to draw a single point, multipoints, line(s) or polygon(s). When the drawing has finished it backs to the return activity in the intent.
  • Export map as PNG: Given a location, request the map to the map server and save as PNG to the SD card.
  • Register to filesystem (or web) URIs of files that gvSIG Mini can open (.kml, .gml, .gpx, .geoJSON, .shp...)
  • Think in common intents for JTS Geometry operations (contains, buffer, touches, intersects, etc.). Usually the inputs are two geometries and the outputs a boolean or a geometry.

Define above a set of actions, categories, extra data, etc... based on these specs.

Intent actions

ACTION 1: SHOW_LAST_MAP
Activity Action:

Just opens the gvSIG Mini Map Activity with the latest state stored by gvSIG Mini.

Input:

Nothing

Optional Input:

Nothing

Output:

Nothing

Constant value:
Notes:

-

ACTION 2: SHOW_LOCATION
Activity Action:

Opens the gvSIG Mini Map Activity centered on a given location. This given location has to include an ID that identifies the point.

Optionally, this action allows to configure a title name, an icon representing the location, a zoom level and the text that will be included in a popup showed when user clicks in the icon.

If these optional inputs are not specified, gvSIG Mini will show a default title name, icon and zoom level. In addition, no popup will be showed when user clicks.

Input:

Latitude (EXTRA_LATITUDE)
Longitude (EXTRA_LONGITUDE)
*Note that latitude and longitude can be passed manually or through a geoUri. Both options are supported.

Optional Input:

Layer Name (EXTRA_LAYER_NAME)
Icon Point (EXTRA_POINT_ICON)
Zoom Level (EXTRA_ZOOM_LEVEL)
Popup Text (EXTRA_POPUP_TEXT)

Output:

Nothing

Constant value:

mini.intent.action.SHOW_LOCATION

Notes:

-

ACTION 3: SHOW_USER_LOCATION
Activity Action:

Opens the gvSIG Mini Map Activity centered on the user's location if possible.

Optionally, it allows to configure a title name, an icon representing the location, a zoom level and a text that is included in a popup showed when user clicks in the icon.

If these optional inputs are not specified, gvSIG Mini will show a default title name, icon and zoom level. In addition, no popup will be showed when user clicks.

Input:

Nothing

Optional Input:

Layer Name (EXTRA_LAYER_NAME)
Icon Point (EXTRA_USER_ICON)
Zoom Level (EXTRA_ZOOM_LEVEL)
Popup Text (EXTRA_POPUP_TEXT)

Output:

Nothing

Constant value:

mini.intent.action.SHOW_USER_LOCATION

Notes:

No location is needed as input data since gvSIG Mini can provide the user's location.

ACTION 4: SHOW_LOCATION_IN_ACTIVITY
Activity Action:

Opens the gvSIG Mini Map Activity centered on a given location.

It also provides a popup showed when user taps over a marker. This popup includes an operation that leads user to a particular Activity developed by the third-party app.

Optionally, it allows configuring a title name, an icon representing the location, a zoom level. If these optional inputs are not specified, gvSIG Mini will show a default title name, icon and zoom level.

Input:

Latitude (EXTRA_LATITUDE)
Longitude (EXTRA_LONGITUDE)
*Note that latitude and longitude should be passed manually or through a geoUri. Both options are supported.
Id Point (EXTRA_POINT_ID)

Callback button name (EXTRA_CALLBACK_OPERATION_NAME)
Callback Activity Name (EXTRA_CALLBACK_DESTINATION_NAME)

Optional Input:

Layer Name (EXTRA_LAYER_NAME)
Icon Point (EXTRA_POINT_ICON)
Zoom Level (EXTRA_ZOOM_LEVEL)

Output:

Nothing

Constant value:

mini.intent.action.SHOW_LOCATION_IN_ACTIVITY

Notes:

This action should be easily extandable to provide a list of points, lines or poligons.

ACTION 5: GET_USER_COORDINATES
Service Action:

Use gvSIG Mini as a Service for obtaining the user's location and some derived data.

Input:

Nothing

Optional Input:

Nothing

Output:

Selected Latitude (EXTRA_RETURNED_LATITUDE)
Selected Longitude (EXTRA_RETURNED_LONGITUDE)
Accuracy (EXTRA_RETURNED_ACCURACY)
Altitude (EXTRA_RETURNED_ALTITUDE)
Provider type (EXTRA_RETURNED_PROVIDER_TYPE)
Output success (EXTRA_OUTPUT_SUCCESS)
Output info (EXTRA_OUTPUT_INFO)

Constant value:

mini.intent.action.GET_USER_COORDINATES

Notes:

Check if is also possible to return the speed.

ACTION 6: GET_GPS_LOCATIONS
Service Action:

This action use gvSIG Mini to obtain a user's tracking for N minutes.

Input:

Duration of tracking in minutes (EXTRA_TRACKING_DURATION)

Optional Input:

Nothing

Output:

The following three variables compose the user's tracking:
Latitude collection (EXTRA_RETURNED_LATITUDE_COLLECTION)
Longitude collection (EXTRA_RETURNED_LATITUDE_COLLECTION)
Accuracy collection (EXTRA_RETURNED_ACCURACY_COLLECTION)
Altitude collection (EXTRA_RETURNED_ALTITUDE_COLLECTION)
Times collection (EXTRA_RETURNED_TIME_COLLECTION)

Output success (EXTRA_OUTPUT_SUCCESS)
Output info (EXTRA_OUTPUT_INFO)

Constant value:

mini.intent.action.GET_GPS_LOCATIONS

Notes:

-

ACTION 7: SHOW_ROUTE
Activity Action:

Opens the map and show the route between two points.

Optionally, it allows to personalize the origin icon, the destination icon and the texts included in the popups that are showed when user clicks in both points.

If user does not specify these icons, it can specify a color to configure a standard icon.
If no icons or colors are specified, gvSIG Mini will provide default values.

This action also allows user to specify the mean of transport of the user. In If this addition, it also allows users to specify if they want the shortest route or the fast route.

Input:

Latitude_start (EXTRA_START_LATITUDE)
Longitude_start (EXTRA_START_LONGITUDE)
Latitude_end (EXTRA_END_LATITUDE)
Longitude_end (EXTRA_END_LONGITUDE)

Optional Input:

Location in the SD Card of the icon for the origin icon. (EXTRA_ORIGIN_POINT_ICON)
Location in the SD Card of the icon for the destination icon (EXTRA_DESTINATION_POINT_ICON)
Color of the origin point (EXTRA_ORIGIN_POINT_COLOR)
Color of the destination point (EXTRA_DESTINATION_POINT_COLOR)
Text that will be include in a popup of the origin point (EXTRA_ORIGIN_TEXT_POPUP)
Text that will be include in a popup of the destination point
(EXTRA_DESTINATION_TEXT_POPUP)
Mean of transport (car, bike, on foot) (EXTRA_MEAN_OF_TRANSPORT)
Selection of the shortest route (EXTRA_SHORTEST_ROUTE)
Selection of the fast route (EXTRA_FAST_ROUTE)
Zoom Level (EXTRA_ZOOM_LEVEL)

Output:

Nothing

Constant value:

mini.intent.action.SHOW_ROUTE

Notes:

-

ACTION 8: SHOW_ROUTE_FROM_HERE
Activity Action:

Opens the map and show the route between the user's location and a point.

Optionally, it allows personalizing the user's icon and the text included in the popup that is showed when user clicks in this point. Otherwise, gvSIG Mini will provide a default icon and no popup will be provided.

This action also allows personalizing the destination icon. Otherwise, developers can specify a color to configure a standard icon that is provided by gvSIG Mini. Furthermore, it allows specifying the text included in the popup that is showed when user clicks in this point. If developer doesn't any text, gvSIG Mini will not provide any popup.

This action also allows user to specify the mean of transport of the user. In addition, it also allows users to specify if they want the shortest route or the fast route.

Input:

Latitude_end (EXTRA_END_LATITUDE)
Longitude_end (EXTRA_END_LONGITUDE)

Optional Input:

Icon Point (EXTRA_USER_ICON)
Location in the SD Card of the icon for the destination icon (EXTRA_DESTINATION_POINT_ICON)

Color of the origin point (EXTRA_ORIGIN_POINT_COLOR)
Color of the destination point (EXTRA_DESTINATION_POINT_COLOR)
Text that will be include in a popup of the origin point (EXTRA_ORIGIN_TEXT_POPUP)
Text that will be include in a popup of the destination point (EXTRA_DESTINATION_TEXT_POPUP)
Mean of transport (car, bike, on foot) (EXTRA_MEAN_OF_TRANSPORT)
Selection of the shortest route (EXTRA_SHORTEST_ROUTE)
Selection of the fast route (EXTRA_FAST_ROUTE)
Zoom Level (EXTRA_ZOOM_LEVEL)

Output:

Nothing

Constant value:

mini.intent.action.SHOW_ROUTE_FROM_HERE

Notes:

-

ACTION 9:GET_DISTANCE_BETWEEN_TWO_POINTS
Service Action:

Returns the distance between two points.

This action allows developers to get the distance of the straight line between the points by setting true the Boolean EXTRA_STRAIGHT_LINE_DISTANCE. Otherwise, gvSIG Mini will provide a car as the target mean of transport.

As default, this action returns the result in meters. If the developer wants the result in miles, it will have to set true the Boolean EXTRA_GET_DISTANCE_IN_MILES
(in meters).

Input:

Latitude_start (EXTRA_START_LATITUDE)
Longitude_start (EXTRA_START_LONGITUDE)
Latitude_end (EXTRA_END_LATITUDE)
Longitude_end (EXTRA_END_LONGITUDE)

Optional Input:

Obtain the distance of the straight line between the two points (EXTRA_STRAIGHT_LINE_DISTANCE)
Obtain the distance in miles (EXTRA_GET_DISTANCE_IN_MILES)

Output:

Distance (EXTRA_RETURNED_DISTANCE)
Output success (EXTRA_OUTPUT_SUCCESS)
Output info (EXTRA_OUTPUT_INFO)

Constant value:

mini.intent.action.GET_DISTANCE_BETWEEN_TWO_POINTS

Notes:

-

ACTION 10: WMS_SERVER_FROM_LINK
Action Action:

Configure automatically a WMS server from a link from a webpage (or more general from a URI). There are many web pages from SDIs that publish their WMS urls and provide a link to the getCapabilities request. gvSIG Mini should register to that kind of URI and automatically call the getCapabilities to configure the layer.

Input:

WMS Server Link (EXTRA_WMS_SERVER_LINK)

Optional Input:

Nothing

Output:

Nothing

Constant value:

mini.intent.action.WMS_SERVER_FROM_LINK

Notes:

-

ACTION 11: CHANGE_TYPE_OF_FILE
Service Action:

This service receives a filepath of a file saved in the SD Card. gvSIG MIni selects a driver to manage the file. Then, it parses the file to the target format and save the generated file also in the SD Card. Finally, gvSIG Mini returns the filepath of the new file.

Optionally, this service can receive the extension of the original file to facilitate the driver´s selection.

Input:

Filepath of the file (EXTRA_ORIGIN_FILE_PATH)
Target format (EXTRA_DESTINATION_FILE_FORMAT)

Optional Input:

Original Format (EXTRA_ORIGIN_FILE_FORMAT)

Output:

Filepath of the file (EXTRA_RETURNED_FILE_PATH)
Output success (EXTRA_OUTPUT_SUCCESS)
Output info (EXTRA_OUTPUT_INFO)

Constant value:

mini.intent.action.CHANGE_TYPE_OF_FILE

Notes:

-

ACTION 12: SAVE_CSV_TO_FILE
Service Action:

This service receives the route of a CSV file that is located in the SD Card.

In addition, this service receives a string that represents the target format.

Then, this service saves the received data in the target format and save the layer in a file that is located in the SD Card.

Input:

Filepath of the file (EXTRA_ORIGIN_FILE_PATH)
Target format (EXTRA_DESTINATION_FILE_FORMAT)

Optional Input:

Nothing

Output:

Filepath of the file (EXTRA_RETURNED_FILE_PATH)
Output success (EXTRA_OUTPUT_SUCCESS)
Output info (EXTRA_OUTPUT_INFO)

Constant value:

mini.intent.action.SAVE_CSV_TO_FILE

Notes:

Pending: refine the CSV structure in future steps. It can be something like:
x, y, attribute1, attribute2, attribute3...
Each line can be a geometry.

ACTION 13: MOVE_LOCATION
Activity Action:

Opens the gvSIG Mini Map Activity centered on the given location. Then, user is allowed to move the show location to another location. Finally, the new location is returned to the third-party application.
Optionally, it allows to configure a title name, an icon representing the location, a zoom level and a text that is included in a popup showed when user clicks in the icon.
If these optional inputs are not specified, gvSIG Mini will show a default title name, icon and zoom level.

Input:

Latitude (EXTRA_LATITUDE)
Longitude (EXTRA_LONGITUDE)
*Note that latitude and longitude can be passed manually or through a geoUri.

Optional Input:

Layer Name (EXTRA_LAYER_NAME)
Icon Point (EXTRA_POINT_ICON)
Zoom Level (EXTRA_ZOOM_LEVEL)

Output:

FSelected Latitude (EXTRA_RETURNED_LATITUDE)
Selected Longitude (EXTRA_RETURNED_LONGITUDE)

Constant value:

mini.intent.action.MOVE_LOCATION

Notes:
ACTION 14: EXPORT_POINT_IN_MAP_AS_PNG
Service Action:

This service receives the location that the user wants to show in a map and a quantity of meters that is used to construct a bounding box.

According this information, gvSIG Mini obtains the resulting map and saves it in a .PNG file located in the SD Card.

Optionally, it allows configuring a zoom level. If this optional input is not specified, gvSIG Mini will provide a default zoom level.

Input:

Latitude (EXTRA_LATITUDE)
Longitude (EXTRA_LONGITUDE)
*Note that latitude and longitude can be passed manually or through a geoUri.
Radius in meters (EXTRA_RADIUS)

Optional Input:

Zoom Level (EXTRA_ZOOM_LEVEL)

Output:

Filepath of the created file (EXTRA_RETURNED_FILE_PATH)
Output success (EXTRA_OUTPUT_SUCCESS)
Output info (EXTRA_OUTPUT_INFO)

Constant value:

mini.intent.action.EXPORT_POINT_IN_MAP_AS_PNG

Notes:
ACTION 15: EXPORT_BBOX_IN_MAP_AS_PNG
Service Action:

This service receives a bounding box. According this bounding box, gvSIG Mini obtains the resulting map and saves it in a .PNG file located in the SD Card.

Optionally, it allows configuring a zoom level. If this optional input is not specified, gvSIG Mini will provide a default zoom level.

Input:

A bounding box (EXTRA_BOUNDING_BOX)

Optional Input:

Zoom Level (EXTRA_ZOOM_LEVEL)

Output:

Filepath of the created file (EXTRA_RETURNED_FILE_PATH)
Output success (EXTRA_OUTPUT_SUCCESS)
Output info (EXTRA_OUTPUT_INFO)

Constant value:

mini.intent.action.EXPORT_BBOX_IN_MAP_AS_PNG

Notes:
ACTION 16: REVERSE_GEOCODE
Service Action:

Reverse geocode: given a location, return the place name and the service that provides it (geonames, nominatim, google, yahoo, etc.)

Input:

Latitude (EXTRA_LATITUDE)
Longitude (EXTRA_LONGITUDE)
*Note that latitude and longitude can be passed manually or through a geoUri.

Optional Input:

Nothing

Output:

Place Name (EXTRA_RETURNED_PLACE_NAME)
Service Name (EXTRA_RETURNED_SERVICE_NAME)
Output success (EXTRA_OUTPUT_SUCCESS)
Output info (EXTRA_OUTPUT_INFO)

Constant value:

mini.intent.action.REVERSE_GEOCODE

Notes:
ACTION 17: GEOCODE
Service Action:

Geocode: given a place name return the coordinates and the service that provides them.

Input:

Place Name (EXTRA_PLACENAME)

Optional Input:

Nothing

Output:

Selected Latitude (EXTRA_RETURNED_LATITUDE)
Selected Longitude (EXTRA_RETURNED_LONGITUDE)
Accuracy (EXTRA_RETURNED_ACCURACY)
Altitude (EXTRA_RETURNED_ALTITUDE)
Provider type (EXTRA_RETURNED_PROVIDER_TYPE)
Service Name (EXTRA_RETURNED_SERVICE_NAME)
Output success (EXTRA_OUTPUT_SUCCESS)
Output info (EXTRA_OUTPUT_INFO)

Constant value:

mini.intent.action.GEOCODE

Notes:
ACTION 18: GET_GEOMETRY
Activity Action:

Opens the map and offers the user the possibility of touching the screen to draw a geometry. When the user ends the geometry and pushes a button, the geometry is stored in the EXTRA_ORIGIN_FILE_PATH. Otherwise, if the file is not specified, gvSIG Mini will create a file that will be returned as an output.

In addition, if the file contains geometries, gvSIG Mini will add the new geometry.

After writing the new geometry into the file, gvSIG Mini will redirect user to the third party application through the EXTRA_CALLBACK_DESTINATION_NAME attribute.

Optionally, this action also allows configuring the title name. If this optional input is not specified, gVSIG Mini will show a default layer name.

Input:

Type of geometry (EXTRA_TYPE_OF_GEOMETRY)
Callback Activity Name (EXTRA_CALLBACK_DESTINATION_NAME)

Optional Input:

Filepath of the file that stores a geometry collection (EXTRA_ORIGIN_FILE_PATH)
Zoom Level (EXTRA_ZOOM_LEVEL)
Layer Name (EXTRA_LAYER_NAME)

Output:

Filepath of the file that stores a geometry collection EXTRA_DESTINATION_FILE_PATH)

Constant value:

mini.intent.action.GET_GEOMETRY

Notes:

With this action, the developers use gvSIG Mini as a tool for creating geometries. So, they can get geometries with latitudes, longitudes,..

However, in this action no support to add other attributes such as the layer name is provided.
This action, only provide a geometry in a geoJSON format (to decide). So, developers can include in their third party application the functionality of adding these kind of attributes and modifying the geoJSON File.

This action can be used several times so that developers are allowed to create a layer with several geometries.

Warning

The following Actions have to be reviewed and completed. It is neccessary to intercept the intents that allow to open these types of files.

ACTION 19: SHOW_VECTOR_FILE
Activity Action:

Open a vector file from the SD Card (KML, GML, GPX, GeoJSON, SHP, ...): Provide the path of a file in the SD Card, gvSIG Mini automatically selects the driver and shows the layer. It will be usefull provide the return Activity, so any time a feature is selected in the map, gvSIG Mini will return the feature (geometry + properties) to the return activity.

Input:

LOCATION IN SDCARD
CALLBACK_ACTIVITY

Optional Input:

Nothing

Output:

Nothing

Constant value:

mini.intent.action.

Notes:

The definition of this action is incomplete. Edit.

ACTION 20: SHOW_REMOTE_VECTOR_FILE
Activity Action:

Open a remote vector file: Same as previous but should we use geoURI?

Input:
Optional Input:
Output:
Constant value:

mini.intent.action.

Notes:

The definition of this action is incomplete. Edit.

ACTION 21: REGISTER_OPENABLE_FILES
Activity Action:

Register to filesystem (or web) URIs of files that gvSIG Mini can open (.kml, .gml, .gpx, .geoJSON, .shp...)

Input:
Optional Input:
Output:
Constant value:

mini.intent.action.

Notes:

The definition of this action is incomplete. Edit.

Extras

Define here extra_data to provide with the intent actions

EXTRA_LATITUDE
  • A double value representing a latitude coordinate.
  • Constant value: "mini.intent.extra.LATITUDE"
EXTRA_LONGITUDE
  • A double value representing a longitude coordinate.
  • Constant value: "mini.intent.extra.LONGITUDE"
EXTRA_ZOOMLEVEL
  • An int value representing a zoom level.
  • Constant value: "mini.intent.extra.ZOOMLEVEL"
EXTRA_BOUNDING_BOX
  • An array of doubles that specifies a bounding box as follows:
    • Position 0 represents the minimum X.
    • Position 1 represents the minimum Y.
    • Position 2 represents the maximum X.
    • Position 3 represents the maximum Y.
  • Name of the variable: "mini.intent.extra.BOUNDING_BOX"
  • Example:
    double[] value = new double[]{39,0,41,1};
    Intent myIntent = new Intent();
    Intent.putExtra("mini.intent.extra.BOUNDING_BOX",value);
EXTRA_CALLBACK_DESTINATION_NAME
  • A string value with the name of the target Activity in the Third-Party application.
  • Name of the variable: "mini.intent.extra.CALLBACK_NAME_DESTINATION"
  • Example:
    String value="Back";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra. CALLBACK_NAME_DESTINATION",value);
EXTRA_CALLBACK_OPERATION_NAME
  • A string value with the name of the operation that will allow user to return to the origin application.
  • Name of the variable: "mini.intent.extra.CALLBACK_OPERATION_NAME"
  • Example:
    String value="Back";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra. CALLBACK_OPERATION_NAME",value);
EXTRA_DESTINATION_FILE_FORMAT
  • A string value with the format of the file that has to be created.
  • Name of the variable: "mini.intent.extra.DESTINATION_FILE_FORMAT"
  • Example:
    String value="kml";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.DESTINATION_FILE_FORMAT",value);
EXTRA_DESTINATION_POINT_COLOR
  • A string value with the color of the point icon.
  • Name of the variable: "mini.intent.extra.DESTINATION_POINT_COLOR"
  • Example:
    String value="#00FF00";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.DESTINATION_POINT_COLOR",value);
EXTRA_DESTINATION_POINT_ICON
  • A string value with the path of a .PNG. This .PNG that is located in the SD Card symbolizes the point.
  • Name of the variable: "mini.intent.extra.DESTINATION_POINT_ICON"
  • Example:
    String value=Environment.getExternalStorageDirectory().toString()+"myapp/pointicon.png";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.DESTINATION_POINT_ICON",value);
EXTRA_DESTINATION_TEXT_POPUP
  • A string value with the words to be included in the popup.
  • Name of the variable: "mini.intent.extra.DESTINATION_TEXT_POPUP"
  • Example:
    String value="Home";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.DESTINATION_TEXT_POPUP",value);
EXTRA_END_LATITUDE
  • A double value with a latitude coordinate.
  • Name of the variable: "mini.intent.extra.END_LATITUDE"
  • Example:
    double value=38;
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.END_LATITUDE",value);
EXTRA_END_LONGITUDE
  • A double value with a longitude coordinate.
  • Name of the variable: "mini.intent.extra.END_LONGITUDE"
  • Example:
    double value=1;
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.END_LONGITUDE",value);
EXTRA_FAST_ROUTE
  • A boolean value that allows developers to specify if they want to get the fast route between two points.
  • Name of the variable: "mini.intent.extra.FAST_ROUTE"
  • Example:
    boolean value=true;
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.FAST_ROUTE",value);
EXTRA_GET_DISTANCE_IN_MILES
  • A boolean value that allows developers to specify if they want to receive the result in miles instance of meters.
  • Name of the variable: "mini.intent.extra.GET_DISTANCE_IN_MILES"
  • Example:
    boolean value=true;
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.GET_DISTANCE_IN_MILES",value);
EXTRA_LATITUDE
  • A double value with a latitude coordinate.
  • Name of the variable: "mini.intent.extra.LATITUDE"
  • Example:
    double value=39;
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.LATITUDE",value);
EXTRA_LAYER_NAME
  • A string value with the title of the layer.
  • Name of the variable: "mini.intent.extra.LAYER_NAME"
  • Example:
    String value="Your current location";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.LAYER_NAME",value);
EXTRA_LONGITUDE
  • A double value with a longitude coordinate.
  • Name of the variable: "mini.intent.extra.LONGITUDE"
  • Example:
    double value=1;
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.LONGITUDE",value);
EXTRA_MEAN_OF_TRANSPORT
  • A string value with the mean of transport that user will use to travel between the points of a route.
  • Name of the variable: "mini.intent.extra.MEAN_OF_TRANSPORT"
  • Example:
    String value="On foot";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.MEAN_OF_TRANSPORT",value);
EXTRA_NUMBER_OF_GEOMETRIES
  • A int value value with the number of geometries that are going to be drawn.
  • Name of the variable: "mini.intent.extra.NUMBER_OF_GEOMETRIES"
  • Example:
    int value="5";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.NUMBER_OF_GEOMETRIES",value);
EXTRA_ORIGIN_FILE_FORMAT
  • A string value with the format of the file that has to parsed.
  • Name of the variable: "mini.intent.extra.ORIGIN_FILE_FORMAT"
  • Example:
    String value="kml";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.ORIGIN_FILE_FORMAT",value);
EXTRA_ORIGIN_FILE_PATH
  • A string value with the path of a file.
  • Name of the variable: "mini.intent.extra.ORIGIN_FILE_PATH"
  • Example:
    String value=Environment.getExternalStorageDirectory().toString()+"myapp/points.kml";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.ORIGIN_FILE_PATH",value);
EXTRA_ORIGIN_POINT_COLOR
  • A string value with the color of the point icon.
  • Name of the variable: "mini.intent.extra.ORIGIN_POINT_COLOR"
  • Example:
    String value="#FF0000";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.ORIGIN_POINT_COLOR",value);
EXTRA_ORIGIN_POINT_ICON
  • A string value with the path of a .PNG. This .PNG that is located in the SD Card symbolizes the point.
  • Name of the variable: "mini.intent.extra.ORIGIN_POINT_ICON"
  • Example:
    String value=Environment.getExternalStorageDirectory().toString()+"myapp/pointicon.png";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.ORIGIN_POINT_ICON",value);
EXTRA_ORIGIN_TEXT_POPUP
  • A string value with the words to be included in the popup.
  • Name of the variable: "mini.intent.extra.ORIGIN_TEXT_POPUP"
  • Example:
    String value="UPV";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.ORIGIN_TEXT_POPUP",value);
EXTRA_OUTPUT_SUCCESS
  • A boolean variable that confirms if the service worked well or not.
  • Example:
    boolean serviceResult=serviceInterface.get_extra_output_success();
EXTRA_OUTPUT_INFO
  • A string value that complements EXTRA_OUTPUT_SUCCESS with a message.
  • Example:
    String serviceInfoResult=serviceInterface.get_extra_output_info();
EXTRA_PLACE_NAME
  • A string value with the name of a place.
  • Name of the variable: "mini.intent.extra.PLACE_NAME"
  • Example:
    String value="UPV";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.PLACE_NAME",value);
EXTRA_POINT_ICON
  • A string value with the path of a .PNG. This .PNG that is located in the SD Card and symbolizes the point.
  • Name of the variable: "mini.intent.extra.POINT_ICON"
  • Example:
    String value=Environment.getExternalStorageDirectory().toString()+"myapp/pointicon.png";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.POINT_ICON",value);
EXTRA_POINT_ID
  • A string value with the ID of the point. This id will be returned to the third-party application.
  • Name of the variable: "mini.intent.extra.POINT_ID"
  • Example:
    String value="259";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.POINT_ID",value);
EXTRA_POPUP_TEXT
  • A string value with the text to be included in the popup showed when the user taps the marker.
  • Name of the variable: "mini.intent.extra.POPUP_TEXT"
  • Example:
    String value="You are here";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra. POPUPTEXT",value);
EXTRA_RADIUS
  • A double value with a radius from a particular point.
  • Name of the variable: "mini.intent.extra.RADIUS"
  • Example:
    double value="500";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.RADIUS",value);
EXTRA_RETURNED_ACCURACY
  • A double value with the accuracy with the real location of the user.
  • Example:
    Double extra_returned_accuracy=serviceInterface.get_extra_returned_accuracy();
EXTRA_RETURNED_ACCURACY_COLLECTION
  • An array of doubles with the accuracy of the locations taken from the user.
  • Example:
    Double []extra_returned_accuracy_collection=serviceInterface.get_extra_returned_accuracy_collection();
EXTRA_RETURNED_ALTITUDE
  • A double value with the altitude of the user.
  • Example:
    Double extra_returned_altitude=serviceInterface.get_extra_returned_altitude();
EXTRA_RETURNED_ALTITUDE_COLLECTION
  • An array of doubles with the altitudes of the locations taken from the user.
  • Example:
    Double []extra_returned_altitude_collection=serviceInterface.get_extra_returned_altitude_collection();
EXTRA_RETURNED_DISTANCE
  • A double value with the distance between two points.
  • Example:
    Double extra_returned_distance=serviceInterface.get_extra_returned_distance();
EXTRA_RETURNED_FILE_PATH
  • A string value with a path of a file.
  • Example:
    String extra_returned_file_path=serviceInterface.get_extra_returned_file_path();
EXTRA_RETURNED_LATITUDE
  • A double value with a latitude coordinate.
  • Example of retrieving the variable:
    Double extra_returned_latitude=serviceInterface.get_extra_returned_latitude();
EXTRA_RETURNED_LATITUDE_COLLECTION
  • An array of doubles that contains latitudes of different user's location.
  • Example of retrieving the variable:
    double []extra_returned_latitude_collection=serviceInterface.get_extra_returned_latitude_collection();
EXTRA_RETURNED_LONGITUDE
  • A double value with a longitude coordinate.
  • Example of retrieving the variable:
    Double extra_returned_longitude=serviceInterface.get_extra_returned_longitude();
EXTRA_RETURNED_LONGITUDE_COLLECTION
  • An array of doubles that contains longitudese of different user's location.
  • Example of retrieving the variable:
    double []extra_returned_longitude_collection=serviceInterface.get_extra_returned_longitude_collection();
EXTRA_RETURNED_PLACE_NAME
  • A string value with the name of a place.
  • Example of retrieving the variable:
    String extra_returned_place_name=serviceInterface.get_extra_returned_place_name();
EXTRA_RETURNED_PROVIDER_TYPE
  • A string value with the name of the provider of the location.
  • Example of retrieving the variable:
    String extra_returned_provider_type=serviceInterface.get_extra_returned_provider_type();
EXTRA_RETURNED_SERVICE_NAME
  • A string value with the name of the service that provides a name of a place.
  • Example of retrieving the variable:
    String extra_returned_service_name=serviceInterface.get_extra_returned_service_name();
EXTRA_RETURNED_TIME_COLLECTION
  • An array of strings that contains the different times in which the user's location is taken.
  • Example of retrieving the variable:
    String []extra_returned_time_collection=serviceInterface.get_extra_returned_time_collection();
EXTRA_SERVICE_NAME
  • A string value with the name of the service that provides a name of a place.
  • Name of the variable: "mini.intent.extra.SERVICE_NAME"
  • Example:
    String value="Name of the place provider";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra. SERVICE_NAME",value);
EXTRA_SHORTEST_ROUTE
  • A boolean value that allows developers to specify if they want to get the shortest route between two points.
  • Name of the variable: "mini.intent.extra.SHORTEST_ROUTE"
  • Example:
    boolean value=true;
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.SHORTEST_ROUTE",value);
EXTRA_START_LATITUDE
  • A double value with a latitude coordinate.
  • Name of the variable: "mini.intent.extra.START_LATITUDE"
  • Example:
    double value=39.5;
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.START_LATITUDE",value);
EXTRA_START_LONGITUDE
  • A double value with a longitude coordinate.
  • Name of the variable: "mini.intent.extra.START_LONGITUDE"
  • Example:
    double value=2.3;
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.START_LONGITUDE",value);
EXTRA_STRAIGHT_LINE_DISTANCE
  • A boolean value that allows developers to specify if they want to get the distance of the straight line between two points.
  • Name of the variable: "mini.intent.extra.STRAIGHT_LINE_DISTANCE"
  • Example:
    boolean value=true;
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra. STRAIGHT_LINE_DISTANCE",value);
EXTRA_TRACKING_DURATION
  • A int value with the number of minutes that gvSIG Mini has to do the user's tracking.
  • Name of the variable: "mini.intent.extra.TRACKING_DURATION"
  • Example:
    int value="60";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.TRACKING_DURATION",value);
EXTRA_TYPE_OF_GEOMETRY
  • A string value with the name of the type of the geometries that are going to be drawn.
  • Name of the variable: "mini.intent.extra.TYPE_OF_GEOMETRY"
  • Example:
    String value="line";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.TYPE_OF_GEOMETRY",value);
EXTRA_USER_ICON
  • A string value with the path of a .PNG. This .PNG that is located in the SD Card and symbolizes the user.
  • Name of the variable: "mini.intent.extra.USER_ICON"
  • Example:
    String value=Environment.getExternalStorageDirectory().toString()+"myapp/usericon.png";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.USER_ICON",value);
  • A string value with the location of the WMS Server
  • Name of the variable: "mini.intent.extra.WMS_SERVER_LINK"
  • Example:
    String value="http://www.cartociudad.es/wms/CA..../CARTOCIUDAD?Request=GetCapabilities&Service=WMS";
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra. WMS_SERVER_LINK",value);
EXTRA_ZOOM_LEVEL
  • An int value, between 0 and 18, that represents the map zoomlevel.
  • Name of the variable: "mini.intent.extra.ZOOM_LEVEL"
  • Example:
    Int value=7;
    Intent myIntent=new Intent();
    Intent.putExtra("mini.intent.extra.ZOOM_LEVEL",value);

Services

Broadcast actions

  • No labels