Class: AWS.Location

var params = {
  DeviceIds: [ /* required */
    'STRING_VALUE',
    /* more items */
  ],
  TrackerName: 'STRING_VALUE' /* required */
};
location.batchDeleteDevicePositionHistory(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • DeviceIds — (Array<String>)

    Devices whose position history you want to delete.

    • For example, for two devices: “DeviceIds” : [DeviceId1,DeviceId2]

  • TrackerName — (String)

    The name of the tracker resource to delete the device position history from.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Errors — (Array<map>)

      Contains error details for each device history that failed to delete.

      • DeviceId — required — (String)

        The ID of the device for this position.

      • Error — required — (map)

        Contains the batch request error details associated with the request.

        • Code — (String)

          The error code associated with the batch request error.

          Possible values include:
          • "AccessDeniedError"
          • "ConflictError"
          • "InternalServerError"
          • "ResourceNotFoundError"
          • "ThrottlingError"
          • "ValidationError"
        • Message — (String)

          A message with the reason for the batch request error.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  CollectionName: 'STRING_VALUE', /* required */
  GeofenceIds: [ /* required */
    'STRING_VALUE',
    /* more items */
  ]
};
location.batchDeleteGeofence(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • CollectionName — (String)

    The geofence collection storing the geofences to be deleted.

  • GeofenceIds — (Array<String>)

    The batch of geofences to be deleted.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Errors — (Array<map>)

      Contains error details for each geofence that failed to delete.

      • Error — required — (map)

        Contains details associated to the batch error.

        • Code — (String)

          The error code associated with the batch request error.

          Possible values include:
          • "AccessDeniedError"
          • "ConflictError"
          • "InternalServerError"
          • "ResourceNotFoundError"
          • "ThrottlingError"
          • "ValidationError"
        • Message — (String)

          A message with the reason for the batch request error.

      • GeofenceId — required — (String)

        The geofence associated with the error message.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  CollectionName: 'STRING_VALUE', /* required */
  DevicePositionUpdates: [ /* required */
    {
      DeviceId: 'STRING_VALUE', /* required */
      Position: [ /* required */
        'NUMBER_VALUE',
        /* more items */
      ],
      SampleTime: new Date || 'Wed Dec 31 1969 16:00:00 GMT-0800 (PST)' || 123456789, /* required */
      Accuracy: {
        Horizontal: 'NUMBER_VALUE' /* required */
      },
      PositionProperties: {
        '<PropertyMapKeyString>': 'STRING_VALUE',
        /* '<PropertyMapKeyString>': ... */
      }
    },
    /* more items */
  ]
};
location.batchEvaluateGeofences(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • CollectionName — (String)

    The geofence collection used in evaluating the position of devices against its geofences.

  • DevicePositionUpdates — (Array<map>)

    Contains device details for each device to be evaluated against the given geofence collection.

    • Accuracy — (map)

      The accuracy of the device position.

      • Horizontal — required — (Float)

        Estimated maximum distance, in meters, between the measured position and the true position of a device, along the Earth's surface.

    • DeviceId — required — (String)

      The device associated to the position update.

    • Position — required — (Array<Float>)

      The latest device position defined in WGS 84 format: [X or longitude, Y or latitude].

    • PositionProperties — (map<String>)

      Associates one of more properties with the position update. A property is a key-value pair stored with the position update and added to any geofence event the update may trigger.

      Format: "key" : "value"

    • SampleTime — required — (Date)

      The timestamp at which the device's position was determined. Uses ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Errors — (Array<map>)

      Contains error details for each device that failed to evaluate its position against the given geofence collection.

      • DeviceId — required — (String)

        The device associated with the position evaluation error.

      • Error — required — (map)

        Contains details associated to the batch error.

        • Code — (String)

          The error code associated with the batch request error.

          Possible values include:
          • "AccessDeniedError"
          • "ConflictError"
          • "InternalServerError"
          • "ResourceNotFoundError"
          • "ThrottlingError"
          • "ValidationError"
        • Message — (String)

          A message with the reason for the batch request error.

      • SampleTime — required — (Date)

        Specifies a timestamp for when the error occurred in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  DeviceIds: [ /* required */
    'STRING_VALUE',
    /* more items */
  ],
  TrackerName: 'STRING_VALUE' /* required */
};
location.batchGetDevicePosition(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • DeviceIds — (Array<String>)

    Devices whose position you want to retrieve.

    • For example, for two devices: device-ids=DeviceId1&device-ids=DeviceId2

  • TrackerName — (String)

    The tracker resource retrieving the device position.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • DevicePositions — (Array<map>)

      Contains device position details such as the device ID, position, and timestamps for when the position was received and sampled.

      • Accuracy — (map)

        The accuracy of the device position.

        • Horizontal — required — (Float)

          Estimated maximum distance, in meters, between the measured position and the true position of a device, along the Earth's surface.

      • DeviceId — (String)

        The device whose position you retrieved.

      • Position — required — (Array<Float>)

        The last known device position.

      • PositionProperties — (map<String>)

        The properties associated with the position.

      • ReceivedTime — required — (Date)

        The timestamp for when the tracker resource received the device position in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

      • SampleTime — required — (Date)

        The timestamp at which the device's position was determined. Uses ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

    • Errors — (Array<map>)

      Contains error details for each device that failed to send its position to the tracker resource.

      • DeviceId — required — (String)

        The ID of the device that didn't return a position.

      • Error — required — (map)

        Contains details related to the error code.

        • Code — (String)

          The error code associated with the batch request error.

          Possible values include:
          • "AccessDeniedError"
          • "ConflictError"
          • "InternalServerError"
          • "ResourceNotFoundError"
          • "ThrottlingError"
          • "ValidationError"
        • Message — (String)

          A message with the reason for the batch request error.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  CollectionName: 'STRING_VALUE', /* required */
  Entries: [ /* required */
    {
      GeofenceId: 'STRING_VALUE', /* required */
      Geometry: { /* required */
        Polygon: [
          [
            [
              'NUMBER_VALUE',
              /* more items */
            ],
            /* more items */
          ],
          /* more items */
        ]
      }
    },
    /* more items */
  ]
};
location.batchPutGeofence(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • CollectionName — (String)

    The geofence collection storing the geofences.

  • Entries — (Array<map>)

    The batch of geofences to be stored in a geofence collection.

    • GeofenceId — required — (String)

      The identifier for the geofence to be stored in a given geofence collection.

    • Geometry — required — (map)

      Contains the polygon details to specify the position of the geofence.

      Note: Each geofence polygon can have a maximum of 1,000 vertices.
      • Polygon — (Array<Array<Array<Float>>>)

        An array of 1 or more linear rings. A linear ring is an array of 4 or more vertices, where the first and last vertex are the same to form a closed boundary. Each vertex is a 2-dimensional point of the form: [longitude, latitude].

        The first linear ring is an outer ring, describing the polygon's boundary. Subsequent linear rings may be inner or outer rings to describe holes and islands. Outer rings must list their vertices in counter-clockwise order around the ring's center, where the left side is the polygon's exterior. Inner rings must list their vertices in clockwise order, where the left side is the polygon's interior.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Errors — (Array<map>)

      Contains additional error details for each geofence that failed to be stored in a geofence collection.

      • Error — required — (map)

        Contains details associated to the batch error.

        • Code — (String)

          The error code associated with the batch request error.

          Possible values include:
          • "AccessDeniedError"
          • "ConflictError"
          • "InternalServerError"
          • "ResourceNotFoundError"
          • "ThrottlingError"
          • "ValidationError"
        • Message — (String)

          A message with the reason for the batch request error.

      • GeofenceId — required — (String)

        The geofence associated with the error message.

    • Successes — (Array<map>)

      Contains each geofence that was successfully stored in a geofence collection.

      • CreateTime — required — (Date)

        The timestamp for when the geofence was stored in a geofence collection in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ

      • GeofenceId — required — (String)

        The geofence successfully stored in a geofence collection.

      • UpdateTime — required — (Date)

        The timestamp for when the geofence was last updated in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  TrackerName: 'STRING_VALUE', /* required */
  Updates: [ /* required */
    {
      DeviceId: 'STRING_VALUE', /* required */
      Position: [ /* required */
        'NUMBER_VALUE',
        /* more items */
      ],
      SampleTime: new Date || 'Wed Dec 31 1969 16:00:00 GMT-0800 (PST)' || 123456789, /* required */
      Accuracy: {
        Horizontal: 'NUMBER_VALUE' /* required */
      },
      PositionProperties: {
        '<PropertyMapKeyString>': 'STRING_VALUE',
        /* '<PropertyMapKeyString>': ... */
      }
    },
    /* more items */
  ]
};
location.batchUpdateDevicePosition(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • TrackerName — (String)

    The name of the tracker resource to update.

  • Updates — (Array<map>)

    Contains the position update details for each device.

    • Accuracy — (map)

      The accuracy of the device position.

      • Horizontal — required — (Float)

        Estimated maximum distance, in meters, between the measured position and the true position of a device, along the Earth's surface.

    • DeviceId — required — (String)

      The device associated to the position update.

    • Position — required — (Array<Float>)

      The latest device position defined in WGS 84 format: [X or longitude, Y or latitude].

    • PositionProperties — (map<String>)

      Associates one of more properties with the position update. A property is a key-value pair stored with the position update and added to any geofence event the update may trigger.

      Format: "key" : "value"

    • SampleTime — required — (Date)

      The timestamp at which the device's position was determined. Uses ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Errors — (Array<map>)

      Contains error details for each device that failed to update its position.

      • DeviceId — required — (String)

        The device associated with the failed location update.

      • Error — required — (map)

        Contains details related to the error code such as the error code and error message.

        • Code — (String)

          The error code associated with the batch request error.

          Possible values include:
          • "AccessDeniedError"
          • "ConflictError"
          • "InternalServerError"
          • "ResourceNotFoundError"
          • "ThrottlingError"
          • "ValidationError"
        • Message — (String)

          A message with the reason for the batch request error.

      • SampleTime — required — (Date)

        The timestamp at which the device position was determined. Uses ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  CalculatorName: 'STRING_VALUE', /* required */
  DeparturePosition: [ /* required */
    'NUMBER_VALUE',
    /* more items */
  ],
  DestinationPosition: [ /* required */
    'NUMBER_VALUE',
    /* more items */
  ],
  CarModeOptions: {
    AvoidFerries: true || false,
    AvoidTolls: true || false
  },
  DepartNow: true || false,
  DepartureTime: new Date || 'Wed Dec 31 1969 16:00:00 GMT-0800 (PST)' || 123456789,
  DistanceUnit: Kilometers | Miles,
  IncludeLegGeometry: true || false,
  TravelMode: Car | Truck | Walking,
  TruckModeOptions: {
    AvoidFerries: true || false,
    AvoidTolls: true || false,
    Dimensions: {
      Height: 'NUMBER_VALUE',
      Length: 'NUMBER_VALUE',
      Unit: Meters | Feet,
      Width: 'NUMBER_VALUE'
    },
    Weight: {
      Total: 'NUMBER_VALUE',
      Unit: Kilograms | Pounds
    }
  },
  WaypointPositions: [
    [
      'NUMBER_VALUE',
      /* more items */
    ],
    /* more items */
  ]
};
location.calculateRoute(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • CalculatorName — (String)

    The name of the route calculator resource that you want to use to calculate the route.

  • CarModeOptions — (map)

    Specifies route preferences when traveling by Car, such as avoiding routes that use ferries or tolls.

    Requirements: TravelMode must be specified as Car.

    • AvoidFerries — (Boolean)

      Avoids ferries when calculating routes.

      Default Value: false

      Valid Values: false | true

    • AvoidTolls — (Boolean)

      Avoids tolls when calculating routes.

      Default Value: false

      Valid Values: false | true

  • DepartNow — (Boolean)

    Sets the time of departure as the current time. Uses the current time to calculate a route. Otherwise, the best time of day to travel with the best traffic conditions is used to calculate the route.

    Default Value: false

    Valid Values: false | true

  • DeparturePosition — (Array<Float>)

    The start position for the route. Defined in World Geodetic System (WGS 84) format: [longitude, latitude].

    • For example, [-123.115, 49.285]

    Note: If you specify a departure that's not located on a road, Amazon Location moves the position to the nearest road. If Esri is the provider for your route calculator, specifying a route that is longer than 400 km returns a 400 RoutesValidationException error.

    Valid Values: [-180 to 180,-90 to 90]

  • DepartureTime — (Date)

    Specifies the desired time of departure. Uses the given time to calculate the route. Otherwise, the best time of day to travel with the best traffic conditions is used to calculate the route.

    Note: Setting a departure time in the past returns a 400 ValidationException error.

    • In ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ. For example, 2020–07-2T12:15:20.000Z+01:00

  • DestinationPosition — (Array<Float>)

    The finish position for the route. Defined in World Geodetic System (WGS 84) format: [longitude, latitude].

    • For example, [-122.339, 47.615]

    Note: If you specify a destination that's not located on a road, Amazon Location moves the position to the nearest road.

    Valid Values: [-180 to 180,-90 to 90]

  • DistanceUnit — (String)

    Set the unit system to specify the distance.

    Default Value: Kilometers

    Possible values include:
    • "Kilometers"
    • "Miles"
  • IncludeLegGeometry — (Boolean)

    Set to include the geometry details in the result for each path between a pair of positions.

    Default Value: false

    Valid Values: false | true

  • TravelMode — (String)

    Specifies the mode of transport when calculating a route. Used in estimating the speed of travel and road compatibility.

    The TravelMode you specify also determines how you specify route preferences:

    • If traveling by Car use the CarModeOptions parameter.

    • If traveling by Truck use the TruckModeOptions parameter.

    Default Value: Car

    Possible values include:
    • "Car"
    • "Truck"
    • "Walking"
  • TruckModeOptions — (map)

    Specifies route preferences when traveling by Truck, such as avoiding routes that use ferries or tolls, and truck specifications to consider when choosing an optimal road.

    Requirements: TravelMode must be specified as Truck.

    • AvoidFerries — (Boolean)

      Avoids ferries when calculating routes.

      Default Value: false

      Valid Values: false | true

    • AvoidTolls — (Boolean)

      Avoids tolls when calculating routes.

      Default Value: false

      Valid Values: false | true

    • Dimensions — (map)

      Specifies the truck's dimension specifications including length, height, width, and unit of measurement. Used to avoid roads that can't support the truck's dimensions.

      • Height — (Float)

        The height of the truck.

        • For example, 4.5.

      • Length — (Float)

        The length of the truck.

        • For example, 15.5.

      • Unit — (String)

        Specifies the unit of measurement for the truck dimensions.

        Default Value: Meters

        Possible values include:
        • "Meters"
        • "Feet"
      • Width — (Float)

        The width of the truck.

        • For example, 4.5.

    • Weight — (map)

      Specifies the truck's weight specifications including total weight and unit of measurement. Used to avoid roads that can't support the truck's weight.

      • Total — (Float)

        The total weight of the truck.

        • For example, 3500.

      • Unit — (String)

        The unit of measurement to use for the truck weight.

        Default Value: Kilograms

        Possible values include:
        • "Kilograms"
        • "Pounds"
  • WaypointPositions — (Array<Array<Float>>)

    Specifies an ordered list of up to 23 intermediate positions to include along a route between the departure position and destination position.

    • For example, from the DeparturePosition [-123.115, 49.285], the route follows the order that the waypoint positions are given [[-122.757, 49.0021],[-122.349, 47.620]]

    Note: If you specify a waypoint position that's not located on a road, Amazon Location moves the position to the nearest road. Specifying more than 23 waypoints returns a 400 ValidationException error. If Esri is the provider for your route calculator, specifying a route that is longer than 400 km returns a 400 RoutesValidationException error.

    Valid Values: [-180 to 180,-90 to 90]

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Legs — (Array<map>)

      Contains details about each path between a pair of positions included along a route such as: StartPosition, EndPosition, Distance, DurationSeconds, Geometry, and Steps. The number of legs returned corresponds to one fewer than the total number of positions in the request.

      For example, a route with a departure position and destination position returns one leg with the positions snapped to a nearby road:

      • The StartPosition is the departure position.

      • The EndPosition is the destination position.

      A route with a waypoint between the departure and destination position returns two legs with the positions snapped to a nearby road:

      • Leg 1: The StartPosition is the departure position . The EndPosition is the waypoint positon.

      • Leg 2: The StartPosition is the waypoint position. The EndPosition is the destination position.

      • Distance — required — (Float)

        The distance between the leg's StartPosition and EndPosition along a calculated route.

        • The default measurement is Kilometers unless the request specifies a DistanceUnit of Miles.

      • DurationSeconds — required — (Float)

        The estimated travel time between the leg's StartPosition and EndPosition. The travel mode and departure time that you specify in the request determines the calculated time.

      • EndPosition — required — (Array<Float>)

        The terminating position of the leg. Follows the format [longitude,latitude].

        Note: If the EndPosition isn't located on a road, it's snapped to a nearby road.
      • Geometry — (map)

        Contains the calculated route's path as a linestring geometry.

        • LineString — (Array<Array<Float>>)

          An ordered list of positions used to plot a route on a map.

          The first position is closest to the start position for the leg, and the last position is the closest to the end position for the leg.

          • For example, [[-123.117, 49.284],[-123.115, 49.285],[-123.115, 49.285]]

      • StartPosition — required — (Array<Float>)

        The starting position of the leg. Follows the format [longitude,latitude].

        Note: If the StartPosition isn't located on a road, it's snapped to a nearby road.
      • Steps — required — (Array<map>)

        Contains a list of steps, which represent subsections of a leg. Each step provides instructions for how to move to the next step in the leg such as the step's start position, end position, travel distance, travel duration, and geometry offset.

        • Distance — required — (Float)

          The travel distance between the step's StartPosition and EndPosition.

        • DurationSeconds — required — (Float)

          The estimated travel time, in seconds, from the step's StartPosition to the EndPosition. . The travel mode and departure time that you specify in the request determines the calculated time.

        • EndPosition — required — (Array<Float>)

          The end position of a step. If the position the last step in the leg, this position is the same as the end position of the leg.

        • GeometryOffset — (Integer)

          Represents the start position, or index, in a sequence of steps within the leg's line string geometry. For example, the index of the first step in a leg geometry is 0.

          Included in the response for queries that set IncludeLegGeometry to True.

        • StartPosition — required — (Array<Float>)

          The starting position of a step. If the position is the first step in the leg, this position is the same as the start position of the leg.

    • Summary — (map)

      Contains information about the whole route, such as: RouteBBox, DataSource, Distance, DistanceUnit, and DurationSeconds.

      • DataSource — required — (String)

        The data provider of traffic and road network data used to calculate the route. Indicates one of the available providers:

        • Esri

        • Here

        For more information about data providers, see Amazon Location Service data providers.

      • Distance — required — (Float)

        The total distance covered by the route. The sum of the distance travelled between every stop on the route.

        Note: If Esri is the data source for the route calculator, the route distance can’t be greater than 400 km. If the route exceeds 400 km, the response is a 400 RoutesValidationException error.
      • DistanceUnit — required — (String)

        The unit of measurement for route distances.

        Possible values include:
        • "Kilometers"
        • "Miles"
      • DurationSeconds — required — (Float)

        The total travel time for the route measured in seconds. The sum of the travel time between every stop on the route.

      • RouteBBox — required — (Array<Float>)

        Specifies a geographical box surrounding a route. Used to zoom into a route when displaying it in a map. For example, [min x, min y, max x, max y].

        The first 2 bbox parameters describe the lower southwest corner:

        • The first bbox position is the X coordinate or longitude of the lower southwest corner.

        • The second bbox position is the Y coordinate or latitude of the lower southwest corner.

        The next 2 bbox parameters describe the upper northeast corner:

        • The third bbox position is the X coordinate, or longitude of the upper northeast corner.

        • The fourth bbox position is the Y coordinate, or latitude of the upper northeast corner.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  CalculatorName: 'STRING_VALUE', /* required */
  DeparturePositions: [ /* required */
    [
      'NUMBER_VALUE',
      /* more items */
    ],
    /* more items */
  ],
  DestinationPositions: [ /* required */
    [
      'NUMBER_VALUE',
      /* more items */
    ],
    /* more items */
  ],
  CarModeOptions: {
    AvoidFerries: true || false,
    AvoidTolls: true || false
  },
  DepartNow: true || false,
  DepartureTime: new Date || 'Wed Dec 31 1969 16:00:00 GMT-0800 (PST)' || 123456789,
  DistanceUnit: Kilometers | Miles,
  TravelMode: Car | Truck | Walking,
  TruckModeOptions: {
    AvoidFerries: true || false,
    AvoidTolls: true || false,
    Dimensions: {
      Height: 'NUMBER_VALUE',
      Length: 'NUMBER_VALUE',
      Unit: Meters | Feet,
      Width: 'NUMBER_VALUE'
    },
    Weight: {
      Total: 'NUMBER_VALUE',
      Unit: Kilograms | Pounds
    }
  }
};
location.calculateRouteMatrix(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • CalculatorName — (String)

    The name of the route calculator resource that you want to use to calculate the route matrix.

  • CarModeOptions — (map)

    Specifies route preferences when traveling by Car, such as avoiding routes that use ferries or tolls.

    Requirements: TravelMode must be specified as Car.

    • AvoidFerries — (Boolean)

      Avoids ferries when calculating routes.

      Default Value: false

      Valid Values: false | true

    • AvoidTolls — (Boolean)

      Avoids tolls when calculating routes.

      Default Value: false

      Valid Values: false | true

  • DepartNow — (Boolean)

    Sets the time of departure as the current time. Uses the current time to calculate the route matrix. You can't set both DepartureTime and DepartNow. If neither is set, the best time of day to travel with the best traffic conditions is used to calculate the route matrix.

    Default Value: false

    Valid Values: false | true

  • DeparturePositions — (Array<Array<Float>>)

    The list of departure (origin) positions for the route matrix. An array of points, each of which is itself a 2-value array defined in WGS 84 format: [longitude, latitude]. For example, [-123.115, 49.285].

    Depending on the data provider selected in the route calculator resource there may be additional restrictions on the inputs you can choose. See Position restrictions in the Amazon Location Service Developer Guide.

    Note: For route calculators that use Esri as the data provider, if you specify a departure that's not located on a road, Amazon Location moves the position to the nearest road. The snapped value is available in the result in SnappedDeparturePositions.

    Valid Values: [-180 to 180,-90 to 90]

  • DepartureTime — (Date)

    Specifies the desired time of departure. Uses the given time to calculate the route matrix. You can't set both DepartureTime and DepartNow. If neither is set, the best time of day to travel with the best traffic conditions is used to calculate the route matrix.

    Note: Setting a departure time in the past returns a 400 ValidationException error.

    • In ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ. For example, 2020–07-2T12:15:20.000Z+01:00

  • DestinationPositions — (Array<Array<Float>>)

    The list of destination positions for the route matrix. An array of points, each of which is itself a 2-value array defined in WGS 84 format: [longitude, latitude]. For example, [-122.339, 47.615]

    Depending on the data provider selected in the route calculator resource there may be additional restrictions on the inputs you can choose. See Position restrictions in the Amazon Location Service Developer Guide.

    Note: For route calculators that use Esri as the data provider, if you specify a destination that's not located on a road, Amazon Location moves the position to the nearest road. The snapped value is available in the result in SnappedDestinationPositions.

    Valid Values: [-180 to 180,-90 to 90]

  • DistanceUnit — (String)

    Set the unit system to specify the distance.

    Default Value: Kilometers

    Possible values include:
    • "Kilometers"
    • "Miles"
  • TravelMode — (String)

    Specifies the mode of transport when calculating a route. Used in estimating the speed of travel and road compatibility.

    The TravelMode you specify also determines how you specify route preferences:

    • If traveling by Car use the CarModeOptions parameter.

    • If traveling by Truck use the TruckModeOptions parameter.

    Default Value: Car

    Possible values include:
    • "Car"
    • "Truck"
    • "Walking"
  • TruckModeOptions — (map)

    Specifies route preferences when traveling by Truck, such as avoiding routes that use ferries or tolls, and truck specifications to consider when choosing an optimal road.

    Requirements: TravelMode must be specified as Truck.

    • AvoidFerries — (Boolean)

      Avoids ferries when calculating routes.

      Default Value: false

      Valid Values: false | true

    • AvoidTolls — (Boolean)

      Avoids tolls when calculating routes.

      Default Value: false

      Valid Values: false | true

    • Dimensions — (map)

      Specifies the truck's dimension specifications including length, height, width, and unit of measurement. Used to avoid roads that can't support the truck's dimensions.

      • Height — (Float)

        The height of the truck.

        • For example, 4.5.

      • Length — (Float)

        The length of the truck.

        • For example, 15.5.

      • Unit — (String)

        Specifies the unit of measurement for the truck dimensions.

        Default Value: Meters

        Possible values include:
        • "Meters"
        • "Feet"
      • Width — (Float)

        The width of the truck.

        • For example, 4.5.

    • Weight — (map)

      Specifies the truck's weight specifications including total weight and unit of measurement. Used to avoid roads that can't support the truck's weight.

      • Total — (Float)

        The total weight of the truck.

        • For example, 3500.

      • Unit — (String)

        The unit of measurement to use for the truck weight.

        Default Value: Kilograms

        Possible values include:
        • "Kilograms"
        • "Pounds"

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • RouteMatrix — (Array<Array<map>>)

      The calculated route matrix containing the results for all pairs of DeparturePositions to DestinationPositions. Each row corresponds to one entry in DeparturePositions. Each entry in the row corresponds to the route from that entry in DeparturePositions to an entry in DestinationPositions.

      • Distance — (Float)

        The total distance of travel for the route.

      • DurationSeconds — (Float)

        The expected duration of travel for the route.

      • Error — (map)

        An error corresponding to the calculation of a route between the DeparturePosition and DestinationPosition.

        • Code — required — (String)

          The type of error which occurred for the route calculation.

          Possible values include:
          • "RouteNotFound"
          • "RouteTooLong"
          • "PositionsNotFound"
          • "DestinationPositionNotFound"
          • "DeparturePositionNotFound"
          • "OtherValidationError"
        • Message — (String)

          A message about the error that occurred for the route calculation.

    • SnappedDeparturePositions — (Array<Array<Float>>)

      For routes calculated using an Esri route calculator resource, departure positions are snapped to the closest road. For Esri route calculator resources, this returns the list of departure/origin positions used for calculation of the RouteMatrix.

    • SnappedDestinationPositions — (Array<Array<Float>>)

      The list of destination positions for the route matrix used for calculation of the RouteMatrix.

    • Summary — (map)

      Contains information about the route matrix, DataSource, DistanceUnit, RouteCount and ErrorCount.

      • DataSource — required — (String)

        The data provider of traffic and road network data used to calculate the routes. Indicates one of the available providers:

        • Esri

        • Here

        For more information about data providers, see Amazon Location Service data providers.

      • DistanceUnit — required — (String)

        The unit of measurement for route distances.

        Possible values include:
        • "Kilometers"
        • "Miles"
      • ErrorCount — required — (Integer)

        The count of error results in the route matrix. If this number is 0, all routes were calculated successfully.

      • RouteCount — required — (Integer)

        The count of cells in the route matrix. Equal to the number of DeparturePositions multiplied by the number of DestinationPositions.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  CollectionName: 'STRING_VALUE', /* required */
  Description: 'STRING_VALUE',
  KmsKeyId: 'STRING_VALUE',
  PricingPlan: RequestBasedUsage | MobileAssetTracking | MobileAssetManagement,
  PricingPlanDataSource: 'STRING_VALUE',
  Tags: {
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
location.createGeofenceCollection(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • CollectionName — (String)

    A custom name for the geofence collection.

    Requirements:

    • Contain only alphanumeric characters (A–Z, a–z, 0–9), hyphens (-), periods (.), and underscores (_).

    • Must be a unique geofence collection name.

    • No spaces allowed. For example, ExampleGeofenceCollection.

  • Description — (String)

    An optional description for the geofence collection.

  • KmsKeyId — (String)

    A key identifier for an AWS KMS customer managed key. Enter a key ID, key ARN, alias name, or alias ARN.

  • PricingPlan — (String)

    No longer used. If included, the only allowed value is RequestBasedUsage.

    Possible values include:
    • "RequestBasedUsage"
    • "MobileAssetTracking"
    • "MobileAssetManagement"
  • PricingPlanDataSource — (String)

    This parameter is no longer used.

  • Tags — (map<String>)

    Applies one or more tags to the geofence collection. A tag is a key-value pair helps manage, identify, search, and filter your resources by labelling them.

    Format: "key" : "value"

    Restrictions:

    • Maximum 50 tags per resource

    • Each resource tag must be unique with a maximum of one value.

    • Maximum key length: 128 Unicode characters in UTF-8

    • Maximum value length: 256 Unicode characters in UTF-8

    • Can use alphanumeric characters (A–Z, a–z, 0–9), and the following characters: + - = . _ : / @.

    • Cannot use "aws:" as a prefix for a key.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • CollectionArn — (String)

      The Amazon Resource Name (ARN) for the geofence collection resource. Used when you need to specify a resource across all AWS.

      • Format example: arn:aws:geo:region:account-id:geofence-collection/ExampleGeofenceCollection

    • CollectionName — (String)

      The name for the geofence collection.

    • CreateTime — (Date)

      The timestamp for when the geofence collection was created in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  Configuration: { /* required */
    Style: 'STRING_VALUE' /* required */
  },
  MapName: 'STRING_VALUE', /* required */
  Description: 'STRING_VALUE',
  PricingPlan: RequestBasedUsage | MobileAssetTracking | MobileAssetManagement,
  Tags: {
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
location.createMap(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • Configuration — (map)

    Specifies the map style selected from an available data provider.

    • Style — required — (String)

      Specifies the map style selected from an available data provider.

      Valid Esri map styles:

      • VectorEsriDarkGrayCanvas – The Esri Dark Gray Canvas map style. A vector basemap with a dark gray, neutral background with minimal colors, labels, and features that's designed to draw attention to your thematic content.

      • RasterEsriImagery – The Esri Imagery map style. A raster basemap that provides one meter or better satellite and aerial imagery in many parts of the world and lower resolution satellite imagery worldwide.

      • VectorEsriLightGrayCanvas – The Esri Light Gray Canvas map style, which provides a detailed vector basemap with a light gray, neutral background style with minimal colors, labels, and features that's designed to draw attention to your thematic content.

      • VectorEsriTopographic – The Esri Light map style, which provides a detailed vector basemap with a classic Esri map style.

      • VectorEsriStreets – The Esri World Streets map style, which provides a detailed vector basemap for the world symbolized with a classic Esri street map style. The vector tile layer is similar in content and style to the World Street Map raster map.

      • VectorEsriNavigation – The Esri World Navigation map style, which provides a detailed basemap for the world symbolized with a custom navigation map style that's designed for use during the day in mobile devices.

      Valid HERE Technologies map styles:

      • VectorHereBerlin – The HERE Berlin map style is a high contrast detailed base map of the world that blends 3D and 2D rendering.

      • VectorHereExplore – A default HERE map style containing a neutral, global map and its features including roads, buildings, landmarks, and water features. It also now includes a fully designed map of Japan.

      • VectorHereExploreTruck – A global map containing truck restrictions and attributes (e.g. width / height / HAZMAT) symbolized with highlighted segments and icons on top of HERE Explore to support use cases within transport and logistics.

  • Description — (String)

    An optional description for the map resource.

  • MapName — (String)

    The name for the map resource.

    Requirements:

    • Must contain only alphanumeric characters (A–Z, a–z, 0–9), hyphens (-), periods (.), and underscores (_).

    • Must be a unique map resource name.

    • No spaces allowed. For example, ExampleMap.

  • PricingPlan — (String)

    No longer used. If included, the only allowed value is RequestBasedUsage.

    Possible values include:
    • "RequestBasedUsage"
    • "MobileAssetTracking"
    • "MobileAssetManagement"
  • Tags — (map<String>)

    Applies one or more tags to the map resource. A tag is a key-value pair helps manage, identify, search, and filter your resources by labelling them.

    Format: "key" : "value"

    Restrictions:

    • Maximum 50 tags per resource

    • Each resource tag must be unique with a maximum of one value.

    • Maximum key length: 128 Unicode characters in UTF-8

    • Maximum value length: 256 Unicode characters in UTF-8

    • Can use alphanumeric characters (A–Z, a–z, 0–9), and the following characters: + - = . _ : / @.

    • Cannot use "aws:" as a prefix for a key.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • CreateTime — (Date)

      The timestamp for when the map resource was created in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

    • MapArn — (String)

      The Amazon Resource Name (ARN) for the map resource. Used to specify a resource across all AWS.

      • Format example: arn:aws:geo:region:account-id:maps/ExampleMap

    • MapName — (String)

      The name of the map resource.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  DataSource: 'STRING_VALUE', /* required */
  IndexName: 'STRING_VALUE', /* required */
  DataSourceConfiguration: {
    IntendedUse: SingleUse | Storage
  },
  Description: 'STRING_VALUE',
  PricingPlan: RequestBasedUsage | MobileAssetTracking | MobileAssetManagement,
  Tags: {
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
location.createPlaceIndex(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • DataSource — (String)

    Specifies the geospatial data provider for the new place index.

    Note: This field is case-sensitive. Enter the valid values as shown. For example, entering HERE returns an error.

    Valid values include:

    • Esri – For additional information about Esri's coverage in your region of interest, see Esri details on geocoding coverage.

    • Here – For additional information about HERE Technologies' coverage in your region of interest, see HERE details on goecoding coverage.

      If you specify HERE Technologies (Here) as the data provider, you may not store results for locations in Japan. For more information, see the AWS Service Terms for Amazon Location Service.

    For additional information , see Data providers on the Amazon Location Service Developer Guide.

  • DataSourceConfiguration — (map)

    Specifies the data storage option requesting Places.

    • IntendedUse — (String)

      Specifies how the results of an operation will be stored by the caller.

      Valid values include:

      • SingleUse specifies that the results won't be stored.

      • Storage specifies that the result can be cached or stored in a database.

      Default value: SingleUse

      Possible values include:
      • "SingleUse"
      • "Storage"
  • Description — (String)

    The optional description for the place index resource.

  • IndexName — (String)

    The name of the place index resource.

    Requirements:

    • Contain only alphanumeric characters (A–Z, a–z, 0–9), hyphens (-), periods (.), and underscores (_).

    • Must be a unique place index resource name.

    • No spaces allowed. For example, ExamplePlaceIndex.

  • PricingPlan — (String)

    No longer used. If included, the only allowed value is RequestBasedUsage.

    Possible values include:
    • "RequestBasedUsage"
    • "MobileAssetTracking"
    • "MobileAssetManagement"
  • Tags — (map<String>)

    Applies one or more tags to the place index resource. A tag is a key-value pair that helps you manage, identify, search, and filter your resources.

    Format: "key" : "value"

    Restrictions:

    • Maximum 50 tags per resource.

    • Each tag key must be unique and must have exactly one associated value.

    • Maximum key length: 128 Unicode characters in UTF-8.

    • Maximum value length: 256 Unicode characters in UTF-8.

    • Can use alphanumeric characters (A–Z, a–z, 0–9), and the following characters: + - = . _ : / @

    • Cannot use "aws:" as a prefix for a key.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • CreateTime — (Date)

      The timestamp for when the place index resource was created in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

    • IndexArn — (String)

      The Amazon Resource Name (ARN) for the place index resource. Used to specify a resource across AWS.

      • Format example: arn:aws:geo:region:account-id:place-index/ExamplePlaceIndex

    • IndexName — (String)

      The name for the place index resource.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  CalculatorName: 'STRING_VALUE', /* required */
  DataSource: 'STRING_VALUE', /* required */
  Description: 'STRING_VALUE',
  PricingPlan: RequestBasedUsage | MobileAssetTracking | MobileAssetManagement,
  Tags: {
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
location.createRouteCalculator(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • CalculatorName — (String)

    The name of the route calculator resource.

    Requirements:

    • Can use alphanumeric characters (A–Z, a–z, 0–9) , hyphens (-), periods (.), and underscores (_).

    • Must be a unique Route calculator resource name.

    • No spaces allowed. For example, ExampleRouteCalculator.

  • DataSource — (String)

    Specifies the data provider of traffic and road network data.

    Note: This field is case-sensitive. Enter the valid values as shown. For example, entering HERE returns an error. Route calculators that use Esri as a data source only calculate routes that are shorter than 400 km.

    Valid values include:

    • Esri – For additional information about Esri's coverage in your region of interest, see Esri details on street networks and traffic coverage.

    • Here – For additional information about HERE Technologies' coverage in your region of interest, see HERE car routing coverage and HERE truck routing coverage.

    For additional information , see Data providers on the Amazon Location Service Developer Guide.

  • Description — (String)

    The optional description for the route calculator resource.

  • PricingPlan — (String)

    No longer used. If included, the only allowed value is RequestBasedUsage.

    Possible values include:
    • "RequestBasedUsage"
    • "MobileAssetTracking"
    • "MobileAssetManagement"
  • Tags — (map<String>)

    Applies one or more tags to the route calculator resource. A tag is a key-value pair helps manage, identify, search, and filter your resources by labelling them.

    • For example: { "tag1" : "value1", "tag2" : "value2"}

    Format: "key" : "value"

    Restrictions:

    • Maximum 50 tags per resource

    • Each resource tag must be unique with a maximum of one value.

    • Maximum key length: 128 Unicode characters in UTF-8

    • Maximum value length: 256 Unicode characters in UTF-8

    • Can use alphanumeric characters (A–Z, a–z, 0–9), and the following characters: + - = . _ : / @.

    • Cannot use "aws:" as a prefix for a key.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • CalculatorArn — (String)

      The Amazon Resource Name (ARN) for the route calculator resource. Use the ARN when you specify a resource across all AWS.

      • Format example: arn:aws:geo:region:account-id:route-calculator/ExampleCalculator

    • CalculatorName — (String)

      The name of the route calculator resource.

      • For example, ExampleRouteCalculator.

    • CreateTime — (Date)

      The timestamp when the route calculator resource was created in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

      • For example, 2020–07-2T12:15:20.000Z+01:00

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  TrackerName: 'STRING_VALUE', /* required */
  Description: 'STRING_VALUE',
  KmsKeyId: 'STRING_VALUE',
  PositionFiltering: TimeBased | DistanceBased | AccuracyBased,
  PricingPlan: RequestBasedUsage | MobileAssetTracking | MobileAssetManagement,
  PricingPlanDataSource: 'STRING_VALUE',
  Tags: {
    '<TagKey>': 'STRING_VALUE',
    /* '<TagKey>': ... */
  }
};
location.createTracker(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • Description — (String)

    An optional description for the tracker resource.

  • KmsKeyId — (String)

    A key identifier for an AWS KMS customer managed key. Enter a key ID, key ARN, alias name, or alias ARN.

  • PositionFiltering — (String)

    Specifies the position filtering for the tracker resource.

    Valid values:

    • TimeBased - Location updates are evaluated against linked geofence collections, but not every location update is stored. If your update frequency is more often than 30 seconds, only one update per 30 seconds is stored for each unique device ID.

    • DistanceBased - If the device has moved less than 30 m (98.4 ft), location updates are ignored. Location updates within this area are neither evaluated against linked geofence collections, nor stored. This helps control costs by reducing the number of geofence evaluations and historical device positions to paginate through. Distance-based filtering can also reduce the effects of GPS noise when displaying device trajectories on a map.

    • AccuracyBased - If the device has moved less than the measured accuracy, location updates are ignored. For example, if two consecutive updates from a device have a horizontal accuracy of 5 m and 10 m, the second update is ignored if the device has moved less than 15 m. Ignored location updates are neither evaluated against linked geofence collections, nor stored. This can reduce the effects of GPS noise when displaying device trajectories on a map, and can help control your costs by reducing the number of geofence evaluations.

    This field is optional. If not specified, the default value is TimeBased.

    Possible values include:
    • "TimeBased"
    • "DistanceBased"
    • "AccuracyBased"
  • PricingPlan — (String)

    No longer used. If included, the only allowed value is RequestBasedUsage.

    Possible values include:
    • "RequestBasedUsage"
    • "MobileAssetTracking"
    • "MobileAssetManagement"
  • PricingPlanDataSource — (String)

    This parameter is no longer used.

  • Tags — (map<String>)

    Applies one or more tags to the tracker resource. A tag is a key-value pair helps manage, identify, search, and filter your resources by labelling them.

    Format: "key" : "value"

    Restrictions:

    • Maximum 50 tags per resource

    • Each resource tag must be unique with a maximum of one value.

    • Maximum key length: 128 Unicode characters in UTF-8

    • Maximum value length: 256 Unicode characters in UTF-8

    • Can use alphanumeric characters (A–Z, a–z, 0–9), and the following characters: + - = . _ : / @.

    • Cannot use "aws:" as a prefix for a key.

  • TrackerName — (String)

    The name for the tracker resource.

    Requirements:

    • Contain only alphanumeric characters (A-Z, a-z, 0-9) , hyphens (-), periods (.), and underscores (_).

    • Must be a unique tracker resource name.

    • No spaces allowed. For example, ExampleTracker.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • CreateTime — (Date)

      The timestamp for when the tracker resource was created in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

    • TrackerArn — (String)

      The Amazon Resource Name (ARN) for the tracker resource. Used when you need to specify a resource across all AWS.

      • Format example: arn:aws:geo:region:account-id:tracker/ExampleTracker

    • TrackerName — (String)

      The name of the tracker resource.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  CollectionName: 'STRING_VALUE' /* required */
};
location.deleteGeofenceCollection(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • CollectionName — (String)

    The name of the geofence collection to be deleted.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  MapName: 'STRING_VALUE' /* required */
};
location.deleteMap(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • MapName — (String)

    The name of the map resource to be deleted.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  IndexName: 'STRING_VALUE' /* required */
};
location.deletePlaceIndex(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • IndexName — (String)

    The name of the place index resource to be deleted.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  CalculatorName: 'STRING_VALUE' /* required */
};
location.deleteRouteCalculator(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • CalculatorName — (String)

    The name of the route calculator resource to be deleted.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  TrackerName: 'STRING_VALUE' /* required */
};
location.deleteTracker(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • TrackerName — (String)

    The name of the tracker resource to be deleted.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  CollectionName: 'STRING_VALUE' /* required */
};
location.describeGeofenceCollection(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • CollectionName — (String)

    The name of the geofence collection.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • CollectionArn — (String)

      The Amazon Resource Name (ARN) for the geofence collection resource. Used when you need to specify a resource across all AWS.

      • Format example: arn:aws:geo:region:account-id:geofence-collection/ExampleGeofenceCollection

    • CollectionName — (String)

      The name of the geofence collection.

    • CreateTime — (Date)

      The timestamp for when the geofence resource was created in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ

    • Description — (String)

      The optional description for the geofence collection.

    • KmsKeyId — (String)

      A key identifier for an AWS KMS customer managed key assigned to the Amazon Location resource

    • PricingPlan — (String)

      No longer used. Always returns RequestBasedUsage.

      Possible values include:
      • "RequestBasedUsage"
      • "MobileAssetTracking"
      • "MobileAssetManagement"
    • PricingPlanDataSource — (String)

      No longer used. Always returns an empty string.

    • Tags — (map<String>)

      Displays the key, value pairs of tags associated with this resource.

    • UpdateTime — (Date)

      The timestamp for when the geofence collection was last updated in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  MapName: 'STRING_VALUE' /* required */
};
location.describeMap(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • MapName — (String)

    The name of the map resource.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Configuration — (map)

      Specifies the map tile style selected from a partner data provider.

      • Style — required — (String)

        Specifies the map style selected from an available data provider.

        Valid Esri map styles:

        • VectorEsriDarkGrayCanvas – The Esri Dark Gray Canvas map style. A vector basemap with a dark gray, neutral background with minimal colors, labels, and features that's designed to draw attention to your thematic content.

        • RasterEsriImagery – The Esri Imagery map style. A raster basemap that provides one meter or better satellite and aerial imagery in many parts of the world and lower resolution satellite imagery worldwide.

        • VectorEsriLightGrayCanvas – The Esri Light Gray Canvas map style, which provides a detailed vector basemap with a light gray, neutral background style with minimal colors, labels, and features that's designed to draw attention to your thematic content.

        • VectorEsriTopographic – The Esri Light map style, which provides a detailed vector basemap with a classic Esri map style.

        • VectorEsriStreets – The Esri World Streets map style, which provides a detailed vector basemap for the world symbolized with a classic Esri street map style. The vector tile layer is similar in content and style to the World Street Map raster map.

        • VectorEsriNavigation – The Esri World Navigation map style, which provides a detailed basemap for the world symbolized with a custom navigation map style that's designed for use during the day in mobile devices.

        Valid HERE Technologies map styles:

        • VectorHereBerlin – The HERE Berlin map style is a high contrast detailed base map of the world that blends 3D and 2D rendering.

        • VectorHereExplore – A default HERE map style containing a neutral, global map and its features including roads, buildings, landmarks, and water features. It also now includes a fully designed map of Japan.

        • VectorHereExploreTruck – A global map containing truck restrictions and attributes (e.g. width / height / HAZMAT) symbolized with highlighted segments and icons on top of HERE Explore to support use cases within transport and logistics.

    • CreateTime — (Date)

      The timestamp for when the map resource was created in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

    • DataSource — (String)

      Specifies the data provider for the associated map tiles.

    • Description — (String)

      The optional description for the map resource.

    • MapArn — (String)

      The Amazon Resource Name (ARN) for the map resource. Used to specify a resource across all AWS.

      • Format example: arn:aws:geo:region:account-id:maps/ExampleMap

    • MapName — (String)

      The map style selected from an available provider.

    • PricingPlan — (String)

      No longer used. Always returns RequestBasedUsage.

      Possible values include:
      • "RequestBasedUsage"
      • "MobileAssetTracking"
      • "MobileAssetManagement"
    • Tags — (map<String>)

      Tags associated with the map resource.

    • UpdateTime — (Date)

      The timestamp for when the map resource was last update in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  IndexName: 'STRING_VALUE' /* required */
};
location.describePlaceIndex(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • IndexName — (String)

    The name of the place index resource.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • CreateTime — (Date)

      The timestamp for when the place index resource was created in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

    • DataSource — (String)

      The data provider of geospatial data. Values can be one of the following:

      • Esri

      • Here

      For more information about data providers, see Amazon Location Service data providers.

    • DataSourceConfiguration — (map)

      The specified data storage option for requesting Places.

      • IntendedUse — (String)

        Specifies how the results of an operation will be stored by the caller.

        Valid values include:

        • SingleUse specifies that the results won't be stored.

        • Storage specifies that the result can be cached or stored in a database.

        Default value: SingleUse

        Possible values include:
        • "SingleUse"
        • "Storage"
    • Description — (String)

      The optional description for the place index resource.

    • IndexArn — (String)

      The Amazon Resource Name (ARN) for the place index resource. Used to specify a resource across AWS.

      • Format example: arn:aws:geo:region:account-id:place-index/ExamplePlaceIndex

    • IndexName — (String)

      The name of the place index resource being described.

    • PricingPlan — (String)

      No longer used. Always returns RequestBasedUsage.

      Possible values include:
      • "RequestBasedUsage"
      • "MobileAssetTracking"
      • "MobileAssetManagement"
    • Tags — (map<String>)

      Tags associated with place index resource.

    • UpdateTime — (Date)

      The timestamp for when the place index resource was last updated in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  CalculatorName: 'STRING_VALUE' /* required */
};
location.describeRouteCalculator(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • CalculatorName — (String)

    The name of the route calculator resource.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • CalculatorArn — (String)

      The Amazon Resource Name (ARN) for the Route calculator resource. Use the ARN when you specify a resource across AWS.

      • Format example: arn:aws:geo:region:account-id:route-calculator/ExampleCalculator

    • CalculatorName — (String)

      The name of the route calculator resource being described.

    • CreateTime — (Date)

      The timestamp when the route calculator resource was created in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

      • For example, 2020–07-2T12:15:20.000Z+01:00

    • DataSource — (String)

      The data provider of traffic and road network data. Indicates one of the available providers:

      • Esri

      • Here

      For more information about data providers, see Amazon Location Service data providers.

    • Description — (String)

      The optional description of the route calculator resource.

    • PricingPlan — (String)

      Always returns RequestBasedUsage.

      Possible values include:
      • "RequestBasedUsage"
      • "MobileAssetTracking"
      • "MobileAssetManagement"
    • Tags — (map<String>)

      Tags associated with route calculator resource.

    • UpdateTime — (Date)

      The timestamp when the route calculator resource was last updated in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

      • For example, 2020–07-2T12:15:20.000Z+01:00

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  TrackerName: 'STRING_VALUE' /* required */
};
location.describeTracker(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • TrackerName — (String)

    The name of the tracker resource.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • CreateTime — (Date)

      The timestamp for when the tracker resource was created in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

    • Description — (String)

      The optional description for the tracker resource.

    • KmsKeyId — (String)

      A key identifier for an AWS KMS customer managed key assigned to the Amazon Location resource.

    • PositionFiltering — (String)

      The position filtering method of the tracker resource.

      Possible values include:
      • "TimeBased"
      • "DistanceBased"
      • "AccuracyBased"
    • PricingPlan — (String)

      Always returns RequestBasedUsage.

      Possible values include:
      • "RequestBasedUsage"
      • "MobileAssetTracking"
      • "MobileAssetManagement"
    • PricingPlanDataSource — (String)

      No longer used. Always returns an empty string.

    • Tags — (map<String>)

      The tags associated with the tracker resource.

    • TrackerArn — (String)

      The Amazon Resource Name (ARN) for the tracker resource. Used when you need to specify a resource across all AWS.

      • Format example: arn:aws:geo:region:account-id:tracker/ExampleTracker

    • TrackerName — (String)

      The name of the tracker resource.

    • UpdateTime — (Date)

      The timestamp for when the tracker resource was last updated in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  ConsumerArn: 'STRING_VALUE', /* required */
  TrackerName: 'STRING_VALUE' /* required */
};
location.disassociateTrackerConsumer(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • ConsumerArn — (String)

    The Amazon Resource Name (ARN) for the geofence collection to be disassociated from the tracker resource. Used when you need to specify a resource across all AWS.

    • Format example: arn:aws:geo:region:account-id:geofence-collection/ExampleGeofenceCollectionConsumer

  • TrackerName — (String)

    The name of the tracker resource to be dissociated from the consumer.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  DeviceId: 'STRING_VALUE', /* required */
  TrackerName: 'STRING_VALUE' /* required */
};
location.getDevicePosition(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • DeviceId — (String)

    The device whose position you want to retrieve.

  • TrackerName — (String)

    The tracker resource receiving the position update.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Accuracy — (map)

      The accuracy of the device position.

      • Horizontal — required — (Float)

        Estimated maximum distance, in meters, between the measured position and the true position of a device, along the Earth's surface.

    • DeviceId — (String)

      The device whose position you retrieved.

    • Position — (Array<Float>)

      The last known device position.

    • PositionProperties — (map<String>)

      The properties associated with the position.

    • ReceivedTime — (Date)

      The timestamp for when the tracker resource received the device position in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

    • SampleTime — (Date)

      The timestamp at which the device's position was determined. Uses ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  DeviceId: 'STRING_VALUE', /* required */
  TrackerName: 'STRING_VALUE', /* required */
  EndTimeExclusive: new Date || 'Wed Dec 31 1969 16:00:00 GMT-0800 (PST)' || 123456789,
  MaxResults: 'NUMBER_VALUE',
  NextToken: 'STRING_VALUE',
  StartTimeInclusive: new Date || 'Wed Dec 31 1969 16:00:00 GMT-0800 (PST)' || 123456789
};
location.getDevicePositionHistory(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • DeviceId — (String)

    The device whose position history you want to retrieve.

  • EndTimeExclusive — (Date)

    Specify the end time for the position history in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ. By default, the value will be the time that the request is made.

    Requirement:

    • The time specified for EndTimeExclusive must be after the time for StartTimeInclusive.

  • MaxResults — (Integer)

    An optional limit for the number of device positions returned in a single call.

    Default value: 100

  • NextToken — (String)

    The pagination token specifying which page of results to return in the response. If no token is provided, the default page is the first page.

    Default value: null

  • StartTimeInclusive — (Date)

    Specify the start time for the position history in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ. By default, the value will be 24 hours prior to the time that the request is made.

    Requirement:

    • The time specified for StartTimeInclusive must be before EndTimeExclusive.

  • TrackerName — (String)

    The tracker resource receiving the request for the device position history.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • DevicePositions — (Array<map>)

      Contains the position history details for the requested device.

      • Accuracy — (map)

        The accuracy of the device position.

        • Horizontal — required — (Float)

          Estimated maximum distance, in meters, between the measured position and the true position of a device, along the Earth's surface.

      • DeviceId — (String)

        The device whose position you retrieved.

      • Position — required — (Array<Float>)

        The last known device position.

      • PositionProperties — (map<String>)

        The properties associated with the position.

      • ReceivedTime — required — (Date)

        The timestamp for when the tracker resource received the device position in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

      • SampleTime — required — (Date)

        The timestamp at which the device's position was determined. Uses ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

    • NextToken — (String)

      A pagination token indicating there are additional pages available. You can use the token in a following request to fetch the next set of results.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  CollectionName: 'STRING_VALUE', /* required */
  GeofenceId: 'STRING_VALUE' /* required */
};
location.getGeofence(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • CollectionName — (String)

    The geofence collection storing the target geofence.

  • GeofenceId — (String)

    The geofence you're retrieving details for.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • CreateTime — (Date)

      The timestamp for when the geofence collection was created in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ

    • GeofenceId — (String)

      The geofence identifier.

    • Geometry — (map)

      Contains the geofence geometry details describing a polygon.

      • Polygon — (Array<Array<Array<Float>>>)

        An array of 1 or more linear rings. A linear ring is an array of 4 or more vertices, where the first and last vertex are the same to form a closed boundary. Each vertex is a 2-dimensional point of the form: [longitude, latitude].

        The first linear ring is an outer ring, describing the polygon's boundary. Subsequent linear rings may be inner or outer rings to describe holes and islands. Outer rings must list their vertices in counter-clockwise order around the ring's center, where the left side is the polygon's exterior. Inner rings must list their vertices in clockwise order, where the left side is the polygon's interior.

    • Status — (String)

      Identifies the state of the geofence. A geofence will hold one of the following states:

      • ACTIVE — The geofence has been indexed by the system.

      • PENDING — The geofence is being processed by the system.

      • FAILED — The geofence failed to be indexed by the system.

      • DELETED — The geofence has been deleted from the system index.

      • DELETING — The geofence is being deleted from the system index.

    • UpdateTime — (Date)

      The timestamp for when the geofence collection was last updated in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  FontStack: 'STRING_VALUE', /* required */
  FontUnicodeRange: 'STRING_VALUE', /* required */
  MapName: 'STRING_VALUE' /* required */
};
location.getMapGlyphs(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • FontStack — (String)

    A comma-separated list of fonts to load glyphs from in order of preference. For example, Noto Sans Regular, Arial Unicode.

    Valid fonts stacks for Esri styles:

    • VectorEsriDarkGrayCanvas – Ubuntu Medium Italic | Ubuntu Medium | Ubuntu Italic | Ubuntu Regular | Ubuntu Bold

    • VectorEsriLightGrayCanvas – Ubuntu Italic | Ubuntu Regular | Ubuntu Light | Ubuntu Bold

    • VectorEsriTopographic – Noto Sans Italic | Noto Sans Regular | Noto Sans Bold | Noto Serif Regular | Roboto Condensed Light Italic

    • VectorEsriStreets – Arial Regular | Arial Italic | Arial Bold

    • VectorEsriNavigation – Arial Regular | Arial Italic | Arial Bold

    Valid font stacks for HERE Technologies styles:

    • VectorHereBerlin – Fira GO Regular | Fira GO Bold

    • VectorHereExplore, VectorHereExploreTruck – Firo GO Italic | Fira GO Map | Fira GO Map Bold | Noto Sans CJK JP Bold | Noto Sans CJK JP Light | Noto Sans CJK JP Regular

  • FontUnicodeRange — (String)

    A Unicode range of characters to download glyphs for. Each response will contain 256 characters. For example, 0–255 includes all characters from range U+0000 to 00FF. Must be aligned to multiples of 256.

  • MapName — (String)

    The map resource associated with the glyph file.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Blob — (Buffer(Node.js), Typed Array(Browser))

      The blob's content type.

    • ContentType — (String)

      The map glyph content type. For example, application/octet-stream.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  FileName: 'STRING_VALUE', /* required */
  MapName: 'STRING_VALUE' /* required */
};
location.getMapSprites(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • FileName — (String)

    The name of the sprite file. Use the following file names for the sprite sheet:

    • sprites.png

    • sprites@2x.png for high pixel density displays

    For the JSON document contain image offsets. Use the following file names:

    • sprites.json

    • sprites@2x.json for high pixel density displays

  • MapName — (String)

    The map resource associated with the sprite file.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Blob — (Buffer(Node.js), Typed Array(Browser))

      Contains the body of the sprite sheet or JSON offset file.

    • ContentType — (String)

      The content type of the sprite sheet and offsets. For example, the sprite sheet content type is image/png, and the sprite offset JSON document is application/json.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  MapName: 'STRING_VALUE' /* required */
};
location.getMapStyleDescriptor(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • MapName — (String)

    The map resource to retrieve the style descriptor from.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Blob — (Buffer(Node.js), Typed Array(Browser))

      Contains the body of the style descriptor.

    • ContentType — (String)

      The style descriptor's content type. For example, application/json.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  MapName: 'STRING_VALUE', /* required */
  X: 'STRING_VALUE', /* required */
  Y: 'STRING_VALUE', /* required */
  Z: 'STRING_VALUE' /* required */
};
location.getMapTile(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • MapName — (String)

    The map resource to retrieve the map tiles from.

  • X — (String)

    The X axis value for the map tile.

  • Y — (String)

    The Y axis value for the map tile.

  • Z — (String)

    The zoom value for the map tile.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Blob — (Buffer(Node.js), Typed Array(Browser))

      Contains Mapbox Vector Tile (MVT) data.

    • ContentType — (String)

      The map tile's content type. For example, application/vnd.mapbox-vector-tile.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  TrackerName: 'STRING_VALUE', /* required */
  MaxResults: 'NUMBER_VALUE',
  NextToken: 'STRING_VALUE'
};
location.listDevicePositions(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • MaxResults — (Integer)

    An optional limit for the number of entries returned in a single call.

    Default value: 100

  • NextToken — (String)

    The pagination token specifying which page of results to return in the response. If no token is provided, the default page is the first page.

    Default value: null

  • TrackerName — (String)

    The tracker resource containing the requested devices.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Entries — (Array<map>)

      Contains details about each device's last known position. These details includes the device ID, the time when the position was sampled on the device, the time that the service received the update, and the most recent coordinates.

      • Accuracy — (map)

        The accuracy of the device position.

        • Horizontal — required — (Float)

          Estimated maximum distance, in meters, between the measured position and the true position of a device, along the Earth's surface.

      • DeviceId — required — (String)

        The ID of the device for this position.

      • Position — required — (Array<Float>)

        The last known device position. Empty if no positions currently stored.

      • PositionProperties — (map<String>)

        The properties associated with the position.

      • SampleTime — required — (Date)

        The timestamp at which the device position was determined. Uses ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

    • NextToken — (String)

      A pagination token indicating there are additional pages available. You can use the token in a following request to fetch the next set of results.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  MaxResults: 'NUMBER_VALUE',
  NextToken: 'STRING_VALUE'
};
location.listGeofenceCollections(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • MaxResults — (Integer)

    An optional limit for the number of resources returned in a single call.

    Default value: 100

  • NextToken — (String)

    The pagination token specifying which page of results to return in the response. If no token is provided, the default page is the first page.

    Default value: null

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Entries — (Array<map>)

      Lists the geofence collections that exist in your AWS account.

      • CollectionName — required — (String)

        The name of the geofence collection.

      • CreateTime — required — (Date)

        The timestamp for when the geofence collection was created in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ

      • Description — required — (String)

        The description for the geofence collection

      • PricingPlan — (String)

        No longer used. Always returns RequestBasedUsage.

        Possible values include:
        • "RequestBasedUsage"
        • "MobileAssetTracking"
        • "MobileAssetManagement"
      • PricingPlanDataSource — (String)

        No longer used. Always returns an empty string.

      • UpdateTime — required — (Date)

        Specifies a timestamp for when the resource was last updated in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ

    • NextToken — (String)

      A pagination token indicating there are additional pages available. You can use the token in a following request to fetch the next set of results.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  CollectionName: 'STRING_VALUE', /* required */
  MaxResults: 'NUMBER_VALUE',
  NextToken: 'STRING_VALUE'
};
location.listGeofences(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • CollectionName — (String)

    The name of the geofence collection storing the list of geofences.

  • MaxResults — (Integer)

    An optional limit for the number of geofences returned in a single call.

    Default value: 100

  • NextToken — (String)

    The pagination token specifying which page of results to return in the response. If no token is provided, the default page is the first page.

    Default value: null

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Entries — (Array<map>)

      Contains a list of geofences stored in the geofence collection.

      • CreateTime — required — (Date)

        The timestamp for when the geofence was stored in a geofence collection in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ

      • GeofenceId — required — (String)

        The geofence identifier.

      • Geometry — required — (map)

        Contains the geofence geometry details describing a polygon.

        • Polygon — (Array<Array<Array<Float>>>)

          An array of 1 or more linear rings. A linear ring is an array of 4 or more vertices, where the first and last vertex are the same to form a closed boundary. Each vertex is a 2-dimensional point of the form: [longitude, latitude].

          The first linear ring is an outer ring, describing the polygon's boundary. Subsequent linear rings may be inner or outer rings to describe holes and islands. Outer rings must list their vertices in counter-clockwise order around the ring's center, where the left side is the polygon's exterior. Inner rings must list their vertices in clockwise order, where the left side is the polygon's interior.

      • Status — required — (String)

        Identifies the state of the geofence. A geofence will hold one of the following states:

        • ACTIVE — The geofence has been indexed by the system.

        • PENDING — The geofence is being processed by the system.

        • FAILED — The geofence failed to be indexed by the system.

        • DELETED — The geofence has been deleted from the system index.

        • DELETING — The geofence is being deleted from the system index.

      • UpdateTime — required — (Date)

        The timestamp for when the geofence was last updated in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ

    • NextToken — (String)

      A pagination token indicating there are additional pages available. You can use the token in a following request to fetch the next set of results.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  MaxResults: 'NUMBER_VALUE',
  NextToken: 'STRING_VALUE'
};
location.listMaps(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • MaxResults — (Integer)

    An optional limit for the number of resources returned in a single call.

    Default value: 100

  • NextToken — (String)

    The pagination token specifying which page of results to return in the response. If no token is provided, the default page is the first page.

    Default value: null

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Entries — (Array<map>)

      Contains a list of maps in your AWS account

      • CreateTime — required — (Date)

        The timestamp for when the map resource was created in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

      • DataSource — required — (String)

        Specifies the data provider for the associated map tiles.

      • Description — required — (String)

        The description for the map resource.

      • MapName — required — (String)

        The name of the associated map resource.

      • PricingPlan — (String)

        No longer used. Always returns RequestBasedUsage.

        Possible values include:
        • "RequestBasedUsage"
        • "MobileAssetTracking"
        • "MobileAssetManagement"
      • UpdateTime — required — (Date)

        The timestamp for when the map resource was last updated in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

    • NextToken — (String)

      A pagination token indicating there are additional pages available. You can use the token in a following request to fetch the next set of results.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  MaxResults: 'NUMBER_VALUE',
  NextToken: 'STRING_VALUE'
};
location.listPlaceIndexes(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • MaxResults — (Integer)

    An optional limit for the maximum number of results returned in a single call.

    Default value: 100

  • NextToken — (String)

    The pagination token specifying which page of results to return in the response. If no token is provided, the default page is the first page.

    Default value: null

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Entries — (Array<map>)

      Lists the place index resources that exist in your AWS account

      • CreateTime — required — (Date)

        The timestamp for when the place index resource was created in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

      • DataSource — required — (String)

        The data provider of geospatial data. Values can be one of the following:

        • Esri

        • Here

        For more information about data providers, see Amazon Location Service data providers.

      • Description — required — (String)

        The optional description for the place index resource.

      • IndexName — required — (String)

        The name of the place index resource.

      • PricingPlan — (String)

        No longer used. Always returns RequestBasedUsage.

        Possible values include:
        • "RequestBasedUsage"
        • "MobileAssetTracking"
        • "MobileAssetManagement"
      • UpdateTime — required — (Date)

        The timestamp for when the place index resource was last updated in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

    • NextToken — (String)

      A pagination token indicating that there are additional pages available. You can use the token in a new request to fetch the next page of results.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  MaxResults: 'NUMBER_VALUE',
  NextToken: 'STRING_VALUE'
};
location.listRouteCalculators(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • MaxResults — (Integer)

    An optional maximum number of results returned in a single call.

    Default Value: 100

  • NextToken — (String)

    The pagination token specifying which page of results to return in the response. If no token is provided, the default page is the first page.

    Default Value: null

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Entries — (Array<map>)

      Lists the route calculator resources that exist in your AWS account

      • CalculatorName — required — (String)

        The name of the route calculator resource.

      • CreateTime — required — (Date)

        The timestamp when the route calculator resource was created in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

        • For example, 2020–07-2T12:15:20.000Z+01:00

      • DataSource — required — (String)

        The data provider of traffic and road network data. Indicates one of the available providers:

        • Esri

        • Here

        For more information about data providers, see Amazon Location Service data providers.

      • Description — required — (String)

        The optional description of the route calculator resource.

      • PricingPlan — (String)

        Always returns RequestBasedUsage.

        Possible values include:
        • "RequestBasedUsage"
        • "MobileAssetTracking"
        • "MobileAssetManagement"
      • UpdateTime — required — (Date)

        The timestamp when the route calculator resource was last updated in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

        • For example, 2020–07-2T12:15:20.000Z+01:00

    • NextToken — (String)

      A pagination token indicating there are additional pages available. You can use the token in a subsequent request to fetch the next set of results.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  ResourceArn: 'STRING_VALUE' /* required */
};
location.listTagsForResource(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • ResourceArn — (String)

    The Amazon Resource Name (ARN) of the resource whose tags you want to retrieve.

    • Format example: arn:aws:geo:region:account-id:resourcetype/ExampleResource

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Tags — (map<String>)

      Tags that have been applied to the specified resource. Tags are mapped from the tag key to the tag value: "TagKey" : "TagValue".

      • Format example: {"tag1" : "value1", "tag2" : "value2"}

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  TrackerName: 'STRING_VALUE', /* required */
  MaxResults: 'NUMBER_VALUE',
  NextToken: 'STRING_VALUE'
};
location.listTrackerConsumers(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • MaxResults — (Integer)

    An optional limit for the number of resources returned in a single call.

    Default value: 100

  • NextToken — (String)

    The pagination token specifying which page of results to return in the response. If no token is provided, the default page is the first page.

    Default value: null

  • TrackerName — (String)

    The tracker resource whose associated geofence collections you want to list.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • ConsumerArns — (Array<String>)

      Contains the list of geofence collection ARNs associated to the tracker resource.

    • NextToken — (String)

      A pagination token indicating there are additional pages available. You can use the token in a following request to fetch the next set of results.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  MaxResults: 'NUMBER_VALUE',
  NextToken: 'STRING_VALUE'
};
location.listTrackers(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • MaxResults — (Integer)

    An optional limit for the number of resources returned in a single call.

    Default value: 100

  • NextToken — (String)

    The pagination token specifying which page of results to return in the response. If no token is provided, the default page is the first page.

    Default value: null

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Entries — (Array<map>)

      Contains tracker resources in your AWS account. Details include tracker name, description and timestamps for when the tracker was created and last updated.

      • CreateTime — required — (Date)

        The timestamp for when the tracker resource was created in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

      • Description — required — (String)

        The description for the tracker resource.

      • PricingPlan — (String)

        Always returns RequestBasedUsage.

        Possible values include:
        • "RequestBasedUsage"
        • "MobileAssetTracking"
        • "MobileAssetManagement"
      • PricingPlanDataSource — (String)

        No longer used. Always returns an empty string.

      • TrackerName — required — (String)

        The name of the tracker resource.

      • UpdateTime — required — (Date)

        The timestamp at which the device's position was determined. Uses ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ.

    • NextToken — (String)

      A pagination token indicating there are additional pages available. You can use the token in a following request to fetch the next set of results.

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  CollectionName: 'STRING_VALUE', /* required */
  GeofenceId: 'STRING_VALUE', /* required */
  Geometry: { /* required */
    Polygon: [
      [
        [
          'NUMBER_VALUE',
          /* more items */
        ],
        /* more items */
      ],
      /* more items */
    ]
  }
};
location.putGeofence(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • CollectionName — (String)

    The geofence collection to store the geofence in.

  • GeofenceId — (String)

    An identifier for the geofence. For example, ExampleGeofence-1.

  • Geometry — (map)

    Contains the polygon details to specify the position of the geofence.

    Note: Each geofence polygon can have a maximum of 1,000 vertices.
    • Polygon — (Array<Array<Array<Float>>>)

      An array of 1 or more linear rings. A linear ring is an array of 4 or more vertices, where the first and last vertex are the same to form a closed boundary. Each vertex is a 2-dimensional point of the form: [longitude, latitude].

      The first linear ring is an outer ring, describing the polygon's boundary. Subsequent linear rings may be inner or outer rings to describe holes and islands. Outer rings must list their vertices in counter-clockwise order around the ring's center, where the left side is the polygon's exterior. Inner rings must list their vertices in clockwise order, where the left side is the polygon's interior.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • CreateTime — (Date)

      The timestamp for when the geofence was created in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ

    • GeofenceId — (String)

      The geofence identifier entered in the request.

    • UpdateTime — (Date)

      The timestamp for when the geofence was last updated in ISO 8601 format: YYYY-MM-DDThh:mm:ss.sssZ

Returns:

• (AWS.Request) —

  a handle to the operation request for subsequent event callback registration.

var params = {
  IndexName: 'STRING_VALUE', /* required */
  Position: [ /* required */
    'NUMBER_VALUE',
    /* more items */
  ],
  Language: 'STRING_VALUE',
  MaxResults: 'NUMBER_VALUE'
};
location.searchPlaceIndexForPosition(params, function(err, data) {
  if (err) console.log(err, err.stack); // an error occurred
  else     console.log(data);           // successful response
});

Parameters:

• params (Object) (defaults to: {}) —
  • IndexName — (String)

    The name of the place index resource you want to use for the search.

  • Language — (String)

    The preferred language used to return results. The value must be a valid BCP 47 language tag, for example, en for English.

    This setting affects the languages used in the results, but not the results themselves. If no language is specified, or not supported for a particular result, the partner automatically chooses a language for the result.

    For an example, we'll use the Greek language. You search for a location around Athens, Greece, with the language parameter set to en. The city in the results will most likely be returned as Athens.

    If you set the language parameter to el, for Greek, then the city in the results will more likely be returned as Αθήνα.

    If the data provider does not have a value for Greek, the result will be in a language that the provider does support.

  • MaxResults — (Integer)

    An optional parameter. The maximum number of results returned per request.

    Default value: 50

  • Position — (Array<Float>)

    Specifies the longitude and latitude of the position to query.

    This parameter must contain a pair of numbers. The first number represents the X coordinate, or longitude; the second number represents the Y coordinate, or latitude.

    For example, [-123.1174, 49.2847] represents a position with longitude -123.1174 and latitude 49.2847.

Callback (callback):

• function(err, data) { ... }

  Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.

  Context (this):

  • (AWS.Response) —

    the response object containing error, data properties, and the original request object.

  Parameters:

  • err (Error) —

    the error object returned from the request. Set to null if the request is successful.

  • data (Object) —

    the de-serialized data returned from the request. Set to null if a request error occurs. The data object has the following properties:

    • Results — (Array<map>)

      Returns a list of Places closest to the specified position. Each result contains additional information about the Places returned.

      • Distance — required — (Float)

        The distance in meters of a great-circle arc between the query position and the result.

        Note: A great-circle arc is the shortest path on a sphere, in this case the Earth. This returns the shortest distance between two locations.
      • Place — required — (map)

        Details about the search result, such as its address and position.

        • AddressNumber — (String)

          The numerical portion of an address, such as a building number.

        • Country — (String)

          A country/region specified using ISO 3166 3-digit country/region code. For example, CAN.

        • Geometry — required — (map)

          Places uses a point geometry to specify a location or a Place.

          • Point — (Array<Float>)

            A single point geometry specifies a location for a Place using WGS 84 coordinates:

            • x — Specifies the x coordinate or longitude.

            • y — Specifies the y coordinate or latitude.

        • Interpolated — (Boolean)

          True if the result is interpolated from other known places.

          False if the Place is a known place.

          Not returned when the partner does not provide the information.

          For example, returns False for an address location that is found in the partner data, but returns True if an address does not exist in the partner data and its location is calculated by interpolating between other known addresses.

        • Label — (String)

          The full name and address of the point of interest such as a city, region, or country. For example, 123 Any Street, Any Town, USA.

        • Municipality — (String)

          A name for a local area, such as a city or town name. For example, Toronto.

        • Neighborhood — (String)

          The name of a community district. For example, Downtown.

        • PostalCode — (String)

          A group of numbers and letters in a country-specific format, which accompanies the address for the purpose of identifying a location.

        • Region — (String)

          A name for an area or geographical division, such as a province or state name. For example, British Columbia.

        • Street — (String)

          The name for a street or a road to identify a location. For example, Main Street.

        • SubRegion — (String)

          A country, or an area that's part of a larger region. For example, Metro Vancouver.

        • TimeZone — (map)

          The time zone in which the Place is located. Returned only when using Here as the selected partner.

          • Name — required — (String)

            The name of the time zone, following the IANA time zone standard. For example, America/Los_Angeles.

          • Offset — (Integer)

            The time zone's offset, in seconds, from UTC.

    • Summary — (map)

      Contains a summary of the request. Echoes the input values for Position, Language, MaxResults, and the DataSource of the place index.

      • DataSource — required — (String)

        The geospatial data provider attached to the place index resource specified in the request. Values can be one of the following:

        • Esri

        • Here

        For more information about data providers, see Amazon Location Service data providers.

      • Language — (String)

        The preferred language used to return results. Matches the language in the request. The value is a valid BCP 47 language tag, for example, en for English.

      • MaxResults — (Integer)

        Contains the optional result count limit that is specified in the request.

        Default value: 50

      • Position — required — (Array<Float>)

        The position specified in the request.