Fork me on GitHub
Show:

AerisBatchModel

Summary

Represents data from multiple Aeris API endpoints combined into a single model.

Note that AerisBatchModel does not currently support per-model actions or queries.

Constructor

aeris.api.models.AerisBatchModel

Syntax

aeris.api.models.AerisBatchModel

(
  • opt_attrs
  • opt_options
)

Summary

Parameters:

  • opt_attrs Object=

    Set models as attribute values to enable batch requests.

  • opt_options Object=

Methods

addFilter

Syntax

addFilter

(
  • filter
  • opt_options
)

Summary

Add a filter to the Aeris API request.

Parameters:

addQuery

Syntax

addQuery

(
  • query
  • opt_options
)

Summary

Add a query term to Aeris API request.

Parameters:

createErrorFromResponse_

Syntax

createErrorFromResponse_

(
  • res
)
Error protected

Summary

Parameters:

Returns:

createParams_

Syntax

createParams_

(
  • opt_params
)
Params protected

Summary

Parameters:

Returns:

encodeModelParams_

Syntax

encodeModelParams_

(
  • model
)
String private

Summary

Parameters:

Returns:

String:

Encoded model params.

encodeParamsString_

Syntax

encodeParamsString_

() private

Summary

fetch

Syntax

fetch

() Promise

Summary

Fetch data from the Aeris API.

Returns:

Promise:

Resolves with API response.

getAction

Syntax

getAction

() String

Summary

Returns:

getApiKeyParams_

Syntax

getApiKeyParams_

() Object private

Summary

Find the Aeris client_id and client_secret params by searching through component models.

Returns:

getEncodedEndpoints_

Syntax

getEncodedEndpoints_

(
  • apiModels
)
String private

Summary

Parameters:

Returns:

getEndpoint

Syntax

getEndpoint

() String

Summary

Returns:

getEndpointUrl_

Syntax

getEndpointUrl_

() String protected

Summary

Returns:

getNestedModels_

Syntax

getNestedModels_

() Array.<AerisApiModel> private

Summary

Return component models, which are attributes of the batch model.

Returns:

getParams

Syntax

getParams

() Params

Summary

Returns the params object used to fetch collection data.

Returns:

getQuery

Syntax

getQuery

() ChainedQueries

Summary

Returns the query for the Aeris API request.

Returns:

isModel_

Syntax

isModel_

(
  • obj
)
Boolean private

Summary

Parameters:

Returns:

isSuccessResponse_

Syntax

isSuccessResponse_

(
  • res
)
Boolean protected

Summary

Parameters:

Returns:

parse

Syntax

parse

(
  • raw
)
Object

Summary

Sets batch response data onto nested models

Parameters:

  • raw Object

    Raw response data.

Returns:

removeApiKeysFromParams_

Syntax

removeApiKeysFromParams_

(
  • serializedParams
)
private

Summary

It is likely that each model contains idential client_id/client_secret params. This will result in the params being serialized into the query string for every model.

For batch queries with many model, this could potentially exceed the url limit.

Parameters:

removeFilter

Syntax

removeFilter

(
  • filter
  • opt_options
)

Summary

Remove a filter from the Aeris API request.

Parameters:

removeQuery

Syntax

removeQuery

(
  • query
  • opt_options
)

Summary

Remove a query from the Aeris API request

Parameters:

resetFilter

Syntax

resetFilter

(
  • opt_filter
  • opt_options
)

Summary

Reset a filter from the Aeris API request.

Parameters:

resetQuery

Syntax

resetQuery

(
  • opt_query
  • opt_options
)

Summary

Resets the query for the Aeris API request.

Parameters:

serializeParams_

Syntax

serializeParams_

(
  • params
)
Object protected

Summary

Parameters:

Returns:

setAction

Syntax

setAction

(
  • action
)

Summary

Parameters:

setBounds

Syntax

setBounds

(
  • bounds
)

Summary

Parameters:

setFrom

Syntax

setFrom

(
  • from
)

Summary

Parameters:

setLimit

Syntax

setLimit

(
  • limit
)

Summary

Parameters:

setParams

Syntax

setParams

(
  • key
  • value
)

Summary

Updates the requests params included with API requests.

Parameters:

  • key String|Object

    Param name. First argument can also. be a key: value hash.

  • value *

    Param value.

setTo

Syntax

setTo

(
  • to
)

Summary

Parameters:

sync

Syntax

sync

() Promise protected

Summary

Overrides Backbone.sync to introduce logic for fetching data from the Aeris API

Note that the AerisAPI is read-only.

Returns:

Promise:

Resolves with response data.

testFilter

Syntax

testFilter

(
  • filter
)
Boolean

Summary

Tests whether a model is passing an Aeris API filter.

Parameters:

Returns:

testFilterCollection

Syntax

testFilterCollection

(
  • filters
)
Boolean

Summary

Tests whether a model is passing a set of Aeris API filters.

Parameters:

Returns:

toJSON

Syntax

toJSON

() Object

Summary

Returns:

updateModelWithResponseData_

Syntax

updateModelWithResponseData_

(
  • model
  • data
)
private

Summary

Parameters:

Properties

endpoint_

Syntax

endpoint_

String private

Summary

Aeris API Endpoints from which to request data.

See http://www.hamweather.com/support/documentation/aeris/endpoints/ for available endpoints, actions, and parameters.

jsonp_

Syntax

jsonp_

aeris.JSONP private

Summary

The JSONP utility for fetching AerisApi data.

modelsInOrder_

Syntax

modelsInOrder_

Array. private

Summary

A list of nested models, in the order of the last API requests.

params_

Syntax

params_

aeris.api.params.models.Params | Object Will be converted to Params instance, if passed in as a plain object. protected

Summary

Parameters to include with the batch request.

Note that parameters can also be attached to individual endpoints defined in this.endpoints_.

server_

Syntax

server_

String private

Summary

The locatin of the aeris API server.

Default: 'http://api.aerisapi.com'

Events

'request'

Syntax

'request'

Summary

A request has been made to fetch data from the Aeris API.

Event Payload:

'sync'

Syntax

'sync'

Summary

The AerisAPI has responsed to a request, and the data object has updated with fetched data.

Event Payload: