Class SolarQueryLocationApi

Generate a URL for adding (merging) datum metadata via a POST request.

Generate a URL for finding the available source IDs for a location or metadata filter.

Get a new DatumFilter configured with parameters of this instance.

This will look for the following parameters:

• nodeIds
• sourceIds

Generate a URL for deleting datum metadata via a DELETE request.

Get an environment parameter.

This is a shortcut for calling Util.Configuration#value on the environment object.

Set an environment parameter.

This is a shortcut for calling Util.Configuration#value on the environment object.

Generate a URL for searching for location metadata.

Generate a URL to find locations based on a search criteria.

Get a URL for just the SolarNet host, without any path to be used for actual requests.

Calls the toRequestUrl() with hostUrl() as the argument.

Get a URL for just the SolarNet host, without any path.

This method constructs an absolute URL based on the following properties configured on this instance's Net.Environment:

1. If environment.useTls() returns true then use HTTPS as the protocol, otherwise HTTP.
2. Use host for the host name or IP address.
3. Use port for the port if available and not the standard 443 for HTTPS or 80 for HTTP.

Get a URL for just the SolarNet host using the WebSocket protocol, without any path.

This method constructs an absolute URL based on the following properties configured on this instance's Net.Environment:

1. If environment.useTls() returns true then use WSS as the protocol, otherwise WS.
2. Use host for the host name or IP address.
3. Use port for the port if available and not the standard 443 for WSS or 80 for WS.

Generate a URL for querying for location datum, in either raw or aggregate form.

If the datumFilter has an aggregate value set, then aggregate results will be returned by SolarNet.

Generate a URL for querying for the most recent datum.

Get a parameter, with plural suffix array support.

This method will first look for a parameter named exactly key, and if found return that. Otherwise it will look for an array parameter named key with s appended, and if found return the first element from that array. For example:

const helper = new UrlHelper();
helper.parameter('nodeIds', [1, 2, 3]);

helper.param('nodeIds'); // [1, 2, 3]
helper.param('nodeId');  // 1
Copy

If key already ends in s, then a desired array result is assumed. If a value is not found for the parameter, then s is removed from key and that parameter value is returned, as an array if it is not already. For example:

const helper = new UrlHelper();
helper.parameter('nodeId', 1);

helper.param('nodeIds'); // [1]
helper.param('nodeId');  // 1
Copy

Get a parameter.

This is a shortcut for calling Util.Configuration#value on the parameters object.

Set a parameter.

This is a shortcut for calling Util.Configuration#value on the parameters object.

Generate a URL for setting datum metadata via a PUT request.

Generate a URL for the "reportable interval" for a location, optionally limited to a specific source ID.

If no source IDs are provided, then the reportable interval query will return an interval for all available sources.

Replace occurances of URL template variables with values from the parameters property and append to the host URL.

This method provides a way to resolve an absolute URL based on the configured environment and parameters on this object.

Replace occurances of URL template variables with values from the parameters property.

URL template variables are specified as {<em>name</em>}. The variable will be replaced by the value associated with property name in the parameters object. The value will be URI encoded.

Get the URL to actually request, incorporating the environment's proxyUrlPrefix if available.

If a environment.proxyUrlPrefix value is configured, this will re-write the URL to use that host prefix, otherwise url will be returned unchanged.

Generate a URL for viewing datum metadata.

If no sourceId is provided, then the API will return all available datum metadata for all sources.

Replace occurances of URL template variables with values from a parameter object.

URL template variables are specified as {<em>name</em>}. The variable will be replaced by the value associated with property name in the provided parameter object. The value will be URI encoded.

Any occurances of // after replacing template variables will be reduced to /.