Skip to contents

"Suite of geospatial services including Maps, Places, Routes, Tracking, and Geofencing"

Usage

locationservice(
  config = list(),
  credentials = list(),
  endpoint = NULL,
  region = NULL
)

Arguments

config

Optional configuration of credentials, endpoint, and/or region.

  • credentials:

    • creds:

      • access_key_id: AWS access key ID

      • secret_access_key: AWS secret access key

      • session_token: AWS temporary session token

    • profile: The name of a profile to use. If not given, then the default profile is used.

    • anonymous: Set anonymous credentials.

  • endpoint: The complete URL to use for the constructed client.

  • region: The AWS Region used in instantiating the client.

  • close_connection: Immediately close all HTTP connections.

  • timeout: The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.

  • s3_force_path_style: Set this to true to force the request to use path-style addressing, i.e. http://s3.amazonaws.com/BUCKET/KEY.

  • sts_regional_endpoint: Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html

credentials

Optional credentials shorthand for the config parameter

  • creds:

    • access_key_id: AWS access key ID

    • secret_access_key: AWS secret access key

    • session_token: AWS temporary session token

  • profile: The name of a profile to use. If not given, then the default profile is used.

  • anonymous: Set anonymous credentials.

endpoint

Optional shorthand for complete URL to use for the constructed client.

region

Optional shorthand for AWS Region used in instantiating the client.

Value

A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.

Service syntax

svc <- locationservice(
  config = list(
    credentials = list(
      creds = list(
        access_key_id = "string",
        secret_access_key = "string",
        session_token = "string"
      ),
      profile = "string",
      anonymous = "logical"
    ),
    endpoint = "string",
    region = "string",
    close_connection = "logical",
    timeout = "numeric",
    s3_force_path_style = "logical",
    sts_regional_endpoint = "string"
  ),
  credentials = list(
    creds = list(
      access_key_id = "string",
      secret_access_key = "string",
      session_token = "string"
    ),
    profile = "string",
    anonymous = "logical"
  ),
  endpoint = "string",
  region = "string"
)

Operations

associate_tracker_consumerCreates an association between a geofence collection and a tracker resource
batch_delete_device_position_historyDeletes the position history of one or more devices from a tracker resource
batch_delete_geofenceDeletes a batch of geofences from a geofence collection
batch_evaluate_geofencesEvaluates device positions against the geofence geometries from a given geofence collection
batch_get_device_positionLists the latest device positions for requested devices
batch_put_geofenceA batch request for storing geofence geometries into a given geofence collection, or updates the geometry of an existing geofence if a geofence ID is included in the request
batch_update_device_positionUploads position update data for one or more devices to a tracker resource (up to 10 devices per batch)
calculate_routeThis operation is no longer current and may be deprecated in the future
calculate_route_matrixThis operation is no longer current and may be deprecated in the future
cancel_jobCancelJob cancels a job that is currently running or pending
create_geofence_collectionCreates a geofence collection, which manages and stores geofences
create_keyCreates an API key resource in your Amazon Web Services account, which lets you grant actions for Amazon Location resources to the API key bearer
create_mapThis operation is no longer current and may be deprecated in the future
create_place_indexThis operation is no longer current and may be deprecated in the future
create_route_calculatorThis operation is no longer current and may be deprecated in the future
create_trackerCreates a tracker resource in your Amazon Web Services account, which lets you retrieve current and historical location of devices
delete_geofence_collectionDeletes a geofence collection from your Amazon Web Services account
delete_keyDeletes the specified API key
delete_mapThis operation is no longer current and may be deprecated in the future
delete_place_indexThis operation is no longer current and may be deprecated in the future
delete_route_calculatorThis operation is no longer current and may be deprecated in the future
delete_trackerDeletes a tracker resource from your Amazon Web Services account
describe_geofence_collectionRetrieves the geofence collection details
describe_keyRetrieves the API key resource details
describe_mapThis operation is no longer current and may be deprecated in the future
describe_place_indexThis operation is no longer current and may be deprecated in the future
describe_route_calculatorThis operation is no longer current and may be deprecated in the future
describe_trackerRetrieves the tracker resource details
disassociate_tracker_consumerRemoves the association between a tracker resource and a geofence collection
forecast_geofence_eventsThis action forecasts future geofence events that are likely to occur within a specified time horizon if a device continues moving at its current speed
get_device_positionRetrieves a device's most recent position according to its sample time
get_device_position_historyRetrieves the device position history from a tracker resource within a specified range of time
get_geofenceRetrieves the geofence details from a geofence collection
get_jobGetJob retrieves detailed information about a specific job, including its current status, configuration, and error information if the job failed
get_map_glyphsThis operation is no longer current and may be deprecated in the future
get_map_spritesThis operation is no longer current and may be deprecated in the future
get_map_style_descriptorThis operation is no longer current and may be deprecated in the future
get_map_tileThis operation is no longer current and may be deprecated in the future
get_placeThis operation is no longer current and may be deprecated in the future
list_device_positionsA batch request to retrieve all device positions
list_geofence_collectionsLists geofence collections in your Amazon Web Services account
list_geofencesLists geofences stored in a given geofence collection
list_jobsListJobs retrieves a list of jobs with optional filtering and pagination support
list_keysLists API key resources in your Amazon Web Services account
list_mapsThis operation is no longer current and may be deprecated in the future
list_place_indexesThis operation is no longer current and may be deprecated in the future
list_route_calculatorsThis operation is no longer current and may be deprecated in the future
list_tags_for_resourceReturns a list of tags that are applied to the specified Amazon Location resource
list_tracker_consumersLists geofence collections currently associated to the given tracker resource
list_trackersLists tracker resources in your Amazon Web Services account
put_geofenceStores a geofence geometry in a given geofence collection, or updates the geometry of an existing geofence if a geofence ID is included in the request
search_place_index_for_positionThis operation is no longer current and may be deprecated in the future
search_place_index_for_suggestionsThis operation is no longer current and may be deprecated in the future
search_place_index_for_textThis operation is no longer current and may be deprecated in the future
start_jobStartJob starts a new asynchronous bulk processing job
tag_resourceAssigns one or more tags (key-value pairs) to the specified Amazon Location Service resource
untag_resourceRemoves one or more tags from the specified Amazon Location resource
update_geofence_collectionUpdates the specified properties of a given geofence collection
update_keyUpdates the specified properties of a given API key resource
update_mapThis operation is no longer current and may be deprecated in the future
update_place_indexThis operation is no longer current and may be deprecated in the future
update_route_calculatorThis operation is no longer current and may be deprecated in the future
update_trackerUpdates the specified properties of a given tracker resource
verify_device_positionVerifies the integrity of the device's position by determining if it was reported behind a proxy, and by comparing it to an inferred position estimated based on the device's state

Examples

if (FALSE) { # \dontrun{
svc <- locationservice()
svc$associate_tracker_consumer(
  Foo = 123
)
} # }