Class MapView

Definition

Namespace:
Tizen.Maps
Assembly:
Tizen.Maps.dll
API Level:
3

Map View class to show a map on the screen.

C#
Copy
public class MapView : Layout, IAccessibleObject, IDisposable
Inheritance
Implements
System.IDisposable

Constructors

View Source

MapView(EvasObject, MapService)

Creates a view and links it to the instance of a map service.

Declaration
C#
Copy
public MapView(EvasObject parent, MapService service)
Parameters
Type Name Description
EvasObject parent

An instance of EvasObject object for which a map view will be drawn.

MapService service

An instance of MapService object.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

UnauthorizedAccessException

Thrown when application does not have some privilege to access this method.

System.ArgumentException

Thrown when parameters are invalid.

InvalidOperationException

Thrown when a native operation failed to allocate memory, and connect to the service.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/mapservice

Properties

View Source

BuildingsEnabled

Indicates whether the map should show the 3D buildings layer.

Declaration
C#
Copy
public bool BuildingsEnabled { get; set; }
Property Value
Type Description
Boolean
Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

UnauthorizedAccessException

Thrown when application does not have some privilege to access this method.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/mapservicehttp://tizen.org/privilege/internethttp://tizen.org/privilege/network.get
View Source

Center

Gets or sets geographical coordinates for map view's center.

Declaration
C#
Copy
public Geocoordinates Center { get; set; }
Property Value
Type Description
Geocoordinates
Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

UnauthorizedAccessException

Thrown when application does not have some privilege to access this method.

System.ArgumentException

Thrown when the value is invalid.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/mapservicehttp://tizen.org/privilege/internethttp://tizen.org/privilege/network.get
View Source

Children

Gets a list of the map object added to map view.

Declaration
C#
Copy
public IEnumerable<MapObject> Children { get; }
Property Value
Type Description
System.Collections.Generic.IEnumerable<MapObject>
API Level: 3
View Source

Language

Sets language of map view.

Declaration
C#
Copy
public string Language { get; set; }
Property Value
Type Description
System.String

The display language in the map. A language is specified as an ISO 3166 alpha-2 two letter country-code followed by ISO 639-1 for the two-letter language code. Each language tag is composed of one or more "subtags" separated by hyphens (-). Each subtag is composed of basic Latin letters or digits only. For example, "ko-KR" for Korean, "en-US" for American English.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

UnauthorizedAccessException

Thrown when application does not have some privilege to access this method.

System.ArgumentException

Thrown when the value is invalid.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/mapservicehttp://tizen.org/privilege/internethttp://tizen.org/privilege/network.get
View Source

MapType

Gets or sets theme type of the map view.

Declaration
C#
Copy
public MapTypes MapType { get; set; }
Property Value
Type Description
MapTypes
Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

UnauthorizedAccessException

Thrown when application does not have some privilege to access this method.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/mapservicehttp://tizen.org/privilege/internethttp://tizen.org/privilege/network.get
View Source

MaximumZoomLevel

Gets or sets the maximum zoom level.

Declaration
C#
Copy
public int MaximumZoomLevel { get; set; }
Property Value
Type Description
System.Int32

It is an integer value that limits maximum zoom level within a range of the current map plug-in support.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

UnauthorizedAccessException

Thrown when application does not have some privilege to access this method.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/mapservicehttp://tizen.org/privilege/internethttp://tizen.org/privilege/network.get
View Source

MinimumZoomLevel

Gets or sets the minimum zoom level.

Declaration
C#
Copy
public int MinimumZoomLevel { get; set; }
Property Value
Type Description
System.Int32

It is an integer value that limits minimal zoom level within a range of the current map plug-in support.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

UnauthorizedAccessException

Thrown when application does not have some privilege to access this method.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/mapservicehttp://tizen.org/privilege/internethttp://tizen.org/privilege/network.get
View Source

Orientation

Gets or sets the orientation on the map view.

Declaration
C#
Copy
public double Orientation { get; set; }
Property Value
Type Description
System.Double

It is an integer value from 0 to 360 that indicates the orientation of the map view.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

UnauthorizedAccessException

Thrown when application does not have some privilege to access this method.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/mapservicehttp://tizen.org/privilege/internethttp://tizen.org/privilege/network.get
View Source

PublicTransitEnabled

Indicates whether the map should show the public transit layer.

Declaration
C#
Copy
public bool PublicTransitEnabled { get; set; }
Property Value
Type Description
Boolean
Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

UnauthorizedAccessException

Thrown when application does not have some privilege to access this method.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/mapservicehttp://tizen.org/privilege/internethttp://tizen.org/privilege/network.get
View Source

ScaleBarEnabled

Indicates whether the scale-bar is enabled or not.

Declaration
C#
Copy
public bool ScaleBarEnabled { get; set; }
Property Value
Type Description
Boolean
Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

UnauthorizedAccessException

Thrown when application does not have some privilege to access this method.

API Level: 4
Privilege Level: public
Privilege: http://tizen.org/privilege/mapservicehttp://tizen.org/privilege/internethttp://tizen.org/privilege/network.get
View Source

TrafficEnabled

Indicates whether the map should show the traffic layer.

Declaration
C#
Copy
public bool TrafficEnabled { get; set; }
Property Value
Type Description
Boolean
Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

UnauthorizedAccessException

Thrown when application does not have some privilege to access this method.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/mapservicehttp://tizen.org/privilege/internethttp://tizen.org/privilege/network.get
View Source

ZoomLevel

Gets or sets the current zoom level.

Declaration
C#
Copy
public int ZoomLevel { get; set; }
Property Value
Type Description
System.Int32

It is an integer value representing the current zoom level.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

UnauthorizedAccessException

Thrown when application does not have some privilege to access this method.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/mapservicehttp://tizen.org/privilege/internethttp://tizen.org/privilege/network.get

Methods

View Source

Add(MapObject)

Adds a map object to map view.

Declaration
C#
Copy
public void Add(MapObject child)
Parameters
Type Name Description
MapObject child

An instance of the map object to be added.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

UnauthorizedAccessException

Thrown when application does not have some privilege to access this method.

System.ArgumentException

Thrown when the value is invalid.

InvalidOperationException

Thrown when a native operation failed to allocate memory and connect to the service.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/mapservice
View Source

CaptureSnapshot(SnapshotType, Int32, String)

Captures a snapshot of the map view.

Declaration
C#
Copy
public void CaptureSnapshot(SnapshotType type, int quality, string path)
Parameters
Type Name Description
SnapshotType type

Type of file format.

System.Int32 quality

An integer value representing the quality for encoding from 1 to 100.

System.String path

A string representing the file path for a snapshot.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

UnauthorizedAccessException

Thrown when application does not have some privilege to access this method.

System.ArgumentException

Thrown when the value is invalid.

InvalidOperationException

Thrown when a native operation failed to allocate memory and connect to the service.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/mapservice
View Source

Dispose()

Releases all the resources used by this object.

Declaration
C#
Copy
public void Dispose()
API Level: 3
View Source

Dispose(Boolean)

Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.

Declaration
C#
Copy
protected virtual void Dispose(bool disposing)
Parameters
Type Name Description
Boolean disposing

If true, managed and unmanaged resources can be disposed, otherwise only unmanaged resources can be disposed.

API Level: 3
View Source

Finalize()

Destroy the MapView object.

Declaration
C#
Copy
protected void Finalize()
View Source

GeolocationToScreen(Geocoordinates)

Changes the geographical coordinates to screen coordinates.

Declaration
C#
Copy
public Point GeolocationToScreen(Geocoordinates coordinates)
Parameters
Type Name Description
Geocoordinates coordinates

Geographical coordinates.

Returns
Type Description
Point

Returns an instance of the screen coordinates on the current screen.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

UnauthorizedAccessException

Thrown when application does not have some privilege to access this method.

System.ArgumentException

Thrown when the value is invalid.

InvalidOperationException

Thrown when a native operation failed to allocate memory and connect to the service.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/mapservice
View Source

Remove(MapObject)

Removes a map object from the map view.

Declaration
C#
Copy
public void Remove(MapObject child)
Parameters
Type Name Description
MapObject child

An instance of the map object to be removed.

Remarks

Once removed, the child object will be become invalid.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

UnauthorizedAccessException

Thrown when application does not have some privilege to access this method.

System.ArgumentException

Thrown when the value is invalid.

InvalidOperationException

Thrown when native operation failed to allocate memory and connect to the service.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/mapservice
View Source

RemoveAll()

Removes all map objects from the map view.

Declaration
C#
Copy
public void RemoveAll()
Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

UnauthorizedAccessException

Thrown when application does not have some privilege to access this method.

InvalidOperationException

Thrown when a native operation failed to allocate memory and connect to the service.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/mapservice
View Source

ScreenToGeolocation(Point)

Changes the screen coordinates to geographical coordinates.

Declaration
C#
Copy
public Geocoordinates ScreenToGeolocation(Point screenCoordinates)
Parameters
Type Name Description
Point screenCoordinates

Screen coordinates.

Returns
Type Description
Geocoordinates

Returns an instance of the geographical coordinates object.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

UnauthorizedAccessException

Thrown when application does not have some privilege to access this method.

System.ArgumentException

Thrown when the value is invalid.

InvalidOperationException

Thrown when a native operation failed to allocate memory and connect to the service.

API Level: 3
Privilege Level: public
Privilege: http://tizen.org/privilege/mapservice

Events

View Source

Clicked

Adds or removes event handlers to deliver a clicked gesture event.

Declaration
C#
Copy
public event EventHandler<MapGestureEventArgs> Clicked
Event Type
Type Description
System.EventHandler<MapGestureEventArgs>

Event handlers to get a clicked gesture event.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

API Level: 3
View Source

DoubleClicked

Adds or removes event handlers to deliver a double-clicked gesture event.

Declaration
C#
Copy
public event EventHandler<MapGestureEventArgs> DoubleClicked
Event Type
Type Description
System.EventHandler<MapGestureEventArgs>

Event handlers to get a double-clicked gesture event.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

API Level: 3
View Source

LongPressed

Adds or removes event handlers to deliver a long-pressed gesture event.

Declaration
C#
Copy
public event EventHandler<MapGestureEventArgs> LongPressed
Event Type
Type Description
System.EventHandler<MapGestureEventArgs>

Event handlers to get a long-pressed gesture event.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

API Level: 3
View Source

Scrolled

Adds or removes event handlers to deliver a scrolled gesture event.

Declaration
C#
Copy
public event EventHandler<MapGestureEventArgs> Scrolled
Event Type
Type Description
System.EventHandler<MapGestureEventArgs>

Event handlers to get a scrolled gesture event.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

API Level: 3
View Source

TwoFingerClicked

Adds or removes event handlers to deliver a clicked gesture event with two-fingers.

Declaration
C#
Copy
public event EventHandler<MapGestureEventArgs> TwoFingerClicked
Event Type
Type Description
System.EventHandler<MapGestureEventArgs>

Event handlers to get a clicked gesture event.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

API Level: 3
View Source

TwoFingerRotated

Adds or removes event handlers to deliver a rotated gesture event.

Declaration
C#
Copy
public event EventHandler<MapGestureEventArgs> TwoFingerRotated
Event Type
Type Description
System.EventHandler<MapGestureEventArgs>

Event handlers to get a rotated gesture event.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

API Level: 3
View Source

TwoFingerZoomed

Adds or removes event handlers to deliver a zoomed gesture event.

Declaration
C#
Copy
public event EventHandler<MapGestureEventArgs> TwoFingerZoomed
Event Type
Type Description
System.EventHandler<MapGestureEventArgs>

Event handlers to get a zoomed gesture event.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

API Level: 3
View Source

ViewReady

Adds or removes event handlers to deliver an event representing a view ready to be used.

Declaration
C#
Copy
public event EventHandler ViewReady
Event Type
Type Description
EventHandler

Event handlers to get a view ready event.

Exceptions
Type Condition
System.NotSupportedException

Thrown when the required feature is not supported.

API Level: 3

Implements

System.IDisposable

Extension Methods