namespace Tizen.Maps
{
/// <summary>
- /// Class representing geographical area
+ /// The class representing a geographical area.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class Area : IDisposable
{
internal Interop.AreaHandle handle;
/// <summary>
- /// Constructs rectangular area.
+ /// Constructs a rectangular area.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="topLeft">Top-left coordinates of the area</param>
- /// <param name="bottomRight">Bottom-left coordinate of the area</param>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="topLeft">Top-left coordinates of the area.</param>
+ /// <param name="bottomRight">Bottom-left coordinates of the area.</param>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
- /// <exception cref="System.ArgumentException">Thrown when input coordinates are invalid</exception>
- /// <exception cref="System.InvalidOperationException">Thrown when native operation failed to allocate memory.</exception>
+ /// <exception cref="System.ArgumentException">Thrown when input coordinates are invalid.</exception>
+ /// <exception cref="System.InvalidOperationException">Thrown when a native operation fails to allocate memory.</exception>
public Area(Geocoordinates topLeft, Geocoordinates bottomRight)
{
handle = new Interop.AreaHandle(topLeft?.handle, bottomRight?.handle);
}
/// <summary>
- /// Constructs circular area.
+ /// Constructs a circular area.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="center">Coordinates for center of the area</param>
- /// <param name="radius">Radius of the area</param>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="center">Coordinates for center of the area.</param>
+ /// <param name="radius">Radius of the area.</param>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
- /// <exception cref="System.ArgumentException">Thrown when input coordinates are invalid</exception>
- /// <exception cref="System.InvalidOperationException">Thrown when native operation failed to allocate memory.</exception>
+ /// <exception cref="System.ArgumentException">Thrown when input coordinates are invalid.</exception>
+ /// <exception cref="System.InvalidOperationException">Thrown when a native operation fails to allocate memory.</exception>
public Area(Geocoordinates center, double radius)
{
handle = new Interop.AreaHandle(center?.handle, radius);
}
/// <summary>
- /// Releases all resources used by this object.
+ /// Releases all the resources used by this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public void Dispose()
{
Dispose(true);
namespace Tizen.Maps
{
/// <summary>
- /// Direction types for route maneuver
+ /// The direction types for route maneuver.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public enum DirectionType
{
/// <summary>
- /// Indicates unknown direction.
+ /// Indicates an unknown direction.
/// </summary>
None = Interop.RouteDirection.None,
/// <summary>
- /// Indicates north direction.
+ /// Indicates the North direction.
/// </summary>
North = Interop.RouteDirection.North,
/// <summary>
- /// Indicates north-west direction.
+ /// Indicates the Northwest direction.
/// </summary>
NorthWest = Interop.RouteDirection.NorthWest,
/// <summary>
- /// Indicates north-east direction.
+ /// Indicates the Northeast direction.
/// </summary>
NorthEast = Interop.RouteDirection.NorthEast,
/// <summary>
- /// Indicates south direction.
+ /// Indicates the South direction.
/// </summary>
South = Interop.RouteDirection.South,
/// <summary>
- /// Indicates south-East direction.
+ /// Indicates the Southeast direction.
/// </summary>
SouthEast = Interop.RouteDirection.SouthEast,
/// <summary>
- /// Indicates south-West direction.
+ /// Indicates the Southwest direction.
/// </summary>
SouthWest = Interop.RouteDirection.SouthWest,
/// <summary>
- /// Indicates west direction.
+ /// Indicates the West direction.
/// </summary>
West = Interop.RouteDirection.West,
/// <summary>
- /// Indicates east direction.
+ /// Indicates the East direction.
/// </summary>
East = Interop.RouteDirection.East,
}
namespace Tizen.Maps
{
/// <summary>
- /// Allowed distance units
+ /// The allowed distance units.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public enum DistanceUnit
{
/// <summary>
namespace Tizen.Maps
{
/// <summary>
- /// Geocode request for map service
+ /// Geocode request for the map service.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class GeocodeRequest : MapServiceRequest<Geocoordinates>
{
private Interop.GeocodeCallback _geocodeCallback;
}
else
{
- // If search is failed, the value of total is 0 and coordinates is NULL
+ // If the search fails, the value of total is 0 and coordinates is NULL.
_requestTask?.TrySetException(result.GetException(errMessage));
return false;
}
namespace Tizen.Maps
{
/// <summary>
- /// Class representing geographical coordinates.
+ /// A class representing geographical coordinates.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class Geocoordinates : IDisposable
{
internal Interop.CoordinatesHandle handle;
/// <summary>
- /// Constructs map coordinates object.
+ /// Constructs the map coordinates object.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="latitude">Latitude value, must be between (-90.0 ~ 90.0) degrees</param>
- /// <param name="longitude">Longitude value, must be between (-180.0 ~ 180.0) degrees</param>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="latitude">Latitude value must be between (-90.0 ~ 90.0) degrees.</param>
+ /// <param name="longitude">Longitude value must be between (-180.0 ~ 180.0) degrees.</param>
/// <exception cref="System.ArgumentException">Thrown when values for latitude and longitude are not valid.</exception>
- /// <exception cref="System.InvalidOperationException">Thrown when native operation failed to allocate memory.</exception>
+ /// <exception cref="System.InvalidOperationException">Thrown when a native operation fails to allocate memory.</exception>
public Geocoordinates(double latitude, double longitude)
{
handle = new Interop.CoordinatesHandle(latitude, longitude);
}
/// <summary>
- /// Gets latitude of the coordinates.
+ /// Gets the latitude coordinates.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public double Latitude
{
get
}
/// <summary>
- /// Gets longitude of the coordinates.
+ /// Gets the longitude coordinates.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public double Longitude
{
get
/// <summary>
/// Returns a string that represents this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <returns>Returns a string which presents this object.</returns>
+ /// <since_tizen> 3 </since_tizen>
+ /// <returns>Returns a string that represents this object.</returns>
public override string ToString()
{
return $"[{Latitude}, {Longitude}]";
}
/// <summary>
- /// Releases all resources used by this object.
+ /// Releases all the resources used by this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public void Dispose()
{
Dispose(true);
namespace Tizen.Maps
{
/// <summary>
- /// List of <see cref="Geocoordinates"/> objects to be used in <see cref="MapService"/> APIs
+ /// List of <see cref="Geocoordinates"/> objects to be used in <see cref="MapService"/> APIs.
/// </summary>
internal class GeocoordinatesList : IDisposable
{
}
/// <summary>
- /// Iterator for coordinates in this list
+ /// The iterator for coordinates in this list.
/// </summary>
internal IEnumerable<Geocoordinates> Coordinates
{
}
/// <summary>
- /// Releases all resources used by this object.
+ /// Releases all the resources used by this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public void Dispose()
{
Dispose(true);
namespace Tizen.Maps
{
/// <summary>
- /// Enumeration of user gestures over map view
+ /// Enumeration for the user gesture over a map view.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public enum GestureType
{
/// <summary>
- /// Indicates empty gesture.
+ /// Indicates the empty gesture.
/// </summary>
None = Interop.ViewGesture.None,
/// <summary>
/// </summary>
Zoom = Interop.ViewGesture.Zoom,
/// <summary>
- /// Indicates the click user gesture
+ /// Indicates the click user gesture.
/// </summary>
Click = Interop.ViewGesture.Click,
/// <summary>
- /// Indicates the double click user gesture
+ /// Indicates the double click user gesture.
/// </summary>
DoubleClick = Interop.ViewGesture.DoubleClick,
/// <summary>
- /// Indicates the two-finger click user gesture
+ /// Indicates the two-finger click user gesture.
/// </summary>
TwoFingerClick = Interop.ViewGesture.TwoFingerClick,
/// <summary>
namespace Tizen.Maps
{
/// <summary>
- /// Preferences for geocode searches
+ /// The preference for geocode searches.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public interface IGeocodePreference
{
/// <summary>
- /// Gets or sets a string that presents preferred language.
+ /// Gets or sets a string that presents the preferred language.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <remarks>Language should be specified as an ISO 3166 alpha-2 two letter country-code
+ /// <since_tizen> 3 </since_tizen>
+ /// <remarks>Language should be specified as an ISO 3166 alpha-2 two-letter country-code
/// followed by ISO 639-1 for the two-letter language code.<br/>e.g. "ko-KR", "en-US".</remarks>
string Language { get; set; }
/// <summary>
/// Gets or sets the maximum number of results.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <remarks>Setting negative value will not have any effect on MaxResults value.</remarks>
+ /// <since_tizen> 3 </since_tizen>
+ /// <remarks>Setting a negative value will not have any effect on MaxResults value.</remarks>
int MaxResults { get; set; }
}
}
namespace Tizen.Maps
{
/// <summary>
- /// Preferences for place searches
+ /// The preferences for a place search.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public interface IPlaceSearchPreference
{
/// <summary>
- /// Gets or sets distance unit.
+ /// Gets or sets the distance unit.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
DistanceUnit Unit { get; set; }
/// <summary>
- /// Gets or sets preferred language.
+ /// Gets or sets the preferred language.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <remarks>Language should be specified as an ISO 3166 alpha-2 two letter country-code
/// followed by ISO 639-1 for the two-letter language code.<br/>e.g. "ko-KR", "en-US".</remarks>
string Language { get; set; }
/// <summary>
/// Gets or sets the maximum number of results.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
int MaxResults { get; set; }
/// <summary>
- /// Gets or sets a string that represents code of preferred country.
+ /// Gets or sets a string that represents the code of a preferred country.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
string CountryCode { get; set; }
/// <summary>
- /// Gets or sets search properties as key value pair.
+ /// Gets or sets the search properties as a key value pair.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
IReadOnlyDictionary<string, string> Properties { get; set; }
}
}
namespace Tizen.Maps
{
/// <summary>
- /// Preferences for route searches
+ /// The preferences for route search.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public interface IRouteSearchPreference
{
/// <summary>
- /// Gets or sets distance unit.
+ /// Gets or sets the distance unit.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
DistanceUnit Unit { get; set; }
/// <summary>
- /// Gets or sets route optimization.
+ /// Gets or sets the route optimization.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
RouteOptimization Optimization { get; set; }
/// <summary>
- /// Gets or sets route transport mode.
+ /// Gets or sets the route transport mode.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
TransportMode Mode { get; set; }
/// <summary>
- /// Gets or sets route feature weight.
+ /// Gets or sets the route feature weight.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
RouteFeatureWeight RouteFeatureWeight { get; set; }
/// <summary>
- /// Gets or sets route feature.
+ /// Gets or sets the route feature.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
RouteFeature RouteFeature { get; set; }
/// <summary>
- /// Gets or sets if searching for alternative routes is enabled.
+ /// Gets or sets if a search for alternative routes is enabled.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
bool SearchAlternativeRoutes { get; set; }
}
}
namespace Tizen.Maps
{
/// <summary>
- /// Event arguments for gesture type map events
+ /// Event arguments for gesture type map events.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class MapGestureEventArgs : EventArgs
{
internal MapGestureEventArgs(IntPtr nativeHandle)
}
/// <summary>
- /// Gets type of gesture event.
+ /// Gets the type of gesture event.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public GestureType GestureType { get; }
/// <summary>
/// Gets screen coordinates in the event.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public Point Position { get; }
/// <summary>
/// Gets the number of fingers detected in the event.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public int TouchCount { get; }
/// <summary>
- /// Gets zoom factor for zoom gesture event.
+ /// Gets the zoom factor for zoom gesture event.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public double ZoomFactor { get; }
/// <summary>
- /// Gets angle of rotation for rotate gesture event.
+ /// Gets the angle of rotation for rotate gesture event.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public double RotationAngle { get; }
/// <summary>
- /// Gets geographical coordinates for the event.
+ /// Gets the geographical coordinates for the event.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public Geocoordinates Geocoordinates { get; }
}
}
namespace Tizen.Maps
{
/// <summary>
- /// Map object
+ /// The map object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public abstract class MapObject
{
internal MapObject() { }
/// <summary>
/// Gets or sets visibility of the map object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public abstract bool IsVisible { get; set; }
internal abstract void HandleClickedEvent();
namespace Tizen.Maps
{
/// <summary>
- /// Map service class for service request
+ /// Map service class for service request.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public partial class MapService : IDisposable
{
internal Interop.ServiceHandle handle;
/// <summary>
- /// Creates a new Maps Service object for given service provider.
+ /// Creates a new maps service object for given service provider.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="serviceProvider">A string which representing name of map service provider</param>
- /// <param name="serviceProviderKey">A string which representing certificate key to use the map service provider</param>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="serviceProvider">A string representing the name of the map service provider.</param>
+ /// <param name="serviceProviderKey">A string representing a certificate key to use the map service provider.</param>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <privilege>http://tizen.org/privilege/network.get</privilege>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
/// <exception cref="System.ArgumentException">Thrown when parameters are invalid.</exception>
- /// <exception cref="System.InvalidOperationException">Thrown when native operation failed to allocate memory, connect to service.</exception>
+ /// <exception cref="System.InvalidOperationException">Thrown when a native operation failed to allocate memory and connect to the service.</exception>
/// <exception cref="System.UnauthorizedAccessException">Thrown when application does not have some privilege to access this method.</exception>
public MapService(string serviceProvider, string serviceProviderKey)
{
}
/// <summary>
- /// Gets list of available map service providers.
+ /// Gets the list of available map service providers.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <value>The list of map service providers.</value>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
- /// <exception cref="System.UnauthorizedAccessException">Thrown when application does not have privileges to access this property.</exception>
+ /// <exception cref="System.UnauthorizedAccessException">Thrown when application does not have privilege to access this property.</exception>
public static IEnumerable<string> Providers
{
get
}
/// <summary>
- /// Gets name of map service provider.
+ /// Gets the name of the map service provider.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Provider { get { return _serviceProvider; } }
/// <summary>
- /// Gets a user consent for map service provider
+ /// Gets a user consent for the map service provider
/// </summary>
/// <since_tizen> 3 </since_tizen>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
}
/// <summary>
- /// Gets and sets a string representing keys for map service provider
+ /// Gets and sets a string representing keys for the map service provider.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <remarks>Typically, the provider key is issued by each maps provider, after signing up for a plan in the web site.
- /// Depending on the plan and its provider which you have signed, you might pay for the network traffic.</remarks>
+ /// <since_tizen> 3 </since_tizen>
+ /// <remarks>Typically, the provider key is issued by each maps provider after signing up for a plan in the website.
+ /// Depending on the plan and its provider which you have signed, you might have to pay for the network traffic.</remarks>
public string ProviderKey
{
get
}
/// <summary>
- /// Gets and sets a filter used for place search result.
+ /// Gets and sets a filter used for the place search result.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public PlaceFilter PlaceSearchFilter
{
get
}
/// <summary>
- /// Gets search preferences used for <see cref="GeocodeRequest"/> or <see cref="ReverseGeocodeRequest"/>.
+ /// Gets the search preferences used for <see cref="GeocodeRequest"/> or <see cref="ReverseGeocodeRequest"/>.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public IGeocodePreference GeocodePreferences
{
get
}
/// <summary>
- /// Gets search preferences used for <see cref="PlaceSearchRequest"/>.
+ /// Gets the search preferences used for <see cref="PlaceSearchRequest"/>.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public IPlaceSearchPreference PlaceSearchPreferences
{
get
}
/// <summary>
- /// Gets search preferences used for <see cref="RouteSearchRequest"/>.
+ /// Gets the search preferences used for <see cref="RouteSearchRequest"/>.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public IRouteSearchPreference RouteSearchPreferences
{
get
}
/// <summary>
- /// Gets and sets search preferences.
+ /// Gets and sets the search preferences.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public SearchPreference Preferences
{
get
}
/// <summary>
- /// Checks if the Maps Service supports given request.
+ /// Checks if the maps service supports the given request.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <param name="type">Request type to check</param>
- /// <returns>Returns true if the Maps Service supports a request, otherwise false.</returns>
+ /// <returns>Returns true if the maps service supports a request, otherwise false.</returns>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
/// <exception cref="System.UnauthorizedAccessException">Thrown when application does not have some privilege to access this method.</exception>
}
/// <summary>
- /// Checks if the Maps Service supports given data feature.
+ /// Checks if the maps service supports a given data feature.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="data">Data feature to check</param>
- /// <returns>Returns true if the Maps Service supports a data feature, otherwise false.</returns>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="data">Data feature to check.</param>
+ /// <returns>Returns true if the maps service supports a data feature, otherwise false.</returns>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
/// <exception cref="System.UnauthorizedAccessException">Thrown when application does not have some privilege to access this method.</exception>
}
/// <summary>
- /// Creates geocode search request for given free-formed address string.
+ /// Creates a geocode search request for the given free-formed address string.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="address">A string which representing free-formed address</param>
- /// <returns>GeocodeRequest object created with address string</returns>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="address">A string representing free-formed address.</param>
+ /// <returns>Returns a GeocodeRequest object created with an address string.</returns>
public GeocodeRequest CreateGeocodeRequest(string address)
{
return new GeocodeRequest(this, address);
}
/// <summary>
- /// Creates geocode search request for given free-formed address string, within the specified boundary.
+ /// Creates a geocode search request for the given free-formed address string, within the specified boundary.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="address">A string which representing free-formed address</param>
- /// <param name="boundary">An instance of Area object which representing interested area</param>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="address">A string representing the free-formed address.</param>
+ /// <param name="boundary">An instance of Area object representing the interested area.</param>
/// <seealso cref="Area"/>
- /// <returns>GeocodeRequest object created with address string and specified boundary</returns>
+ /// <returns>Returns a GeocodeRequest object created with an address string and a specified boundary.</returns>
public GeocodeRequest CreateGeocodeRequest(string address, Area boundary)
{
return new GeocodeRequest(this, address, boundary);
}
/// <summary>
- /// Creates geocode search request for given structured address.
+ /// Creates a geocode search request for the given structured address.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="address">A string which representing address of interest</param>
- /// <returns>Returns GeocodeRequest object created with structured address</returns>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="address">A string representing the address of interest.</param>
+ /// <returns>Returns a GeocodeRequest object created with a structured address.</returns>
public GeocodeRequest CreateGeocodeRequest(PlaceAddress address)
{
return new GeocodeRequest(this, address);
}
/// <summary>
- /// Creates a reverse geocode search request for given latitude and longitude.
+ /// Creates a reverse geocode search request for the given latitude and longitude.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="latitude">Latitude of interested place</param>
- /// <param name="longitude">Longitude of interested place</param>
- /// <returns>Returns ReverseGeocodeRequest object created with location coordinates</returns>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="latitude">Latitude of the interested place.</param>
+ /// <param name="longitude">Longitude of the interested place.</param>
+ /// <returns>Returns a ReverseGeocodeRequest object created with the location coordinates.</returns>
public ReverseGeocodeRequest CreateReverseGeocodeRequest(double latitude, double longitude)
{
return new ReverseGeocodeRequest(this, latitude, longitude);
}
/// <summary>
- /// Creates a reverse geocode search request for given position coordinates list.
+ /// Creates a reverse geocode search request for the given position coordinates list.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="coordinates">Coordinates list with [2 ~ 100] coordinates</param>
- /// <returns>Returns MultiReverseGeocodeRequest object created with list of location coordinates</returns>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="coordinates">Coordinates list with [2 ~ 100] coordinates.</param>
+ /// <returns>Returns a MultiReverseGeocodeRequest object created with a list of location coordinates.</returns>
public MultiReverseGeocodeRequest CreateMultiReverseGeocodeRequest(IEnumerable<Geocoordinates> coordinates)
{
return new MultiReverseGeocodeRequest(this, coordinates);
}
/// <summary>
- /// Creates a route search request for origin and destination points.
+ /// Creates a route search request for the origin and destination points.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="from">Starting point</param>
- /// <param name="to">Destination</param>
- /// <returns>Returns RouteSearchRequest object created with origin and destination coordinates</returns>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="from">Starting point.</param>
+ /// <param name="to">Destination.</param>
+ /// <returns>Returns a RouteSearchRequest object created with the origin and destination coordinates.</returns>
public RouteSearchRequest CreateRouteSearchRequest(Geocoordinates from, Geocoordinates to)
{
return new RouteSearchRequest(this, from, to);
}
/// <summary>
- /// Creates a place search request for specified search radius around a given coordinates position.
+ /// Creates a place search request for a specified search radius around a given coordinates position.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="coordinates">A geographical coordinates of center</param>
- /// <param name="distance">A double value which representing radius of area to search places</param>
- /// <returns>Returns PlaceSearchRequest object created with location coordinates and search radius</returns>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="coordinates">Geographical coordinates of the center.</param>
+ /// <param name="distance">A double value representing the radius of an area to search places.</param>
+ /// <returns>Returns a PlaceSearchRequest object created with the location coordinates and search radius.</returns>
public PlaceSearchRequest CreatePlaceSearchRequest(Geocoordinates coordinates, int distance)
{
return new PlaceSearchRequest(this, coordinates, distance);
}
/// <summary>
- /// Creates a place search request for places within specified boundary.
+ /// Creates a place search request for places within a specified boundary.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="boundary">An instance of Area object which representing area to search interested places</param>
- /// <returns>Returns PlaceSearchRequest object created with specified boundary</returns>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="boundary">An instance of Area object representing and area to search interested places.</param>
+ /// <returns>Returns a PlaceSearchRequest object created with a specified boundary.</returns>
public PlaceSearchRequest CreatePlaceSearchRequest(Area boundary)
{
return new PlaceSearchRequest(this, boundary);
}
/// <summary>
- /// Creates a place search request for free-formed address within boundary.
+ /// Creates a place search request for a free-formed address within the boundary.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="address">A string which representing free-formed address</param>
- /// <param name="boundary">An instance of Area object which representing area to search interested places</param>
- /// <returns>Returns PlaceSearchRequest object created with address string and specified boundary</returns>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="address">A string which represents a free-formed address.</param>
+ /// <param name="boundary">An instance of area object representing an area to search interested places.</param>
+ /// <returns>Returns a PlaceSearchRequest object created with an address string and a specified boundary.</returns>
public PlaceSearchRequest CreatePlaceSearchRequest(string address, Area boundary)
{
return new PlaceSearchRequest(this, address, boundary);
}
/// <summary>
- /// Releases all resources used by this object.
+ /// Releases all the resources used by this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public void Dispose()
{
Dispose(true);
namespace Tizen.Maps
{
/// <summary>
- /// Base class for map service request
+ /// Base class for a map service request.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <typeparam name="T"></typeparam>
public abstract class MapServiceRequest<T> : IDisposable
{
/// <summary>
/// Creates a map service request.
/// </summary>
- /// <param name="service">map service object</param>
- /// <param name="type">Request type</param>
+ /// <param name="service">Map service object.</param>
+ /// <param name="type">Request type.</param>
internal MapServiceRequest(MapService service, ServiceRequestType type)
{
_service = service;
}
/// <summary>
- /// Sends a request to map service provider.
+ /// Sends a request to the map service provider.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <returns>Response from map service provider</returns>
+ /// <since_tizen> 3 </since_tizen>
+ /// <returns>Response from the map service provider.</returns>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <privilege>http://tizen.org/privilege/internet</privilege>
/// <privilege>http://tizen.org/privilege/network.get</privilege>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
/// <exception cref="System.UnauthorizedAccessException">Thrown when application does not have some privilege to access this method.</exception>
/// <exception cref="System.InvalidOperationException">Thrown when the result is invalid.</exception>
- /// <exception cref="System.ArgumentException">Thrown when arguments are invalid</exception>
+ /// <exception cref="System.ArgumentException">Thrown when arguments are invalid.</exception>
public async Task<IEnumerable<T>> GetResponseAsync()
{
IEnumerable<T> task = null;
}
/// <summary>
- /// Releases all resources used by this object.
+ /// Releases all the resources used by this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public void Dispose()
{
Dispose(true);
namespace Tizen.Maps
{
/// <summary>
- /// Map View Type (theme)
+ /// The map view type (theme).
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public enum MapTypes
{
/// <summary>
- /// Indicates normal street theme.
+ /// Indicates the normal street theme.
/// </summary>
Normal = Interop.ViewType.Normal,
/// <summary>
- /// Indicates satellite theme.
+ /// Indicates the satellite theme.
/// </summary>
Satellite = Interop.ViewType.Satellite,
/// <summary>
- /// Indicates terrain theme.
+ /// Indicates the terrain theme.
/// </summary>
Terrain = Interop.ViewType.Terrain,
/// <summary>
- /// Indicates hybrid theme, has both satellite and normal theme.
+ /// Indicates the hybrid theme that has both satellite and normal theme.
/// </summary>
Hybrid = Interop.ViewType.Hybrid,
}
/// <summary>
/// Map View class to show a map on the screen.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class MapView : Layout, IDisposable
{
internal Interop.ViewHandle handle;
private event EventHandler _viewReadyEventHandler;
/// <summary>
- /// Creates the view and link it to the instance of map service.
+ /// Creates a view and links it to the instance of a map service.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="parent">An instance of <see cref="EvasObject"/> object which map view will be drawn</param>
- /// <param name="service">An instance of <see cref="MapService"/> object</param>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="parent">An instance of <see cref="EvasObject"/> object for which a map view will be drawn.</param>
+ /// <param name="service">An instance of <see cref="MapService"/> object.</param>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
/// <exception cref="System.UnauthorizedAccessException">Thrown when application does not have some privilege to access this method.</exception>
- /// <exception cref="System.ArgumentException">Thrown when parameters are invalid</exception>
- /// <exception cref="System.InvalidOperationException">Thrown when native operation failed to allocate memory, connect to service</exception>
+ /// <exception cref="System.ArgumentException">Thrown when parameters are invalid.</exception>
+ /// <exception cref="System.InvalidOperationException">Thrown when a native operation failed to allocate memory, and connect to the service.</exception>
public MapView(EvasObject parent, MapService service) : base(parent)
{
handle = new Interop.ViewHandle(service.handle, this);
}
/// <summary>
- /// Adds or removes event handlers to deliver scrolled gesture event.
+ /// Adds or removes event handlers to deliver a scrolled gesture event.
/// </summary>
- /// <value>Event handlers to get scrolled gesture event</value>
- /// <since_tizen>3</since_tizen>
+ /// <value>Event handlers to get a scrolled gesture event.</value>
+ /// <since_tizen> 3 </since_tizen>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
public event EventHandler<MapGestureEventArgs> Scrolled
{
}
/// <summary>
- /// Adds or removes event handlers to deliver zoomed gesture event.
+ /// Adds or removes event handlers to deliver a zoomed gesture event.
/// </summary>
- /// <value>Event handlers to get zoomed gesture event</value>
- /// <since_tizen>3</since_tizen>
+ /// <value>Event handlers to get a zoomed gesture event.</value>
+ /// <since_tizen> 3 </since_tizen>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
public event EventHandler<MapGestureEventArgs> TwoFingerZoomed
{
}
/// <summary>
- /// Adds or removes event handlers to deliver clicked gesture event.
+ /// Adds or removes event handlers to deliver a clicked gesture event.
/// </summary>
- /// <value>Event handlers to get clicked gesture event</value>
- /// <since_tizen>3</since_tizen>
+ /// <value>Event handlers to get a clicked gesture event.</value>
+ /// <since_tizen> 3 </since_tizen>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
public event EventHandler<MapGestureEventArgs> Clicked
{
}
/// <summary>
- /// Adds or removes event handlers to deliver double-clicked gesture event.
+ /// Adds or removes event handlers to deliver a double-clicked gesture event.
/// </summary>
- /// <value>Event handlers to get double-clicked gesture event</value>
- /// <since_tizen>3</since_tizen>
+ /// <value>Event handlers to get a double-clicked gesture event.</value>
+ /// <since_tizen> 3 </since_tizen>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
public event EventHandler<MapGestureEventArgs> DoubleClicked
{
}
/// <summary>
- /// Adds or removes event handlers to deliver clicked gesture event with two-fingers.
+ /// Adds or removes event handlers to deliver a clicked gesture event with two-fingers.
/// </summary>
- /// <value>Event handlers to get clicked gesture event</value>
- /// <since_tizen>3</since_tizen>
+ /// <value>Event handlers to get a clicked gesture event.</value>
+ /// <since_tizen> 3 </since_tizen>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
public event EventHandler<MapGestureEventArgs> TwoFingerClicked
{
}
/// <summary>
- /// Adds or removes event handlers to deliver rotated gesture event.
+ /// Adds or removes event handlers to deliver a rotated gesture event.
/// </summary>
- /// <value>Event handlers to get rotated gesture event</value>
- /// <since_tizen>3</since_tizen>
+ /// <value>Event handlers to get a rotated gesture event.</value>
+ /// <since_tizen> 3 </since_tizen>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
public event EventHandler<MapGestureEventArgs> TwoFingerRotated
{
/// <summary>
- /// Adds or removes event handlers to deliver long-pressed gesture event.
+ /// Adds or removes event handlers to deliver a long-pressed gesture event.
/// </summary>
- /// <value>Event handlers to get long-pressed gesture event</value>
- /// <since_tizen>3</since_tizen>
+ /// <value>Event handlers to get a long-pressed gesture event.</value>
+ /// <since_tizen> 3 </since_tizen>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
public event EventHandler<MapGestureEventArgs> LongPressed
{
}
/// <summary>
- /// Adds or removes event handlers to deliver a event representing the view is ready to be used.
+ /// Adds or removes event handlers to deliver an event representing a view ready to be used.
/// </summary>
- /// <value>Event handlers to get view ready event</value>
- /// <since_tizen>3</since_tizen>
+ /// <value>Event handlers to get a view ready event.</value>
+ /// <since_tizen> 3 </since_tizen>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
public event EventHandler ViewReady
{
}
/// <summary>
- /// Gets or sets current zoom level.
+ /// Gets or sets the current zoom level.
/// </summary>
- /// <value>It is an integer value that representing current zoom level.</value>
- /// <since_tizen>3</since_tizen>
+ /// <value>It is an integer value representing the current zoom level.</value>
+ /// <since_tizen> 3 </since_tizen>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <privilege>http://tizen.org/privilege/internet</privilege>
/// <privilege>http://tizen.org/privilege/network.get</privilege>
}
/// <summary>
- /// Gets or sets minimum zoom level.
+ /// Gets or sets the minimum zoom level.
/// </summary>
- /// <value>It is an integer value that limits minimal zoom level within range of current map plug-in supported.</value>
- /// <since_tizen>3</since_tizen>
+ /// <value>It is an integer value that limits minimal zoom level within a range of the current map plug-in support.</value>
+ /// <since_tizen> 3 </since_tizen>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <privilege>http://tizen.org/privilege/internet</privilege>
/// <privilege>http://tizen.org/privilege/network.get</privilege>
}
/// <summary>
- /// Gets or sets maximum zoom level.
+ /// Gets or sets the maximum zoom level.
/// </summary>
- /// <value>It is an integer value that limits maximum zoom level within range of current map plug-in supported.</value>
- /// <since_tizen>3</since_tizen>
+ /// <value>It is an integer value that limits maximum zoom level within a range of the current map plug-in support.</value>
+ /// <since_tizen> 3 </since_tizen>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <privilege>http://tizen.org/privilege/internet</privilege>
/// <privilege>http://tizen.org/privilege/network.get</privilege>
}
/// <summary>
- /// Gets or sets orientation on the map view.
+ /// Gets or sets the orientation on the map view.
/// </summary>
- /// <value>It is an integer value from 0 to 360 that indicates orientation of the map view</value>
- /// <since_tizen>3</since_tizen>
+ /// <value>It is an integer value from 0 to 360 that indicates the orientation of the map view.</value>
+ /// <since_tizen> 3 </since_tizen>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <privilege>http://tizen.org/privilege/internet</privilege>
/// <privilege>http://tizen.org/privilege/network.get</privilege>
/// <summary>
/// Gets or sets theme type of the map view.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <privilege>http://tizen.org/privilege/internet</privilege>
/// <privilege>http://tizen.org/privilege/network.get</privilege>
/// <summary>
/// Indicates whether the map should show the 3D buildings layer.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <privilege>http://tizen.org/privilege/internet</privilege>
/// <privilege>http://tizen.org/privilege/network.get</privilege>
/// <summary>
/// Indicates whether the map should show the traffic layer.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <privilege>http://tizen.org/privilege/internet</privilege>
/// <privilege>http://tizen.org/privilege/network.get</privilege>
/// <summary>
/// Indicates whether the map should show the public transit layer.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <privilege>http://tizen.org/privilege/internet</privilege>
/// <privilege>http://tizen.org/privilege/network.get</privilege>
/// <summary>
/// Indicates whether the scale-bar is enabled or not.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <privilege>http://tizen.org/privilege/internet</privilege>
/// <privilege>http://tizen.org/privilege/network.get</privilege>
/// 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.</value>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <privilege>http://tizen.org/privilege/internet</privilege>
/// <privilege>http://tizen.org/privilege/network.get</privilege>
/// <summary>
/// Gets or sets geographical coordinates for map view's center.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <privilege>http://tizen.org/privilege/internet</privilege>
/// <privilege>http://tizen.org/privilege/network.get</privilege>
}
/// <summary>
- /// Gets a list of map object added to map view.
+ /// Gets a list of the map object added to map view.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public IEnumerable<MapObject> Children
{
get
}
/// <summary>
- /// Changes geographical coordinates to screen coordinates.
+ /// Changes the geographical coordinates to screen coordinates.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="coordinates">Geographical coordinates</param>
- /// <returns>Returns an instance of screen coordinates on the current screen</returns>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="coordinates">Geographical coordinates.</param>
+ /// <returns>Returns an instance of the screen coordinates on the current screen.</returns>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
/// <exception cref="System.UnauthorizedAccessException">Thrown when application does not have some privilege to access this method.</exception>
/// <exception cref="System.ArgumentException">Thrown when the value is invalid.</exception>
- /// <exception cref="System.InvalidOperationException">Thrown when native operation failed to allocate memory, connect to service.</exception>
+ /// <exception cref="System.InvalidOperationException">Thrown when a native operation failed to allocate memory and connect to the service.</exception>
public Point GeolocationToScreen(Geocoordinates coordinates)
{
return handle.GeolocationToScreen(coordinates.handle);
}
/// <summary>
- /// Changes screen coordinates to geographical coordinates.
+ /// Changes the screen coordinates to geographical coordinates.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="screenCoordinates">Screen coordinates</param>
- /// <returns>Returns an instance of geographical coordinates object.</returns>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="screenCoordinates">Screen coordinates.</param>
+ /// <returns>Returns an instance of the geographical coordinates object.</returns>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
/// <exception cref="System.UnauthorizedAccessException">Thrown when application does not have some privilege to access this method.</exception>
/// <exception cref="System.ArgumentException">Thrown when the value is invalid.</exception>
- /// <exception cref="System.InvalidOperationException">Thrown when native operation failed to allocate memory, connect to service.</exception>
+ /// <exception cref="System.InvalidOperationException">Thrown when a native operation failed to allocate memory and connect to the service.</exception>
public Geocoordinates ScreenToGeolocation(Point screenCoordinates)
{
return new Geocoordinates(handle.ScreenToGeolocation(screenCoordinates));
/// <summary>
/// Adds a map object to map view.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="child">An instance of map object to be added</param>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="child">An instance of the map object to be added.</param>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
/// <exception cref="System.UnauthorizedAccessException">Thrown when application does not have some privilege to access this method.</exception>
/// <exception cref="System.ArgumentException">Thrown when the value is invalid.</exception>
- /// <exception cref="System.InvalidOperationException">Thrown when native operation failed to allocate memory, connect to service.</exception>
+ /// <exception cref="System.InvalidOperationException">Thrown when a native operation failed to allocate memory and connect to the service.</exception>
public void Add(MapObject child)
{
Log.Info(string.Format("Add a object"));
}
/// <summary>
- /// Removes a map object from map view.
+ /// Removes a map object from the map view.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="child">An instance of map object to be removed</param>
- /// <remarks>Once removed, the child object will be become invalid</remarks>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="child">An instance of the map object to be removed.</param>
+ /// <remarks>Once removed, the child object will be become invalid.</remarks>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
/// <exception cref="System.UnauthorizedAccessException">Thrown when application does not have some privilege to access this method.</exception>
/// <exception cref="System.ArgumentException">Thrown when the value is invalid.</exception>
- /// <exception cref="System.InvalidOperationException">Thrown when native operation failed to allocate memory, connect to service.</exception>
+ /// <exception cref="System.InvalidOperationException">Thrown when native operation failed to allocate memory and connect to the service.</exception>
public void Remove(MapObject child)
{
Log.Info(string.Format("Remove a object"));
}
/// <summary>
- /// Removes all map objects from map view.
+ /// Removes all map objects from the map view.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
/// <exception cref="System.UnauthorizedAccessException">Thrown when application does not have some privilege to access this method.</exception>
- /// <exception cref="System.InvalidOperationException">Thrown when native operation failed to allocate memory, connect to service.</exception>
+ /// <exception cref="System.InvalidOperationException">Thrown when a native operation failed to allocate memory and connect to the service.</exception>
public void RemoveAll()
{
Log.Info(string.Format("Remove all of objects"));
}
/// <summary>
- /// Captures a snapshot of map view
+ /// Captures a snapshot of the map view.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="type">Type of file format</param>
- /// <param name="quality">A integer value which representing quality for encoding, from 1 to 100</param>
- /// <param name="path">A string which representing The file path for snapshot</param>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="type">Type of file format.</param>
+ /// <param name="quality">An integer value representing the quality for encoding from 1 to 100.</param>
+ /// <param name="path">A string representing the file path for a snapshot.</param>
/// <privilege>http://tizen.org/privilege/mapservice</privilege>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
/// <exception cref="System.UnauthorizedAccessException">Thrown when application does not have some privilege to access this method.</exception>
/// <exception cref="System.ArgumentException">Thrown when the value is invalid.</exception>
- /// <exception cref="System.InvalidOperationException">Thrown when native operation failed to allocate memory, connect to service.</exception>
+ /// <exception cref="System.InvalidOperationException">Thrown when a native operation failed to allocate memory and connect to the service.</exception>
public void CaptureSnapshot(SnapshotType type, int quality, string path)
{
var err = Interop.ViewSnapshot.ViewCaptureSnapshot(handle, (Interop.ViewSnapshotFormatType)type, quality, path);
}
/// <summary>
- /// Releases all resources used by this object.
+ /// Releases all the resources used by this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public void Dispose()
{
Dispose(true);
namespace Tizen.Maps
{
/// <summary>
- /// Marker map object
+ /// The marker map object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class Marker : MapObject, IDisposable
{
internal Interop.MarkerHandle handle;
}
/// <summary>
- /// Gets or sets clicked event handlers.
+ /// Gets or sets the clicked event handlers.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public event EventHandler Clicked;
/// <summary>
- /// Gets or sets marker's visibility.
+ /// Gets or sets the marker's visibility.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public override bool IsVisible
{
get
}
/// <summary>
- /// Gets or sets geographical coordinates for this marker.
+ /// Gets or sets the geographical coordinates for this marker.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public Geocoordinates Coordinates
{
get
}
/// <summary>
- /// Gets or sets a string representing image file path for this marker.
+ /// Gets or sets a string representing the image file path for this marker.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string ImagePath
{
get
}
/// <summary>
- /// Gets or sets screen size for this marker.
+ /// Gets or sets the screen size for this marker.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public Size MarkerSize
{
get
}
/// <summary>
- /// Gets or sets z-order for this marker.
+ /// Gets or sets the z-order for this marker.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <value>The integer value is 0 in default, and must be in range of from -100 to 100.</value>
+ /// <since_tizen> 3 </since_tizen>
+ /// <value>The integer value is 0 by default, and must be in the range of -100 to 100.</value>
public int ZOrder
{
get
}
/// <summary>
- /// Changes marker size.
+ /// Changes the marker size.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="newSize">New size</param>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="newSize">New size.</param>
public void Resize(Size newSize)
{
MarkerSize = newSize;
}
/// <summary>
- /// Changes marker coordinates.
+ /// Changes the marker coordinates.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="newPosition">New position for marker</param>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="newPosition">New position for the marker.</param>
public void Move(Geocoordinates newPosition)
{
Coordinates = newPosition;
}
/// <summary>
- /// Releases all resources used by this object.
+ /// Releases all the resources used by this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public void Dispose()
{
Dispose(true);
}
/// <summary>
- /// Pin type marker map object
+ /// Pin type the marker map object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class Pin : Marker
{
private const string defaultImagePath = "/usr/share/dotnet.tizen/framework/res/maps_marker_pin_48.png";
/// <summary>
- /// Creates a Pin type marker.
+ /// Creates a pin type marker.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="coordinates">Marker coordinates</param>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="coordinates">Marker coordinates.</param>
/// <exception cref="System.ArgumentException">Thrown when input coordinates are invalid.</exception>
public Pin(Geocoordinates coordinates)
: base(coordinates, defaultImagePath, Interop.ViewMarkerType.Pin)
}
/// <summary>
- /// Creates a Pin type marker.
+ /// Creates a pin type marker.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="coordinates">Marker coordinates</param>
- /// <param name="imagePath">Image file path for Marker</param>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="coordinates">Marker coordinates.</param>
+ /// <param name="imagePath">Image file path for the Marker.</param>
/// <remarks>
- /// http://tizen.org/privilege/mediastorage is needed if the file path are relevant to media storage.
- /// http://tizen.org/privilege/externalstorage is needed if the file path are relevant to external storage.
+ /// http://tizen.org/privilege/mediastorage is needed if the file path is relevant to media storage.
+ /// http://tizen.org/privilege/externalstorage is needed if the file path is relevant to external storage.
/// </remarks>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
/// <exception cref="System.UnauthorizedAccessException">Thrown when application does not have some privilege to access this method.</exception>
- /// <exception cref="System.ArgumentException">Thrown when input coordinates or imagePath are invalid.</exception>
+ /// <exception cref="System.ArgumentException">Thrown when the input coordinates or imagePath is invalid.</exception>
public Pin(Geocoordinates coordinates, string imagePath)
: base(coordinates, imagePath, Interop.ViewMarkerType.Pin)
{
}
/// <summary>
- /// Sticker type marker map object
+ /// Sticker type marker map object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class Sticker : Marker
{
private const string defaultImagePath = "/usr/share/dotnet.tizen/framework/res/maps_marker_sticker_48.png";
/// <summary>
- /// Creates a Sticker type marker.
+ /// Creates a sticker type marker.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="coordinates">Marker coordinates</param>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="coordinates">Marker coordinates.</param>
/// <exception cref="System.ArgumentException">Thrown when input coordinates are invalid.</exception>
public Sticker(Geocoordinates coordinates)
: base(coordinates, defaultImagePath, Interop.ViewMarkerType.Sticker)
}
/// <summary>
- /// Creates a Sticker type marker.
+ /// Creates a sticker type marker.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="coordinates">Marker coordinates</param>
- /// <param name="imagePath">Image file path for Marker</param>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="coordinates">Marker coordinates.</param>
+ /// <param name="imagePath">Image file path for Marker.</param>
/// <remarks>
- /// http://tizen.org/privilege/mediastorage is needed if input or output path are relevant to media storage.
- /// http://tizen.org/privilege/externalstorage is needed if input or output path are relevant to external storage.
+ /// http://tizen.org/privilege/mediastorage is needed if the input or output path are relevant to media storage.
+ /// http://tizen.org/privilege/externalstorage is needed if the input or output path are relevant to external storage.
/// </remarks>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
/// <exception cref="System.UnauthorizedAccessException">Thrown when application does not have some privilege to access this method.</exception>
- /// <exception cref="System.ArgumentException">Thrown when input coordinates or imagePath are invalid.</exception>
+ /// <exception cref="System.ArgumentException">Thrown when the input coordinates or imagePath is invalid.</exception>
public Sticker(Geocoordinates coordinates, string imagePath)
: base(coordinates, imagePath, Interop.ViewMarkerType.Sticker)
{
namespace Tizen.Maps
{
/// <summary>
- /// Multiple Reverse geocode Request for Tizen map service
+ /// Multiple reverse geocode request for Tizen map service.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class MultiReverseGeocodeRequest : MapServiceRequest<PlaceAddress>
{
private Interop.MultiReverseGeocodeCallback _geocodeCallback;
Zoom and rotation: Changing zoom and orientation of the view in response
to user gestures, such as scrolling, tapping, zooming, rotating, etc.<p/>
-Conversion of screen coordinates to geographical and vi
se versa.<p/>
+Conversion of screen coordinates to geographical and vi
ce versa.<p/>
User's gesture support:<br/>
- Receive the event of the user gesture.<br/>
namespace Tizen.Maps
{
/// <summary>
- /// Overlay map object
+ /// Overlay map object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class Overlay : MapObject, IDisposable
{
internal Interop.OverlayHandle handle;
/// <summary>
/// Creates a normal overlay map object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <param name="coordinates"></param>
/// <param name="objectToContain"></param>
- /// <exception cref="ArgumentException">Thrown when input coordinates or objectToContain are invalid</exception>
+ /// <exception cref="ArgumentException">Thrown when the input coordinates or objectToContain are invalid.</exception>
public Overlay(Geocoordinates coordinates, EvasObject objectToContain)
: this(coordinates, objectToContain, Interop.ViewOverlayType.Normal)
{
}
/// <summary>
- /// Gets or sets visibility of overlay map object.
+ /// Gets or sets the visibility of an overlay map object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public override bool IsVisible
{
get { return handle.IsVisible; }
}
/// <summary>
- /// Gets or sets geographical coordinates for overlay map object.
+ /// Gets or sets geographical coordinates for an overlay map object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public Geocoordinates Coordinates
{
get
}
/// <summary>
- /// Gets or sets minimum zoom level for overlay map object.
+ /// Gets or sets minimum zoom level for an overlay map object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public int MinimumZoomLevel
{
get
}
/// <summary>
- /// Gets or sets maximum zoom lever for overlay map object.
+ /// Gets or sets maximum zoom lever for an overlay map object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public int MaximumZoomLevel
{
get
}
/// <summary>
- /// Releases all resources used by this object.
+ /// Releases all the resources used by this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public void Dispose()
{
Dispose(true);
}
/// <summary>
- /// Bubble overlay map object
+ /// The bubble overlay map object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class BubbleOverlay : Overlay
{
/// <summary>
- /// Creates a Bubble overlay.
+ /// Creates a bubble overlay.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="coordinates">The geographical coordinates to be pointed</param>
- /// <param name="objectToContain">The EvasObject to be shown</param>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="coordinates">The geographical coordinates to be pointed.</param>
+ /// <param name="objectToContain">The EvasObject to be shown.</param>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
- /// <exception cref="ArgumentException">Thrown when input coordinates or objectToContain are invalid</exception>
+ /// <exception cref="ArgumentException">Thrown when the input coordinates or objectToContain are invalid.</exception>
public BubbleOverlay(Geocoordinates coordinates, EvasObject objectToContain)
: base(coordinates, objectToContain, Interop.ViewOverlayType.Bubble)
{
}
/// <summary>
- /// Box Overlay map object
+ /// The box overlay map object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class BoxOverlay : Overlay
{
/// <summary>
- /// Creates a Box overlay.
+ /// Creates a box overlay.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="coordinates">The geographical coordinates to be pointed</param>
- /// <param name="objectToContain">The EvasObject to be shown</param>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="coordinates">The geographical coordinates to be pointed.</param>
+ /// <param name="objectToContain">The EvasObject to be shown.</param>
/// <exception cref="System.NotSupportedException">Thrown when the required feature is not supported.</exception>
- /// <exception cref="ArgumentException">Thrown when input coordinates or objectToContain are invalid</exception>
+ /// <exception cref="ArgumentException">Thrown when the input coordinates or objectToContain are invalid</exception>
public BoxOverlay(Geocoordinates coordinates, EvasObject objectToContain)
: base(coordinates, objectToContain, Interop.ViewOverlayType.Box)
{
namespace Tizen.Maps
{
/// <summary>
- /// Place information, used in Place Discovery and Search
+ /// Place information, used in place discovery and search requests.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class Place : IDisposable
{
internal Interop.PlaceHandle handle;
}
/// <summary>
- /// Gets ID string for the place.
+ /// Gets an ID string for the place.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Id
{
get
/// <summary>
/// Gets name string for the place.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Name
{
get
}
/// <summary>
- /// Gets view URI for the place.
+ /// Gets a view URI for the place.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Uri
{
get
}
/// <summary>
- /// Gets distance for the place from the center.
+ /// Gets a distance for the place from the center.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public int Distance
{
get
}
/// <summary>
- /// Gets geographical location for the place.
+ /// Gets a geographical location for the place.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public Geocoordinates Coordinates
{
get
}
/// <summary>
- /// Gets address for the place.
+ /// Gets an address for the place.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public PlaceAddress Address
{
get
}
/// <summary>
- /// Gets rating for the place.
+ /// Gets a rating for the place.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public PlaceRating Rating
{
get
}
/// <summary>
- /// Gets supplier link for the place.
+ /// Gets a supplier link for the place.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public PlaceLink Supplier
{
get
}
/// <summary>
- /// Gets related link for the place.
+ /// Gets a related link for the place.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public PlaceLink Related
{
get
}
/// <summary>
- /// Gets all properties attached to this place.
+ /// Gets all the properties attached to this place.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public IDictionary<string, string> Properties
{
get
}
/// <summary>
- /// Gets all categories attached to this place.
+ /// Gets all the categories attached to this place.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public IEnumerable<PlaceCategory> Categories
{
get
}
/// <summary>
- /// Gets all attributes attached to this place.
+ /// Gets all the attributes attached to this place.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public IEnumerable<PlaceAttribute> Attributes
{
get
}
/// <summary>
- /// Gets all contacts attached to this place.
+ /// Gets all the contacts attached to this place.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public IEnumerable<PlaceContact> Contacts
{
get
}
/// <summary>
- /// Gets all editorials attached to this place.
+ /// Gets all the editorials attached to this place.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public IEnumerable<PlaceEditorial> Editorials
{
get
}
/// <summary>
- /// Gets all images attached to this place.
+ /// Gets all the images attached to this place.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public IEnumerable<PlaceImage> Images
{
get
}
/// <summary>
- /// Gets all reviews attached to this place.
+ /// Gets all the reviews attached to this place.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public IEnumerable<PlaceReview> Reviews
{
get
}
/// <summary>
- /// Releases all resources used by this object.
+ /// Releases all the resources used by this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public void Dispose()
{
Dispose(true);
namespace Tizen.Maps
{
/// <summary>
- /// Address information for the map point used in Geocode and Reverse Geocode requests.
+ /// Address information for the map point used in geocode and reverse geocode requests.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class PlaceAddress : IDisposable
{
internal Interop.AddressHandle handle;
/// <summary>
- /// Constructs map address object.
+ /// Constructs a map address object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <exception cref="System.InvalidOperationException">Thrown when native operation failed to allocate memory.</exception>
public PlaceAddress()
{
/// <summary>
/// Gets a building number for this address.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Building
{
get
/// <summary>
/// Gets a city name for this address.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string City
{
get
/// <summary>
/// Gets a country name for this address.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Country
{
get
/// <summary>
/// Gets a country code for this address.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string CountryCode
{
get
/// <summary>
/// Gets a county for this address.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string County
{
get
/// <summary>
/// Gets a district name for this address.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string District
{
get
/// <summary>
/// Gets a free text associated with this address.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string FreeText
{
get
/// <summary>
/// Gets a postal code for this address.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string PostalCode
{
get
/// <summary>
/// Gets a state name for this address.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string State
{
get
/// <summary>
/// Gets a street name for this address.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Street
{
get
/// <summary>
/// Returns a string that represents this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <returns>Returns a string which presents this object.</returns>
public override string ToString()
{
}
/// <summary>
- /// Releases all resources used by this object.
+ /// Releases all the resources used by this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public void Dispose()
{
Dispose(true);
namespace Tizen.Maps
{
/// <summary>
- /// List of <see cref="PlaceAddress"/> objects to be used in <see cref="MapService"/> APIs
+ /// List of <see cref="PlaceAddress"/> objects to be used in <see cref="MapService"/> APIs.
/// </summary>
internal class PlaceAddressList : IDisposable
{
}
/// <summary>
- /// Releases all resources used by this object.
+ /// Releases all the resources used by this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public void Dispose()
{
Dispose(true);
namespace Tizen.Maps
{
/// <summary>
- /// Place Attributes information, used in Place Discovery and Search requests
+ /// Place attributes information, used in place discovery and search requests.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class PlaceAttribute
{
private string _id;
/// <summary>
/// Gets an ID for the place attribute.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Id { get { return _id; } }
/// <summary>
/// Gets a label for the place attribute.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Label { get { return _label; } }
/// <summary>
/// Gets a text for the place attribute.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Text { get { return _text; } }
/// <summary>
/// Returns a string that represents this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <returns>Returns a string which presents this object.</returns>
public override string ToString()
{
namespace Tizen.Maps
{
/// <summary>
- /// Place Category information, used in Place Discovery and Search requests
+ /// Place category information, used in place discovery and search requests.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class PlaceCategory : IDisposable
{
internal Interop.PlaceCategoryHandle handle;
/// <summary>
- /// Constructs search category object.
+ /// Constructs a search category object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <exception cref="System.InvalidOperationException">Thrown when native operation failed to allocate memory.</exception>
public PlaceCategory()
{
/// <summary>
/// Gets or sets an ID for this category.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Id
{
get { return handle.Id; }
/// <summary>
/// Gets or sets a name for this category.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Name
{
get { return handle.Name; }
}
/// <summary>
- /// Gets or sets an URL for this category.
+ /// Gets or sets a URL for this category.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Url
{
get { return handle.Url; }
/// <summary>
/// Returns a string that represents this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <returns>Returns a string which presents this object.</returns>
public override string ToString()
{
}
/// <summary>
- /// Releases all resources used by this object.
+ /// Releases all the resources used by this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public void Dispose()
{
Dispose(true);
namespace Tizen.Maps
{
/// <summary>
- /// Place Contact information, used in Place Discovery and Search requests
+ /// Place contact information, used in place discovery and search requests.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class PlaceContact
{
private string _label;
/// <summary>
/// Gets an ID for this place contact.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Id { get { return _type; } }
/// <summary>
/// Gets a label for this place contact.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Label { get { return _label; } }
/// <summary>
/// Gets a value for this place contact.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Value { get { return _value; } }
/// <summary>
/// Returns a string that represents this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <returns>Returns a string which presents this object.</returns>
public override string ToString()
{
namespace Tizen.Maps
{
/// <summary>
- /// Place Editorial information, used in Place Discovery and Search requests
+ /// Place editorial information, used in place discovery and search requests.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class PlaceEditorial
{
private string _description;
/// <summary>
/// Gets a description for this place editorial.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Description { get { return _description; } }
/// <summary>
/// Gets a language for this place editorial.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Language { get { return _language; } }
/// <summary>
/// Gets an instance of <see cref="PlaceMedia"/> object which representing media for this place editorial.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public PlaceMedia Media { get { return _media; } }
/// <summary>
/// Returns a string that represents this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <returns>Returns a string which presents this object.</returns>
public override string ToString()
{
namespace Tizen.Maps
{
/// <summary>
- /// Place Filter information, used in Place Discovery and Search requests
+ /// Place filter information, used in place discovery and search requests.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class PlaceFilter : IDisposable
{
internal Interop.PlaceFilterHandle handle;
/// <summary>
- /// Constructs new place filter.
+ /// Constructs a new place filter.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <exception cref="System.InvalidOperationException">Thrown when native operation failed to allocate memory.</exception>
public PlaceFilter()
{
}
/// <summary>
- /// Gets or sets an free-formed address string for this place filter.
+ /// Gets or sets a free-formed address string for this place filter.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <remarks>Depending on maps provider which the application has selected,
/// it may treat <see cref="PlaceFilter.Name"/>, <see cref="PlaceFilter.Keyword"/> and <see cref="PlaceFilter.Address"/>
- /// as same kind of strings to search places.</remarks>
+ /// as the same kind of strings to search places.</remarks>
public string Address
{
get
/// <summary>
/// Gets or sets an instance of <see cref="PlaceCategory"/> object for this place filter.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public PlaceCategory Category
{
get
/// <summary>
/// Gets or sets a keyword for this place filter.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <remarks>Depending on maps provider which the application has selected,
/// it may treat <see cref="PlaceFilter.Name"/>, <see cref="PlaceFilter.Keyword"/> and <see cref="PlaceFilter.Address"/>
- /// as same kind of strings to search places.</remarks>
+ /// as the same kind of strings to search places.</remarks>
public string Keyword
{
get
/// <summary>
/// Gets or sets a name for this place filter.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <remarks>Depending on maps provider which the application has selected,
/// it may treat <see cref="PlaceFilter.Name"/>, <see cref="PlaceFilter.Keyword"/> and <see cref="PlaceFilter.Address"/>
- /// as same kind of strings to search places.</remarks>
+ /// as the same kind of strings to search places.</remarks>
public string Name
{
get
}
/// <summary>
- /// Releases all resources used by this object.
+ /// Releases all the resources used by this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public void Dispose()
{
Dispose(true);
namespace Tizen.Maps
{
/// <summary>
- /// Place Image information, used in Place Discovery and Search requests
+ /// Place image information, used in place discovery and search requests.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class PlaceImage
{
private string _id;
/// <summary>
/// Gets an ID for this place image.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Id { get { return _id; } }
/// <summary>
/// Gets an URL for this place image.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Url { get { return _url; } }
/// <summary>
- /// Gets width for this place image.
+ /// Gets the width for this place image.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public int Width { get { return _width; } }
/// <summary>
- /// Gets height for this place image.
+ /// Gets the height for this place image.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public int Height { get { return _height; } }
/// <summary>
- /// Gets an object which representing user link for this place image.
+ /// Gets an object representing the user link for this place image.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public PlaceLink UserLink { get { return _userLink; } }
/// <summary>
- /// Gets an object which representing image media for this place image.
+ /// Gets an object representing the image media for this place image.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public PlaceMedia ImageMedia { get { return _media; } }
}
}
namespace Tizen.Maps
{
/// <summary>
- /// Place Link Object information, used in Place Discovery and Search requests
+ /// Place link object information, used in place discovery and search requests.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class PlaceLink
{
private string _id;
}
/// <summary>
- /// Gets a string which representing ID for this place link.
+ /// Gets a string representing the ID for this place link.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Id { get { return _id; } }
/// <summary>
- /// Gets a string which representing name for this place link.
+ /// Gets a string representing the name for this place link.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Name { get { return _name; } }
/// <summary>
- /// Gets a string which representing link for this place link.
+ /// Gets a string representing the link for this place link.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Link { get { return _link; } }
/// <summary>
- /// Gets a string which representing type for this place link.
+ /// Gets a string representing the type for this place link.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Type { get { return _type; } }
}
}
namespace Tizen.Maps
{
/// <summary>
- /// List of <see cref="Place"/> objects to be used in <see cref="MapService"/> APIs
+ /// List of <see cref="Place"/> objects to be used in <see cref="MapService"/> APIs.
/// </summary>
internal class PlaceList : IDisposable
{
}
/// <summary>
- /// Gets an iterator for addresses in this list.
+ /// Gets an iterator for the addresses in this list.
/// </summary>
public IEnumerable<Place> Places
{
}
/// <summary>
- /// Releases all resources used by this object.
+ /// Releases all the resources used by this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public void Dispose()
{
Dispose(true);
namespace Tizen.Maps
{
/// <summary>
- /// Place Media information, used in Place Discovery and Search requests
+ /// Place media information, used in place discovery and search requests.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class PlaceMedia
{
private string _attribution;
}
/// <summary>
- /// Gets a string which representing attribution for this place media.
+ /// Gets a string representing the attribution for this place media.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Attribution { get { return _attribution; } }
/// <summary>
- /// Gets an instance of <see cref="PlaceLink"/> object which representing supplier for this place media.
+ /// Gets an instance of <see cref="PlaceLink"/> object representing the supplier for this place media.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public PlaceLink Supplier { get { return _supplier; } }
/// <summary>
- /// Gets an instance of <see cref="PlaceLink"/> object which representing via data for this place media.
+ /// Gets an instance of <see cref="PlaceLink"/> object representing via data for this place media.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public PlaceLink Via { get { return _via; } }
}
}
namespace Tizen.Maps
{
/// <summary>
- /// Place Rating information, used in Place Discovery and Search requests
+ /// Place rating information, used in place discovery and search requests.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class PlaceRating
{
private int _count;
/// <summary>
/// Gets the number of users rated for this place rating.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public int UserCount { get { return _count; } }
/// <summary>
- /// Gets average value of this place rating.
+ /// Gets the average value of this place rating.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public double Average { get { return _average; } }
/// <summary>
/// Returns a string that represents this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <returns>Returns a string which presents this object.</returns>
public override string ToString()
{
namespace Tizen.Maps
{
/// <summary>
- /// Place Review information, used in Place Discovery and Search requests
+ /// Place review information, used in place discovery and search requests.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class PlaceReview
{
private DateTime _date;
}
/// <summary>
- /// Gets an instance of <see cref="DateTime"/> object which representing time of this review.
+ /// Gets an instance of <see cref="DateTime"/> object representing the time of this review.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public DateTime Date { get { return _date; } }
/// <summary>
- /// Gets a string which representing title of this review.
+ /// Gets a string representing the title of this review.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Title { get { return _title; } }
/// <summary>
- /// Gets a value which representing rating of this review.
+ /// Gets a value representing the rating of this review.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public double Rating { get { return _rating; } }
/// <summary>
- /// Gets a string which representing description of this review.
+ /// Gets a string representing the description of this review.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Description { get { return _description; } }
/// <summary>
- /// Gets a string which representing language of this review.
+ /// Gets a string representing the language of this review.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Language { get { return _language; } }
/// <summary>
- /// Gets an instance of <see cref="PlaceMedia"/> object which representing review media of this review.
+ /// Gets an instance of <see cref="PlaceMedia"/> object representing the review media of this review.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public PlaceMedia ReviewMedia { get { return _media; } }
/// <summary>
- /// Gets an instance of <see cref="PlaceLink"/> object which representing user link of this review.
+ /// Gets an instance of <see cref="PlaceLink"/> object representing the user link of this review.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public PlaceLink UserLink { get { return _userLink; } }
}
}
namespace Tizen.Maps
{
/// <summary>
- /// Place search request for Tizen map service
+ /// Place search request for Tizen map service.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class PlaceSearchRequest : MapServiceRequest<Place>
{
private Interop.SearchPlaceCallback _placeCallback;
namespace Tizen.Maps
{
/// <summary>
- /// Polygon map object
+ /// The polygon map object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class Polygon : MapObject, IDisposable
{
internal Interop.PolygonHandle handle;
/// <summary>
/// Creates a polygon visual object.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="coordinates">List of geographical coordinates</param>
- /// <param name="color">Background color</param>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="coordinates">List of geographical coordinates.</param>
+ /// <param name="color">Background color.</param>
/// <exception cref="ArgumentException">Thrown when input values are invalid.</exception>
public Polygon(IEnumerable<Geocoordinates> coordinates, Color color) : base()
{
}
/// <summary>
- /// Adds or removes clicked event handlers.
+ /// Adds or removes the clicked event handlers.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public event EventHandler Clicked;
/// <summary>
/// Gets or sets visibility for the polygon.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public override bool IsVisible
{
get { return handle.IsVisible; }
}
/// <summary>
- /// Gets or sets a list of geographical coordinates of polygon vertices.
+ /// Gets or sets a list of geographical coordinates for polygon vertices.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public IEnumerable<Geocoordinates> Coordinates
{
get
}
/// <summary>
- /// Gets or sets background color to fill the polygon.
+ /// Gets or sets a background color to fill the polygon.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public Color FillColor
{
get
}
/// <summary>
- /// Releases all resources used by this object.
+ /// Releases all the resources used by this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public void Dispose()
{
Dispose(true);
namespace Tizen.Maps
{
/// <summary>
- /// Polyline map object
+ /// The polyline map object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class Polyline : MapObject, IDisposable
{
internal Interop.PolylineHandle handle;
/// <summary>
/// Creates polyline visual object.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <param name="coordinates">List of geographical coordinates</param>
- /// <param name="color">Line color</param>
- /// <param name="width">The width of line [1 ~ 100] (pixels)</param>
- /// <exception cref="ArgumentException">Thrown when input values are invalid</exception>
+ /// <since_tizen> 3 </since_tizen>
+ /// <param name="coordinates">List of geographical coordinates.</param>
+ /// <param name="color">Line color.</param>
+ /// <param name="width">The width of line [1 ~ 100] (pixels).</param>
+ /// <exception cref="ArgumentException">Thrown when input values are invalid.</exception>
public Polyline(List<Geocoordinates> coordinates, Color color, int width) : base()
{
var err = Interop.ErrorCode.InvalidParameter;
}
/// <summary>
- /// Adds or removes clicked event handlers.
+ /// Adds or removes the clicked event handlers.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public event EventHandler Clicked;
/// <summary>
- /// Gets or sets visibility for the polyline.
+ /// Gets or sets the visibility for polyline.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public override bool IsVisible
{
get { return handle.IsVisible; }
/// <summary>
/// Gets or sets a list of geographical coordinates for polyline vertices.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public IEnumerable<Geocoordinates> Coordinates
{
get
}
/// <summary>
- /// Gets or sets line color.
+ /// Gets or sets the line color.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public Color LineColor
{
get
}
/// <summary>
- /// Gets or sets line width from 1 to 100 pixels.
+ /// Gets or sets the line width from 1 to 100 pixels.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public int Width
{
get
}
/// <summary>
- /// Releases all resources used by this object.
+ /// Releases all the resources used by this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public void Dispose()
{
Dispose(true);
namespace Tizen.Maps
{
/// <summary>
- /// Reverse geocode request for map service.
+ /// Reverses the geocode request for a map service.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class ReverseGeocodeRequest : MapServiceRequest<PlaceAddress>
{
private Interop.ReverseGeocodeCallback _geocodeCallback;
/// <summary>
/// Route information, used in Route Search requests.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class Route : IDisposable
{
internal Interop.RouteHandle handle;
}
/// <summary>
- /// Gets an instance of <see cref="Geocoordinates"/> object which representing destination coordinates for this route.
+ /// Gets an instance of <see cref="Geocoordinates"/> object representing destination coordinates for this route.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public Geocoordinates Destination
{
get
}
/// <summary>
- /// Gets total distance for this route.
+ /// Gets the total distance for this route.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public double Distance
{
get
}
/// <summary>
- /// Get total duration to cover this route.
+ /// Get the total duration to cover this route.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public double Duration
{
get
/// <summary>
/// Gets an ID for this route.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Id
{
get
}
/// <summary>
- /// Gets transport mode for this route.
+ /// Gets the transport mode for this route.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public TransportMode Mode
{
get
}
/// <summary>
- /// Gets origin coordinates for this route.
+ /// Gets the origin coordinates for this route.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public Geocoordinates Origin
{
get
/// <summary>
/// Gets a coordinates list for this route.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public IEnumerable<Geocoordinates> Path
{
get
/// <summary>
/// Gets a segment list for this route.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public IEnumerable<RouteSegment> Segments
{
get
}
/// <summary>
- /// Gets distance unit for this route.
+ /// Gets the distance unit for this route.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public DistanceUnit Unit
{
get
}
/// <summary>
- /// Releases all resources used by this object.
+ /// Releases all the resources used by this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public void Dispose()
{
Dispose(true);
namespace Tizen.Maps
{
/// <summary>
- /// Route features, used for route search requests
+ /// Route features used for route search requests.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public enum RouteFeature
{
/// <summary>
- /// Indicates no route features (are selected).
+ /// Indicates no route features are selected.
/// </summary>
None = Interop.RouteRequestFeature.None,
/// <summary>
/// </summary>
Toll = Interop.RouteRequestFeature.Toll,
/// <summary>
- /// Indicates motorway.
+ /// Indicates a motorway.
/// </summary>
Motorway = Interop.RouteRequestFeature.MotorWay,
/// <summary>
/// </summary>
BoatFerry = Interop.RouteRequestFeature.BoatFerry,
/// <summary>
- /// Indicates rail (train) ferry.
+ /// Indicates a rail (train) ferry.
/// </summary>
RailFerry = Interop.RouteRequestFeature.RailFerry,
/// <summary>
- /// Indicates public transport.
+ /// Indicates a public transport.
/// </summary>
PublicTransit = Interop.RouteRequestFeature.PublicTransit,
/// <summary>
- /// Indicates tunnel.
+ /// Indicates a tunnel.
/// </summary>
Tunnel = Interop.RouteRequestFeature.Tunnel,
/// <summary>
- /// Indicates dirt road.
+ /// Indicates a dirt road.
/// </summary>
DirtRoad = Interop.RouteRequestFeature.DirtRoad,
/// <summary>
- /// Indicates park.
+ /// Indicates a park.
/// </summary>
Parks = Interop.RouteRequestFeature.Parks,
/// <summary>
namespace Tizen.Maps
{
/// <summary>
- /// Route feature weights used in route search requests
+ /// Route feature weights used in route search requests.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public enum RouteFeatureWeight
{
/// <summary>
namespace Tizen.Maps
{
/// <summary>
- /// Route Maneuver information, used in Route Search requests
+ /// Route maneuver information used in route search requests.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class RouteManeuver
{
private Interop.RouteDirection _direction;
}
/// <summary>
- /// Gets direction type for this maneuver.
+ /// Gets the direction type for this maneuver.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public DirectionType Direction { get { return (DirectionType)_direction; } }
/// <summary>
- /// Gets turn type for this maneuver.
+ /// Gets the turn type for this maneuver.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public TurnInstruction Turn { get { return (TurnInstruction)_turntype; } }
/// <summary>
/// Gets a geographical coordinates position for this maneuver.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public Geocoordinates Position { get { return _coordinates; } }
/// <summary>
/// Gets a name of the road for this maneuver.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Road { get { return _road; } }
/// <summary>
/// Gets an instruction text for this maneuver.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Instruction { get { return _instruction; } }
/// <summary>
/// Gets a locale for this maneuver.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string Locale { get { return _locale; } }
/// <summary>
- /// Gets time to next instruction for this maneuver.
+ /// Gets the time to next instruction for this maneuver.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public int TimeToNextInstruction { get { return _timeToNextInstruction; } }
/// <summary>
- /// Gets distance to next instruction for this maneuver.
+ /// Gets the distance to next instruction for this maneuver.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public double DistanceToNextInstruction { get { return _distanceToNextInstruction; } }
}
}
namespace Tizen.Maps
{
/// <summary>
- /// Allowed route optimization option used in route search requests
+ /// Allowed route optimization option used in route search requests.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <remarks>
- /// Depending on loaded maps plug-in using <see cref="MapService"/>, some features may have no effect or differences with descriptions.
+ /// Depending on the loaded maps plug-in using <see cref="MapService"/>, some features might have no effect or differences with the descriptions.
/// </remarks>
public enum RouteOptimization
{
/// <summary>
- /// Indicates that searching for fastest routes.
+ /// Indicates searching for the fastest routes.
/// </summary>
Fastest = Interop.RouteOptimization.Fastest,
/// <summary>
- /// Indicates that searching for shortest routes (car mode only).
+ /// Indicates searching for the shortest routes (car mode only).
/// </summary>
Shortest = Interop.RouteOptimization.Shortest,
/// <summary>
- /// Indicates that searching for most economic routes (car mode only).
+ /// Indicates searching for the most economic routes (car mode only).
/// </summary>
Economic = Interop.RouteOptimization.Economic,
/// <summary>
- /// Indicates that searching for most scenic routes.
+ /// Indicates searching for the most scenic routes.
/// </summary>
Scenic = Interop.RouteOptimization.Scenic,
/// <summary>
- /// Indicates that searching for most fastest routes now, based on current traffic condition.
+ /// Indicates searching for most the fastest routes now, based on the current traffic condition.
/// </summary>
FastestNow = Interop.RouteOptimization.FastestNow,
/// <summary>
- /// Indicates that searching for direct drive routes.
+ /// Indicates searching for the direct drive routes.
/// </summary>
DirectDrive = Interop.RouteOptimization.DirectDrive,
}
namespace Tizen.Maps
{
/// <summary>
- /// Route search request for Tizen map service requests
+ /// Routes the search request for Tizen map service requests.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class RouteSearchRequest : MapServiceRequest<Route>
{
private Interop.SearchRouteCallback _routeCallback;
}
/// <summary>
- /// Gets or sets a list of way-points to cover between origin and destination.
+ /// Gets or sets a list of way-points to cover between the origin and destination.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public IEnumerable<Geocoordinates> Waypoints
{
get
namespace Tizen.Maps
{
/// <summary>
- /// Place Segment information, used in Route Search requests
+ /// Place Segment information used in Route Search requests.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class RouteSegment
{
private Geocoordinates _origin;
}
/// <summary>
- /// Gets an origin coordinates for this segment.
+ /// Gets the origin coordinates for this segment.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public Geocoordinates Origin { get { return _origin; } }
/// <summary>
- /// Gets a destination coordinates for this segment.
+ /// Gets the destination coordinates for this segment.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public Geocoordinates Destination { get { return _destination; } }
/// <summary>
- /// Gets total distance for this segment.
+ /// Gets the total distance for this segment.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public double Distance { get { return _distance; } }
/// <summary>
- /// Gets total duration to cover this segment.
+ /// Gets the total duration to cover this segment.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public double Duration { get { return _duration; } }
/// <summary>
- /// Gets a maneuver list for this segment.
+ /// Gets the maneuver list for this segment.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public IEnumerable<RouteManeuver> Maneuvers { get { return _maneuvers; } }
/// <summary>
- /// Gets a coordinates list for this segment.
+ /// Gets the coordinates list for this segment.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public IEnumerable<Geocoordinates> Path { get { return _path; } }
private Area BoundingBox { get { return _boundingBox; } }
namespace Tizen.Maps
{
/// <summary>
- /// Preferences for route search requests
+ /// Preferences for route search requests.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public class SearchPreference : IGeocodePreference, IPlaceSearchPreference, IRouteSearchPreference, IDisposable
{
internal Interop.PreferenceHandle handle;
private IDictionary<string, string> _properties = new Dictionary<string, string>();
/// <summary>
- /// Constructors a new search preference.
+ /// Constructor for a new search preference.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public SearchPreference()
{
handle = new Interop.PreferenceHandle();
}
/// <summary>
- /// Constructors a new search preference.
+ /// Constructor for a new search preference.
/// </summary>
internal SearchPreference(Interop.PreferenceHandle nativeHandle)
{
}
/// <summary>
- /// Gets or sets preferred language.
+ /// Gets or sets a preferred language.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
/// <remarks>Language should be specified as an ISO 3166 alpha-2 two letter country-code
/// followed by ISO 639-1 for the two-letter language code.<br/>e.g. "ko-KR", "en-US".</remarks>
public string Language
/// <summary>
/// Gets or sets the maximum result count for each service request.
/// </summary>
- /// <since_tizen>3</since_tizen>
- /// <remarks>Setting negative value will not have any effect on MaxResults value</remarks>
+ /// <since_tizen> 3 </since_tizen>
+ /// <remarks>Setting negative value will not have any effect on MaxResults value.</remarks>
public int MaxResults
{
get
}
/// <summary>
- /// Gets or sets distance unit.
+ /// Gets or sets the distance unit.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public DistanceUnit Unit
{
get
}
/// <summary>
- /// Gets or sets preferred country.
+ /// Gets or sets the preferred country.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public string CountryCode
{
get
}
/// <summary>
- /// Gets or sets search properties as key value pair.
+ /// Gets or sets the search properties as a key value pair.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public IReadOnlyDictionary<string, string> Properties
{
get
}
/// <summary>
- /// Gets or sets route optimization.
+ /// Gets or sets the route optimization.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public RouteOptimization Optimization
{
get
}
/// <summary>
- /// Gets or sets route transport mode.
+ /// Gets or sets the route transport mode.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public TransportMode Mode
{
get
}
/// <summary>
- /// Gets or sets route feature weight.
+ /// Gets or sets the route feature weight.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public RouteFeatureWeight RouteFeatureWeight
{
get
}
/// <summary>
- /// Gets or sets route feature.
+ /// Gets or sets the route feature.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public RouteFeature RouteFeature
{
get
}
/// <summary>
- /// Gets or sets if searching for alternative routes is enabled.
+ /// Gets or sets if the searching for alternative routes is enabled.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public bool SearchAlternativeRoutes
{
get
}
/// <summary>
- /// Releases all resources used by this object.
+ /// Releases all the resources used by this object.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public void Dispose()
{
Dispose(true);
namespace Tizen.Maps
{
/// <summary>
- /// Features available in the Map Service
+ /// Features available in the map service.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public enum ServiceData
{
/// <summary>
- /// Indicates availability of address value in the Place data.
+ /// Indicates availability of address value in the place data.
/// </summary>
PlaceAddress = Interop.ServiceData.PlaceAddress,
/// <summary>
- /// Indicates availability of rating value in the Place data.
+ /// Indicates availability of rating value in the place data.
/// </summary>
PlaceRating = Interop.ServiceData.PlaceRating,
/// <summary>
- /// Indicates availability of place category list in the Place data.
+ /// Indicates availability of place category list in the place data.
/// </summary>
PlaceCategories = Interop.ServiceData.PlaceCategories,
/// <summary>
- /// Indicates availability of place attribute list in the Place data.
+ /// Indicates availability of place attribute list in the place data.
/// </summary>
PlaceAttributes = Interop.ServiceData.PlaceAttributes,
/// <summary>
- /// Indicates availability of place contact list in the Place data.
+ /// Indicates availability of place contact list in the place data.
/// </summary>
PlaceContacts = Interop.ServiceData.PlaceContacts,
/// <summary>
- /// Indicates availability of place editorial list in the Place data.
+ /// Indicates availability of place editorial list in the place data.
/// </summary>
PlaceEditorials = Interop.ServiceData.PlaceEditorials,
/// <summary>
- /// Indicates availability of place review list in the Place data.
+ /// Indicates availability of place review list in the place data.
/// </summary>
PlaceReviews = Interop.ServiceData.PlaceReviews,
/// <summary>
- /// Indicates availability of place image in Place the data.
+ /// Indicates availability of place image in the place data.
/// </summary>
PlaceImage = Interop.ServiceData.PlaceImage,
/// <summary>
- /// Indicates availability of place supplier link value in the Place data.
+ /// Indicates availability of place supplier link value in the place data.
/// </summary>
PlaceSupplier = Interop.ServiceData.PlaceSupplier,
/// <summary>
- /// Indicates availability of related place link in the Place data.
+ /// Indicates availability of a related place link in the place data.
/// </summary>
PlaceRelated = Interop.ServiceData.PlaceRelated,
/// <summary>
- /// Indicates that the Route Data Structure is defined as a Path (a list of geographical coordinates).
+ /// Indicates that the route data structure is defined as a path (a list of geographical coordinates).
/// </summary>
RoutePath = Interop.ServiceData.RoutePath,
/// <summary>
- /// Indicates that the Route Data Structure is defined as a list of Segments while each segment is defined as a Path.
+ /// Indicates that the route data structure is defined as a list of segments while each segment is defined as a path.
/// </summary>
RouteSegmentsPath = Interop.ServiceData.RouteSegmentsPath,
/// <summary>
- /// Indicates that the Route Data Structure is defined as a list of Segments while each segment is defined as a list of Maneuvers.
+ /// Indicates that the route data structure is defined as a list of segments while each segment is defined as a list of maneuvers.
/// </summary>
RouteSegmentsManeuvers = Interop.ServiceData.RouteSegmentsManeuvers,
/// <summary>
- /// Indicates availability of traffic information on the Map.
+ /// Indicates availability of traffic information on the map.
/// </summary>
ViewTraffic = Interop.ServiceData.ViewTraffic,
/// <summary>
- /// Indicates availability of public transit information on the Map.
+ /// Indicates availability of public transit information on the map.
/// </summary>
ViewPublicTransit = Interop.ServiceData.ViewPublicTransit,
/// <summary>
- /// Indicates availability of 3D building drawable on the Map.
+ /// Indicates availability of 3D building drawable on the map.
/// </summary>
ViewBuilding = Interop.ServiceData.ViewBuilding,
/// <summary>
- /// Indicates availability of scale bar on the Map.
+ /// Indicates availability of scale bar on the map.
/// </summary>
ViewScaleBar = Interop.ServiceData.ViewScaleBar,
}
namespace Tizen.Maps
{
/// <summary>
- /// Service Requests available in the Maps Service
+ /// Service requests available in the maps service.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public enum ServiceRequestType
{
/// <summary>
- /// Indicates that service request to get position <see cref="Geocoordinates"/> for a given free-formed address string is allowed.
+ /// Indicates the service request to get position <see cref="Geocoordinates"/> for a given free-formed address string is allowed.
/// </summary>
Geocode = Interop.ServiceType.Geocode,
/// <summary>
namespace Tizen.Maps
{
/// <summary>
- /// Enumeration for snapshot file formats
+ /// Enumeration for the snapshot file formats.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public enum SnapshotType
{
/// <summary>
- /// Indicates BMP file format.
+ /// Indicates the BMP file format.
/// </summary>
BMP = Interop.ViewSnapshotFormatType.ViewSnapshotBmp,
/// <summary>
- /// Indicates JPEG file format.
+ /// Indicates the JPEG file format.
/// </summary>
JPEG = Interop.ViewSnapshotFormatType.ViewSnapshotJpeg,
}
namespace Tizen.Maps
{
/// <summary>
- /// Route types
+ /// Route types.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public enum TransportMode
{
/// <summary>
- /// Indicates that route is to be traveled by car.
+ /// Indicates that the route is to be traveled by a car.
/// </summary>
Car = Interop.RouteTransportMode.Car,
/// <summary>
- /// Indicates that route is for a pedestrian.
+ /// Indicates that the route is for a pedestrian.
/// </summary>
Pedestrian = Interop.RouteTransportMode.Pedestrian,
/// <summary>
- /// Indicates that route is for a cyclist.
+ /// Indicates that the route is for a cyclist.
/// </summary>
Bicycle = Interop.RouteTransportMode.Bicycle,
/// <summary>
- /// Indicates that route is to be traveled using public transport.
+ /// Indicates that the route is to be traveled using public transport.
/// </summary>
PublicTransit = Interop.RouteTransportMode.PublicTransit,
/// <summary>
- /// Indicates that route is for a truck.
+ /// Indicates that the route is for a truck.
/// </summary>
Truck = Interop.RouteTransportMode.Truck,
}
namespace Tizen.Maps
{
/// <summary>
- /// Turn Instruction type for route maneuver
+ /// Turns the Instruction type for route maneuver.
/// </summary>
- /// <since_tizen>3</since_tizen>
+ /// <since_tizen> 3 </since_tizen>
public enum TurnInstruction
{
/// <summary>
- /// Indicates unknown instruction.
+ /// Indicates an unknown instruction.
/// </summary>
None = Interop.RouteTurnType.None,
/// <summary>
/// </summary>
HardRight = Interop.RouteTurnType.HardRight,
/// <summary>
- /// Indicates instruction to u-turn to the right.
+ /// Indicates instruction to U-turn to the right.
/// </summary>
UturnRight = Interop.RouteTurnType.UturnRight,
/// <summary>
- /// Indicates instruction to u-turn to the left.
+ /// Indicates instruction to U-turn to the left.
/// </summary>
UturnLeft = Interop.RouteTurnType.UturnLeft,
/// <summary>
projects / platform / core / csapi / tizenfx.git / commitdiff