| java.lang.Object | ||
| ↳ | com.carto.geocoding.ReverseGeocodingService | |
| ↳ | com.carto.geocoding.PeliasOnlineReverseGeocodingService | |
Class Overview
An online reverse geocoding service that uses Mapzen Pelias geocoder.
As the class connects to an external (non-CARTO) service, this class is provided "as-is",
future changes from the service provider may not be compatible with the implementation.
Geocoding and reverse geocoding perform network requests and must be executed in non-UI background thread.
Be sure to read the Terms and Conditions of your Pelias service provider to see if the
service is available for your application.
Note: this class is experimental and may change or even be removed in future SDK versions.
Summary
| Public Constructors | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
|
PeliasOnlineReverseGeocodingService(String apiKey)
Constructs a new instance of the PeliasOnlineReverseGeocodingService given API key.
| |||||||||||
| Public Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| GeocodingResultVector |
calculateAddresses(ReverseGeocodingRequest request)
Calculates matching addresses from the specified reverse geocoding request.
| ||||||||||
| synchronized void | delete() | ||||||||||
| String |
getCustomServiceURL()
Returns the custom backend service URL.
| ||||||||||
| String |
getLanguage()
Returns the language of the expected results.
| ||||||||||
| void |
setCustomServiceURL(String serviceURL)
Sets the custom backend service URL.
| ||||||||||
| void |
setLanguage(String lang)
Sets the language of the expected results.
| ||||||||||
|
[Expand]
Inherited Methods | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
From class
com.carto.geocoding.ReverseGeocodingService
| |||||||||||
|
From class
java.lang.Object
| |||||||||||
Public Constructors
public PeliasOnlineReverseGeocodingService (String apiKey)
Constructs a new instance of the PeliasOnlineReverseGeocodingService given API key.
Parameters
| apiKey | The API key to use (registered with Mapzen). |
|---|
Public Methods
public GeocodingResultVector calculateAddresses (ReverseGeocodingRequest request)
Calculates matching addresses from the specified reverse geocoding request.
Parameters
| request | The reverse geocoding request to use. |
|---|
Returns
- The list of matching geocoding results, sorted by descending ranks.
Throws
| IOException |
|---|
public synchronized void delete ()
public String getCustomServiceURL ()
Returns the custom backend service URL.
Returns
- The custom backend service URL. If this is not defined, an empty string is returned.
public String getLanguage ()
Returns the language of the expected results.
Returns
- The language of the expected results. As ISO 639-1 code or empty string.
public void setCustomServiceURL (String serviceURL)
Sets the custom backend service URL.
The custom URL may contain tag "{api_key}" which will be substituted with the set API key.
Parameters
| serviceURL | The custom backend service URL to use. If this is empty, then the default service is used. |
|---|
public void setLanguage (String lang)
Sets the language of the expected results.
Parameters
| lang | The language to use as ISO 639-1 code. Empty string can be used for default language. |
|---|