Class MapService
Definition
- Assembly:
- Tizen.Maps.dll
Map service class for service request.
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public class MapService : IDisposable
- Inheritance
-
objectMapService
- Implements
-
System.IDisposable
Constructors
View SourceMapService(string, string)
Creates a new maps service object for given service provider.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public MapService(string serviceProvider, string serviceProviderKey)
Parameters
Type | Name | Description |
---|---|---|
string | serviceProvider | A string representing the name of the map service provider. |
string | serviceProviderKey | A string representing a certificate key to use the map service provider. |
Exceptions
Type | Condition |
---|---|
System.NotSupportedException | Thrown when the required feature is not supported. |
System.ArgumentException | Thrown when parameters are invalid. |
System.InvalidOperationException | Thrown when a native operation failed to allocate memory and connect to the service. |
System.UnauthorizedAccessException | Thrown when application does not have some privilege to access this method. |
Properties
View SourceGeocodePreferences
Gets the search preferences used for GeocodeRequest or ReverseGeocodeRequest.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public IGeocodePreference GeocodePreferences { get; }
Property Value
Type | Description |
---|---|
IGeocodePreference |
PlaceSearchFilter
Gets and sets a filter used for the place search result.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public PlaceFilter PlaceSearchFilter { get; set; }
Property Value
Type | Description |
---|---|
PlaceFilter |
PlaceSearchPreferences
Gets the search preferences used for PlaceSearchRequest.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public IPlaceSearchPreference PlaceSearchPreferences { get; }
Property Value
Type | Description |
---|---|
IPlaceSearchPreference |
Preferences
Gets and sets the search preferences.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public SearchPreference Preferences { get; set; }
Property Value
Type | Description |
---|---|
SearchPreference |
Provider
Gets the name of the map service provider.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public string Provider { get; }
Property Value
Type | Description |
---|---|
string |
ProviderKey
Gets and sets a string representing keys for the map service provider.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public string ProviderKey { get; set; }
Property Value
Type | Description |
---|---|
string |
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.
Providers
Gets the list of available map service providers.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public static IEnumerable<string> Providers { get; }
Property Value
Type | Description |
---|---|
System.Collections.Generic.IEnumerable<T><string> | The list of map service providers. |
Exceptions
Type | Condition |
---|---|
System.NotSupportedException | Thrown when the required feature is not supported. |
System.UnauthorizedAccessException | Thrown when application does not have privilege to access this property. |
RouteSearchPreferences
Gets the search preferences used for RouteSearchRequest.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public IRouteSearchPreference RouteSearchPreferences { get; }
Property Value
Type | Description |
---|---|
IRouteSearchPreference |
UserConsented
Gets a user consent for the map service provider
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public bool UserConsented { get; }
Property Value
Type | Description |
---|---|
bool |
Methods
View SourceCreateGeocodeRequest(string, Area)
Creates a geocode search request for the given free-formed address string, within the specified boundary.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public GeocodeRequest CreateGeocodeRequest(string address, Area boundary)
Parameters
Type | Name | Description |
---|---|---|
string | address | A string representing the free-formed address. |
Area | boundary | An instance of Area object representing the interested area. |
Returns
Type | Description |
---|---|
GeocodeRequest | Returns a GeocodeRequest object created with an address string and a specified boundary. |
See Also
View SourceCreateGeocodeRequest(string)
Creates a geocode search request for the given free-formed address string.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public GeocodeRequest CreateGeocodeRequest(string address)
Parameters
Type | Name | Description |
---|---|---|
string | address | A string representing free-formed address. |
Returns
Type | Description |
---|---|
GeocodeRequest | Returns a GeocodeRequest object created with an address string. |
CreateGeocodeRequest(PlaceAddress)
Creates a geocode search request for the given structured address.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public GeocodeRequest CreateGeocodeRequest(PlaceAddress address)
Parameters
Type | Name | Description |
---|---|---|
PlaceAddress | address | A string representing the address of interest. |
Returns
Type | Description |
---|---|
GeocodeRequest | Returns a GeocodeRequest object created with a structured address. |
CreateMultiReverseGeocodeRequest(IEnumerable<Geocoordinates>)
Creates a reverse geocode search request for the given position coordinates list.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public MultiReverseGeocodeRequest CreateMultiReverseGeocodeRequest(IEnumerable<Geocoordinates> coordinates)
Parameters
Type | Name | Description |
---|---|---|
System.Collections.Generic.IEnumerable<T><Geocoordinates> | coordinates | Coordinates list with [2 ~ 100] coordinates. |
Returns
Type | Description |
---|---|
MultiReverseGeocodeRequest | Returns a MultiReverseGeocodeRequest object created with a list of location coordinates. |
CreatePlaceSearchRequest(string, Area)
Creates a place search request for a free-formed address within the boundary.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public PlaceSearchRequest CreatePlaceSearchRequest(string address, Area boundary)
Parameters
Type | Name | Description |
---|---|---|
string | address | A string which represents a free-formed address. |
Area | boundary | An instance of area object representing an area to search interested places. |
Returns
Type | Description |
---|---|
PlaceSearchRequest | Returns a PlaceSearchRequest object created with an address string and a specified boundary. |
CreatePlaceSearchRequest(Area)
Creates a place search request for places within a specified boundary.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public PlaceSearchRequest CreatePlaceSearchRequest(Area boundary)
Parameters
Type | Name | Description |
---|---|---|
Area | boundary | An instance of Area object representing and area to search interested places. |
Returns
Type | Description |
---|---|
PlaceSearchRequest | Returns a PlaceSearchRequest object created with a specified boundary. |
CreatePlaceSearchRequest(Geocoordinates, int)
Creates a place search request for a specified search radius around a given coordinates position.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public PlaceSearchRequest CreatePlaceSearchRequest(Geocoordinates coordinates, int distance)
Parameters
Type | Name | Description |
---|---|---|
Geocoordinates | coordinates | Geographical coordinates of the center. |
int | distance | A double value representing the radius of an area to search places. |
Returns
Type | Description |
---|---|
PlaceSearchRequest | Returns a PlaceSearchRequest object created with the location coordinates and search radius. |
CreateReverseGeocodeRequest(double, double)
Creates a reverse geocode search request for the given latitude and longitude.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public ReverseGeocodeRequest CreateReverseGeocodeRequest(double latitude, double longitude)
Parameters
Type | Name | Description |
---|---|---|
double | latitude | Latitude of the interested place. |
double | longitude | Longitude of the interested place. |
Returns
Type | Description |
---|---|
ReverseGeocodeRequest | Returns a ReverseGeocodeRequest object created with the location coordinates. |
CreateRouteSearchRequest(Geocoordinates, Geocoordinates)
Creates a route search request for the origin and destination points.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public RouteSearchRequest CreateRouteSearchRequest(Geocoordinates from, Geocoordinates to)
Parameters
Type | Name | Description |
---|---|---|
Geocoordinates | from | Starting point. |
Geocoordinates | to | Destination. |
Returns
Type | Description |
---|---|
RouteSearchRequest | Returns a RouteSearchRequest object created with the origin and destination coordinates. |
Dispose()
Releases all the resources used by this object.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public void Dispose()
Dispose(bool)
Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
protected virtual void Dispose(bool disposing)
Parameters
Type | Name | Description |
---|---|---|
bool | disposing | If true, managed and unmanaged resources can be disposed, otherwise only unmanaged resources can be disposed. |
~MapService()
Destroy the MapService object.
Declaration
protected ~MapService()
IsSupported(ServiceData)
Checks if the maps service supports a given data feature.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public bool IsSupported(ServiceData data)
Parameters
Type | Name | Description |
---|---|---|
ServiceData | data | Data feature to check. |
Returns
Type | Description |
---|---|
bool | Returns true if the maps service supports a data feature, otherwise false. |
Exceptions
Type | Condition |
---|---|
System.NotSupportedException | Thrown when the required feature is not supported. |
System.UnauthorizedAccessException | Thrown when application does not have some privilege to access this method. |
IsSupported(ServiceRequestType)
Checks if the maps service supports the given request.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public bool IsSupported(ServiceRequestType type)
Parameters
Type | Name | Description |
---|---|---|
ServiceRequestType | type | Request type to check |
Returns
Type | Description |
---|---|
bool | Returns true if the maps service supports a request, otherwise false. |
Exceptions
Type | Condition |
---|---|
System.NotSupportedException | Thrown when the required feature is not supported. |
System.UnauthorizedAccessException | Thrown when application does not have some privilege to access this method. |
RequestUserConsent()
Gets the user's consent to use maps data.
Declaration
[Obsolete("Deprecated since API11. Might be removed in API13.")]
public Task<bool> RequestUserConsent()
Returns
Type | Description |
---|---|
System.Threading.Tasks.Task<TResult><bool> | Returns true if user agreed that the application can use maps data, otherwise false. |
Exceptions
Type | Condition |
---|---|
System.NotSupportedException | Thrown when the required feature is not supported. |
System.UnauthorizedAccessException | Thrown when application does not have some privilege to access this method. |