new alk.service.LocationsService(opt_options)
This constructor creates a Service object to access the ALK PC Miler Locations Service.
Option | Type | Description |
---|---|---|
apiKey |
string |
This option contains the ALK ApiKey that gives you permission to extract data from ALK Servers. |
city |
string |
This option specifies the city that will be used to search. |
citySearchFilter |
string |
This option specifies the city search filter to use. TODO: Various values? |
coords |
Array.<string> | string |
This options specifies the coordinates with which to restrict the search. The projection must be EPSG:4356. |
dataset |
alk.val.Dataset | number | string |
The option contains the Dataset parameter for the Service. This option specifies an area dataset that may be pertinent to the request. |
hostURL |
string |
This option contains the the host and port URL for the particular service. This option is not set by the user, but is automatically generated from the particular service being used. |
list |
number | string |
This option tells the service how many results to return. |
matchNamedRoadsOnly |
boolean | number | string |
This option is tells the service that when it is looking up coordinates to force reverse geocoding to match named roads only. |
maxCleanupMiles |
number | string |
This option is tells the service that when it is looking up coordinates sets maximum radius in which to find the closest matching road. |
path |
string |
This option is the path part of the URL for the particular service. This option is not set by the user, but is automatically generated from the particular service being used. |
postCode |
string |
This option contains the postal code to use in the search. |
postCodeFilter |
string |
This option contains the postal code filter to use in the search. The service uses this option to filter zip codes by country. For example, use 'US' to indicate US zip codes only. Use 'EM' to indicate Mexican postal codes only. Use a sequence of country codes for multiple. TODO: Are they separated by commas? |
region |
alk.val.Region | number | string |
This option tells the service in which region the retrieved data is to pertain. Some ALK Services switch underlying services due to this option. For instance, traffic data for North America and Europe may come from different underlying services. |
splc |
string |
This option contains the Standard Point Lookup Code. It is used in place of using street/city/state/zip. |
state |
string |
This option contains the state (or provence) to use in the search. |
street |
string |
This option contains the state (or provence) to use in the search. |
Extends
Methods
-
get(opts_or_callback, responseCallback)
-
This function performs a request for a
alkx.LocationsServiceResponse
from the options and defaults set on thisalk.service.LocationsService
object.The response is handled by a asynchronous callback.
Name Type Description opts_or_callback
alkx.LocationsServiceOptions | null | function Options override, if not the callback.
Attribute Type Description apiKey
string This option contains the ALK ApiKey that gives you permission to extract data from ALK Servers.
city
string This option specifies the city that will be used to search.
citySearchFilter
string This option specifies the city search filter to use. TODO: Various values?
coords
Array.<string> | string This options specifies the coordinates with which to restrict the search. The projection must be EPSG:4356.
dataset
alk.val.Dataset | number | string The option contains the Dataset parameter for the Service. This option specifies an area dataset that may be pertinent to the request.
hostURL
string This option contains the the host and port URL for the particular service. This option is not set by the user, but is automatically generated from the particular service being used.
list
number | string This option tells the service how many results to return.
matchNamedRoadsOnly
boolean | number | string This option is tells the service that when it is looking up coordinates to force reverse geocoding to match named roads only.
maxCleanupMiles
number | string This option is tells the service that when it is looking up coordinates sets maximum radius in which to find the closest matching road.
path
string This option is the path part of the URL for the particular service. This option is not set by the user, but is automatically generated from the particular service being used.
postCode
string This option contains the postal code to use in the search.
postCodeFilter
string This option contains the postal code filter to use in the search. The service uses this option to filter zip codes by country. For example, use 'US' to indicate US zip codes only. Use 'EM' to indicate Mexican postal codes only. Use a sequence of country codes for multiple. TODO: Are they separated by commas?
region
alk.val.Region | number | string This option tells the service in which region the retrieved data is to pertain. Some ALK Services switch underlying services due to this option. For instance, traffic data for North America and Europe may come from different underlying services.
splc
string This option contains the Standard Point Lookup Code. It is used in place of using street/city/state/zip.
state
string This option contains the state (or provence) to use in the search.
street
string This option contains the state (or provence) to use in the search.
responseCallback
function The callback that handles the response.
-
getAttribution(opts_or_callback, responseCallback){*|undefined} inherited
-
This method performs a request to this configured service using the supplied options, options set on the constructor, and defaults to get the service's attribution, should it have one. This call results in Object, which may be a parsed JSON response.
Name Type Description opts_or_callback
Object | function This parameter contains any options that override options that are set on this object for this particular request.
responseCallback
function This parameter is the function that handles the response.
-
getServiceOptions(options){Object} inherited
-
This method returns the base options that was used to create this Service object and override them with the given options;
Name Type Description options
Object Returns:
The combined options.
-
getURL(opt_options){string} inherited
-
Returns the URL for the service based on the given options, options set on the constructor, and defaults.
Name Type Description options
Object These options override any relevant options that are set on the object at its construction.
-
processResponse(options, obj){Object} inherited
-
This method processes the response from the server before it gives it to the callback. The default is to pass through.
NOTE
This intercept point will only be called if the request was initiated with the
get
call.Name Type Description options
Object The call options combined with the base options used for the call.
obj
Object The object received from the server.