shell bypass 403
UnknownSec Shell
:
/
snap
/
aws-cli
/
1886
/
aws
/
dist
/
awscli
/
botocore
/
data
/
location
/
2020-11-19
/ [
drwxr-xr-x
]
upload
mass deface
mass delete
console
info server
name :
service-2.json
{ "version":"2.0", "metadata":{ "apiVersion":"2020-11-19", "auth":["aws.auth#sigv4"], "endpointPrefix":"geo", "protocol":"rest-json", "protocols":["rest-json"], "serviceFullName":"Amazon Location Service", "serviceId":"Location", "signatureVersion":"v4", "signingName":"geo", "uid":"location-2020-11-19" }, "operations":{ "AssociateTrackerConsumer":{ "name":"AssociateTrackerConsumer", "http":{ "method":"POST", "requestUri":"/tracking/v0/trackers/{TrackerName}/consumers", "responseCode":200 }, "input":{"shape":"AssociateTrackerConsumerRequest"}, "output":{"shape":"AssociateTrackerConsumerResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ConflictException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Creates an association between a geofence collection and a tracker resource. This allows the tracker resource to communicate location data to the linked geofence collection. </p> <p>You can associate up to five geofence collections to each tracker resource.</p> <note> <p>Currently not supported — Cross-account configurations, such as creating associations between a tracker resource in one account and a geofence collection in another account.</p> </note>", "endpoint":{"hostPrefix":"cp.tracking."} }, "BatchDeleteDevicePositionHistory":{ "name":"BatchDeleteDevicePositionHistory", "http":{ "method":"POST", "requestUri":"/tracking/v0/trackers/{TrackerName}/delete-positions", "responseCode":200 }, "input":{"shape":"BatchDeleteDevicePositionHistoryRequest"}, "output":{"shape":"BatchDeleteDevicePositionHistoryResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Deletes the position history of one or more devices from a tracker resource.</p>", "endpoint":{"hostPrefix":"tracking."} }, "BatchDeleteGeofence":{ "name":"BatchDeleteGeofence", "http":{ "method":"POST", "requestUri":"/geofencing/v0/collections/{CollectionName}/delete-geofences", "responseCode":200 }, "input":{"shape":"BatchDeleteGeofenceRequest"}, "output":{"shape":"BatchDeleteGeofenceResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Deletes a batch of geofences from a geofence collection.</p> <note> <p>This operation deletes the resource permanently.</p> </note>", "endpoint":{"hostPrefix":"geofencing."} }, "BatchEvaluateGeofences":{ "name":"BatchEvaluateGeofences", "http":{ "method":"POST", "requestUri":"/geofencing/v0/collections/{CollectionName}/positions", "responseCode":200 }, "input":{"shape":"BatchEvaluateGeofencesRequest"}, "output":{"shape":"BatchEvaluateGeofencesResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Evaluates device positions against the geofence geometries from a given geofence collection.</p> <p>This operation always returns an empty response because geofences are asynchronously evaluated. The evaluation determines if the device has entered or exited a geofenced area, and then publishes one of the following events to Amazon EventBridge:</p> <ul> <li> <p> <code>ENTER</code> if Amazon Location determines that the tracked device has entered a geofenced area.</p> </li> <li> <p> <code>EXIT</code> if Amazon Location determines that the tracked device has exited a geofenced area.</p> </li> </ul> <note> <p>The last geofence that a device was observed within is tracked for 30 days after the most recent device position update.</p> </note> <note> <p>Geofence evaluation uses the given device position. It does not account for the optional <code>Accuracy</code> of a <code>DevicePositionUpdate</code>.</p> </note> <note> <p>The <code>DeviceID</code> is used as a string to represent the device. You do not need to have a <code>Tracker</code> associated with the <code>DeviceID</code>.</p> </note>", "endpoint":{"hostPrefix":"geofencing."} }, "BatchGetDevicePosition":{ "name":"BatchGetDevicePosition", "http":{ "method":"POST", "requestUri":"/tracking/v0/trackers/{TrackerName}/get-positions", "responseCode":200 }, "input":{"shape":"BatchGetDevicePositionRequest"}, "output":{"shape":"BatchGetDevicePositionResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Lists the latest device positions for requested devices.</p>", "endpoint":{"hostPrefix":"tracking."}, "readonly":true }, "BatchPutGeofence":{ "name":"BatchPutGeofence", "http":{ "method":"POST", "requestUri":"/geofencing/v0/collections/{CollectionName}/put-geofences", "responseCode":200 }, "input":{"shape":"BatchPutGeofenceRequest"}, "output":{"shape":"BatchPutGeofenceResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>A 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.</p>", "endpoint":{"hostPrefix":"geofencing."} }, "BatchUpdateDevicePosition":{ "name":"BatchUpdateDevicePosition", "http":{ "method":"POST", "requestUri":"/tracking/v0/trackers/{TrackerName}/positions", "responseCode":200 }, "input":{"shape":"BatchUpdateDevicePositionRequest"}, "output":{"shape":"BatchUpdateDevicePositionResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Uploads position update data for one or more devices to a tracker resource (up to 10 devices per batch). Amazon Location uses the data when it reports the last known device position and position history. Amazon Location retains location data for 30 days.</p> <note> <p>Position updates are handled based on the <code>PositionFiltering</code> property of the tracker. When <code>PositionFiltering</code> is set to <code>TimeBased</code>, updates are evaluated against linked geofence collections, and location data is stored at a maximum of one position per 30 second interval. If your update frequency is more often than every 30 seconds, only one update per 30 seconds is stored for each unique device ID.</p> <p>When <code>PositionFiltering</code> is set to <code>DistanceBased</code> filtering, location data is stored and evaluated against linked geofence collections only if the device has moved more than 30 m (98.4 ft).</p> <p>When <code>PositionFiltering</code> is set to <code>AccuracyBased</code> filtering, location data is stored and evaluated against linked geofence collections only if the device has moved more than the measured accuracy. For example, if two consecutive updates from a device have a horizontal accuracy of 5 m and 10 m, the second update is neither stored or evaluated if the device has moved less than 15 m. If <code>PositionFiltering</code> is set to <code>AccuracyBased</code> filtering, Amazon Location uses the default value <code>{ \"Horizontal\": 0}</code> when accuracy is not provided on a <code>DevicePositionUpdate</code>.</p> </note>", "endpoint":{"hostPrefix":"tracking."} }, "CalculateRoute":{ "name":"CalculateRoute", "http":{ "method":"POST", "requestUri":"/routes/v0/calculators/{CalculatorName}/calculate/route", "responseCode":200 }, "input":{"shape":"CalculateRouteRequest"}, "output":{"shape":"CalculateRouteResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend you upgrade to <a href=\"/location/latest/APIReference/API_CalculateRoutes.html\"> <code>CalculateRoutes</code> </a> or <a href=\"/location/latest/APIReference/API_CalculateIsolines.html\"> <code>CalculateIsolines</code> </a> unless you require Grab data.</p> <ul> <li> <p> <code>CalculateRoute</code> is part of a previous Amazon Location Service Routes API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The version 2 <code>CalculateRoutes</code> operation gives better results for point-to-point routing, while the version 2 <code>CalculateIsolines</code> operation adds support for calculating service areas and travel time envelopes.</p> </li> <li> <p>If you are using an Amazon Web Services SDK or the Amazon Web Services CLI, note that the Routes API version 2 is found under <code>geo-routes</code> or <code>geo_routes</code>, not under <code>location</code>.</p> </li> <li> <p>Since Grab is not yet fully supported in Routes API version 2, we recommend you continue using API version 1 when using Grab.</p> </li> </ul> </important> <p> <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/calculate-route.html\">Calculates a route</a> given the following required parameters: <code>DeparturePosition</code> and <code>DestinationPosition</code>. Requires that you first <a href=\"https://docs.aws.amazon.com/location-routes/latest/APIReference/API_CreateRouteCalculator.html\">create a route calculator resource</a>.</p> <p>By default, a request that doesn't specify a departure time uses the best time of day to travel with the best traffic conditions when calculating the route.</p> <p>Additional options include:</p> <ul> <li> <p> <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/departure-time.html\">Specifying a departure time</a> using either <code>DepartureTime</code> or <code>DepartNow</code>. This calculates a route based on predictive traffic data at the given time. </p> <note> <p>You can't specify both <code>DepartureTime</code> and <code>DepartNow</code> in a single request. Specifying both parameters returns a validation error.</p> </note> </li> <li> <p> <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/travel-mode.html\">Specifying a travel mode</a> using TravelMode sets the transportation mode used to calculate the routes. This also lets you specify additional route preferences in <code>CarModeOptions</code> if traveling by <code>Car</code>, or <code>TruckModeOptions</code> if traveling by <code>Truck</code>.</p> <note> <p>If you specify <code>walking</code> for the travel mode and your data provider is Esri, the start and destination must be within 40km.</p> </note> </li> </ul></p>", "endpoint":{"hostPrefix":"routes."}, "readonly":true }, "CalculateRouteMatrix":{ "name":"CalculateRouteMatrix", "http":{ "method":"POST", "requestUri":"/routes/v0/calculators/{CalculatorName}/calculate/route-matrix", "responseCode":200 }, "input":{"shape":"CalculateRouteMatrixRequest"}, "output":{"shape":"CalculateRouteMatrixResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend you upgrade to the <a href=\"/location/latest/APIReference/API_CalculateRouteMatrix.html\">V2 <code>CalculateRouteMatrix</code> </a> unless you require Grab data.</p> <ul> <li> <p>This version of <code>CalculateRouteMatrix</code> is part of a previous Amazon Location Service Routes API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The version 2 <code>CalculateRouteMatrix</code> operation gives better results for matrix routing calculations.</p> </li> <li> <p>If you are using an Amazon Web Services SDK or the Amazon Web Services CLI, note that the Routes API version 2 is found under <code>geo-routes</code> or <code>geo_routes</code>, not under <code>location</code>.</p> </li> <li> <p>Since Grab is not yet fully supported in Routes API version 2, we recommend you continue using API version 1 when using Grab.</p> </li> <li> <p>Start your version 2 API journey with the Routes V2 <a href=\"/location/latest/APIReference/API_Operations_Amazon_Location_Service_Routes_V2.html\">API Reference</a> or the <a href=\"/location/latest/developerguide/routes.html\">Developer Guide</a>.</p> </li> </ul> </important> <p> <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/calculate-route-matrix.html\"> Calculates a route matrix</a> given the following required parameters: <code>DeparturePositions</code> and <code>DestinationPositions</code>. <code>CalculateRouteMatrix</code> calculates routes and returns the travel time and travel distance from each departure position to each destination position in the request. For example, given departure positions A and B, and destination positions X and Y, <code>CalculateRouteMatrix</code> will return time and distance for routes from A to X, A to Y, B to X, and B to Y (in that order). The number of results returned (and routes calculated) will be the number of <code>DeparturePositions</code> times the number of <code>DestinationPositions</code>.</p> <note> <p>Your account is charged for each route calculated, not the number of requests.</p> </note> <p>Requires that you first <a href=\"https://docs.aws.amazon.com/location-routes/latest/APIReference/API_CreateRouteCalculator.html\">create a route calculator resource</a>.</p> <p>By default, a request that doesn't specify a departure time uses the best time of day to travel with the best traffic conditions when calculating routes.</p> <p>Additional options include:</p> <ul> <li> <p> <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/departure-time.html\"> Specifying a departure time</a> using either <code>DepartureTime</code> or <code>DepartNow</code>. This calculates routes based on predictive traffic data at the given time. </p> <note> <p>You can't specify both <code>DepartureTime</code> and <code>DepartNow</code> in a single request. Specifying both parameters returns a validation error.</p> </note> </li> <li> <p> <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/travel-mode.html\">Specifying a travel mode</a> using TravelMode sets the transportation mode used to calculate the routes. This also lets you specify additional route preferences in <code>CarModeOptions</code> if traveling by <code>Car</code>, or <code>TruckModeOptions</code> if traveling by <code>Truck</code>.</p> </li> </ul></p>", "endpoint":{"hostPrefix":"routes."}, "readonly":true }, "CreateGeofenceCollection":{ "name":"CreateGeofenceCollection", "http":{ "method":"POST", "requestUri":"/geofencing/v0/collections", "responseCode":200 }, "input":{"shape":"CreateGeofenceCollectionRequest"}, "output":{"shape":"CreateGeofenceCollectionResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ConflictException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Creates a geofence collection, which manages and stores geofences.</p>", "endpoint":{"hostPrefix":"cp.geofencing."}, "idempotent":true }, "CreateKey":{ "name":"CreateKey", "http":{ "method":"POST", "requestUri":"/metadata/v0/keys", "responseCode":200 }, "input":{"shape":"CreateKeyRequest"}, "output":{"shape":"CreateKeyResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ConflictException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Creates an API key resource in your Amazon Web Services account, which lets you grant actions for Amazon Location resources to the API key bearer.</p> <p>For more information, see <a href=\"https://docs.aws.amazon.com/location/latest/developerguide/using-apikeys.html\">Use API keys to authenticate</a> in the <i>Amazon Location Service Developer Guide</i>.</p>", "endpoint":{"hostPrefix":"cp.metadata."}, "idempotent":true }, "CreateMap":{ "name":"CreateMap", "http":{ "method":"POST", "requestUri":"/maps/v0/maps", "responseCode":200 }, "input":{"shape":"CreateMapRequest"}, "output":{"shape":"CreateMapResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ConflictException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend upgrading to the Maps API V2 unless you require <code>Grab</code> data.</p> <ul> <li> <p> <code>CreateMap</code> is part of a previous Amazon Location Service Maps API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The Maps API version 2 has a simplified interface that can be used without creating or managing map resources.</p> </li> <li> <p>If you are using an AWS SDK or the AWS CLI, note that the Maps API version 2 is found under <code>geo-maps</code> or <code>geo_maps</code>, not under <code>location</code>.</p> </li> <li> <p>Since <code>Grab</code> is not yet fully supported in Maps API version 2, we recommend you continue using API version 1 when using <code>Grab</code>.</p> </li> <li> <p>Start your version 2 API journey with the <a href=\"https://docs.aws.amazon.com/location/latest/APIReference/API_Operations_Amazon_Location_Service_Maps_V2.html\">Maps V2 API Reference</a> or the <a href=\"https://docs.aws.amazon.com/location/latest/developerguide/maps.html\">Developer Guide</a>.</p> </li> </ul> </important> <p>Creates a map resource in your Amazon Web Services account, which provides map tiles of different styles sourced from global location data providers.</p> <note> <p>If your application is tracking or routing assets you use in your business, such as delivery vehicles or employees, you must not use Esri as your geolocation provider. See section 82 of the <a href=\"http://aws.amazon.com/service-terms\">Amazon Web Services service terms</a> for more details.</p> </note></p>", "endpoint":{"hostPrefix":"cp.maps."}, "idempotent":true }, "CreatePlaceIndex":{ "name":"CreatePlaceIndex", "http":{ "method":"POST", "requestUri":"/places/v0/indexes", "responseCode":200 }, "input":{"shape":"CreatePlaceIndexRequest"}, "output":{"shape":"CreatePlaceIndexResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ConflictException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend you upgrade to the Places API V2 unless you require Grab data.</p> <ul> <li> <p> <code>CreatePlaceIndex</code> is part of a previous Amazon Location Service Places API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The Places API version 2 has a simplified interface that can be used without creating or managing place index resources.</p> </li> <li> <p>If you are using an Amazon Web Services SDK or the Amazon Web Services CLI, note that the Places API version 2 is found under <code>geo-places</code> or <code>geo_places</code>, not under <code>location</code>.</p> </li> <li> <p>Since Grab is not yet fully supported in Places API version 2, we recommend you continue using API version 1 when using Grab.</p> </li> <li> <p>Start your version 2 API journey with the Places V2 <a href=\"/location/latest/APIReference/API_Operations_Amazon_Location_Service_Places_V2.html\">API Reference</a> or the <a href=\"/location/latest/developerguide/places.html\">Developer Guide</a>.</p> </li> </ul> </important> <p>Creates a place index resource in your Amazon Web Services account. Use a place index resource to geocode addresses and other text queries by using the <code>SearchPlaceIndexForText</code> operation, and reverse geocode coordinates by using the <code>SearchPlaceIndexForPosition</code> operation, and enable autosuggestions by using the <code>SearchPlaceIndexForSuggestions</code> operation.</p> <note> <p>If your application is tracking or routing assets you use in your business, such as delivery vehicles or employees, you must not use Esri as your geolocation provider. See section 82 of the <a href=\"http://aws.amazon.com/service-terms\">Amazon Web Services service terms</a> for more details.</p> </note></p>", "endpoint":{"hostPrefix":"cp.places."}, "idempotent":true }, "CreateRouteCalculator":{ "name":"CreateRouteCalculator", "http":{ "method":"POST", "requestUri":"/routes/v0/calculators", "responseCode":200 }, "input":{"shape":"CreateRouteCalculatorRequest"}, "output":{"shape":"CreateRouteCalculatorResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ConflictException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend you upgrade to the Routes API V2 unless you require Grab data.</p> <ul> <li> <p> <code>CreateRouteCalculator</code> is part of a previous Amazon Location Service Routes API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The Routes API version 2 has a simplified interface that can be used without creating or managing route calculator resources.</p> </li> <li> <p>If you are using an Amazon Web Services SDK or the Amazon Web Services CLI, note that the Routes API version 2 is found under <code>geo-routes</code> or <code>geo_routes</code>, not under <code>location</code>.</p> </li> <li> <p>Since Grab is not yet fully supported in Routes API version 2, we recommend you continue using API version 1 when using Grab.</p> </li> <li> <p>Start your version 2 API journey with the Routes V2 <a href=\"/location/latest/APIReference/API_Operations_Amazon_Location_Service_Routes_V2.html\">API Reference</a> or the <a href=\"/location/latest/developerguide/routes.html\">Developer Guide</a>.</p> </li> </ul> </important> <p>Creates a route calculator resource in your Amazon Web Services account.</p> <p>You can send requests to a route calculator resource to estimate travel time, distance, and get directions. A route calculator sources traffic and road network data from your chosen data provider.</p> <note> <p>If your application is tracking or routing assets you use in your business, such as delivery vehicles or employees, you must not use Esri as your geolocation provider. See section 82 of the <a href=\"http://aws.amazon.com/service-terms\">Amazon Web Services service terms</a> for more details.</p> </note></p>", "endpoint":{"hostPrefix":"cp.routes."}, "idempotent":true }, "CreateTracker":{ "name":"CreateTracker", "http":{ "method":"POST", "requestUri":"/tracking/v0/trackers", "responseCode":200 }, "input":{"shape":"CreateTrackerRequest"}, "output":{"shape":"CreateTrackerResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ConflictException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Creates a tracker resource in your Amazon Web Services account, which lets you retrieve current and historical location of devices.</p>", "endpoint":{"hostPrefix":"cp.tracking."}, "idempotent":true }, "DeleteGeofenceCollection":{ "name":"DeleteGeofenceCollection", "http":{ "method":"DELETE", "requestUri":"/geofencing/v0/collections/{CollectionName}", "responseCode":200 }, "input":{"shape":"DeleteGeofenceCollectionRequest"}, "output":{"shape":"DeleteGeofenceCollectionResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Deletes a geofence collection from your Amazon Web Services account.</p> <note> <p>This operation deletes the resource permanently. If the geofence collection is the target of a tracker resource, the devices will no longer be monitored.</p> </note>", "endpoint":{"hostPrefix":"cp.geofencing."}, "idempotent":true }, "DeleteKey":{ "name":"DeleteKey", "http":{ "method":"DELETE", "requestUri":"/metadata/v0/keys/{KeyName}", "responseCode":200 }, "input":{"shape":"DeleteKeyRequest"}, "output":{"shape":"DeleteKeyResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Deletes the specified API key. The API key must have been deactivated more than 90 days previously.</p> <p>For more information, see <a href=\"https://docs.aws.amazon.com/location/latest/developerguide/using-apikeys.html\">Use API keys to authenticate</a> in the <i>Amazon Location Service Developer Guide</i>.</p>", "endpoint":{"hostPrefix":"cp.metadata."}, "idempotent":true }, "DeleteMap":{ "name":"DeleteMap", "http":{ "method":"DELETE", "requestUri":"/maps/v0/maps/{MapName}", "responseCode":200 }, "input":{"shape":"DeleteMapRequest"}, "output":{"shape":"DeleteMapResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend upgrading to the Maps API V2 unless you require <code>Grab</code> data.</p> <ul> <li> <p> <code>DeleteMap</code> is part of a previous Amazon Location Service Maps API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The Maps API version 2 has a simplified interface that can be used without creating or managing map resources.</p> </li> <li> <p>If you are using an AWS SDK or the AWS CLI, note that the Maps API version 2 is found under <code>geo-maps</code> or <code>geo_maps</code>, not under <code>location</code>.</p> </li> <li> <p>Since <code>Grab</code> is not yet fully supported in Maps API version 2, we recommend you continue using API version 1 when using <code>Grab</code>.</p> </li> <li> <p>Start your version 2 API journey with the <a href=\"https://docs.aws.amazon.com/location/latest/APIReference/API_Operations_Amazon_Location_Service_Maps_V2.html\">Maps V2 API Reference</a> or the <a href=\"https://docs.aws.amazon.com/location/latest/developerguide/maps.html\">Developer Guide</a>.</p> </li> </ul> </important> <p>Deletes a map resource from your Amazon Web Services account.</p> <note> <p>This operation deletes the resource permanently. If the map is being used in an application, the map may not render.</p> </note></p>", "endpoint":{"hostPrefix":"cp.maps."}, "idempotent":true }, "DeletePlaceIndex":{ "name":"DeletePlaceIndex", "http":{ "method":"DELETE", "requestUri":"/places/v0/indexes/{IndexName}", "responseCode":200 }, "input":{"shape":"DeletePlaceIndexRequest"}, "output":{"shape":"DeletePlaceIndexResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend you upgrade to the Places API V2 unless you require Grab data.</p> <ul> <li> <p> <code>DeletePlaceIndex</code> is part of a previous Amazon Location Service Places API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The Places API version 2 has a simplified interface that can be used without creating or managing place index resources.</p> </li> <li> <p>If you are using an Amazon Web Services SDK or the Amazon Web Services CLI, note that the Places API version 2 is found under <code>geo-places</code> or <code>geo_places</code>, not under <code>location</code>.</p> </li> <li> <p>Since Grab is not yet fully supported in Places API version 2, we recommend you continue using API version 1 when using Grab.</p> </li> <li> <p>Start your version 2 API journey with the Places V2 <a href=\"/location/latest/APIReference/API_Operations_Amazon_Location_Service_Places_V2.html\">API Reference</a> or the <a href=\"/location/latest/developerguide/places.html\">Developer Guide</a>.</p> </li> </ul> </important> <p>Deletes a place index resource from your Amazon Web Services account.</p> <note> <p>This operation deletes the resource permanently.</p> </note></p>", "endpoint":{"hostPrefix":"cp.places."}, "idempotent":true }, "DeleteRouteCalculator":{ "name":"DeleteRouteCalculator", "http":{ "method":"DELETE", "requestUri":"/routes/v0/calculators/{CalculatorName}", "responseCode":200 }, "input":{"shape":"DeleteRouteCalculatorRequest"}, "output":{"shape":"DeleteRouteCalculatorResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend you upgrade to the Routes API V2 unless you require Grab data.</p> <ul> <li> <p> <code>DeleteRouteCalculator</code> is part of a previous Amazon Location Service Routes API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The Routes API version 2 has a simplified interface that can be used without creating or managing route calculator resources.</p> </li> <li> <p>If you are using an Amazon Web Services SDK or the Amazon Web Services CLI, note that the Routes API version 2 is found under <code>geo-routes</code> or <code>geo_routes</code>, not under <code>location</code>.</p> </li> <li> <p>Since Grab is not yet fully supported in Routes API version 2, we recommend you continue using API version 1 when using Grab.</p> </li> <li> <p>Start your version 2 API journey with the Routes V2 <a href=\"/location/latest/APIReference/API_Operations_Amazon_Location_Service_Routes_V2.html\">API Reference</a> or the <a href=\"/location/latest/developerguide/routes.html\">Developer Guide</a>.</p> </li> </ul> </important> <p>Deletes a route calculator resource from your Amazon Web Services account.</p> <note> <p>This operation deletes the resource permanently.</p> </note></p>", "endpoint":{"hostPrefix":"cp.routes."}, "idempotent":true }, "DeleteTracker":{ "name":"DeleteTracker", "http":{ "method":"DELETE", "requestUri":"/tracking/v0/trackers/{TrackerName}", "responseCode":200 }, "input":{"shape":"DeleteTrackerRequest"}, "output":{"shape":"DeleteTrackerResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Deletes a tracker resource from your Amazon Web Services account.</p> <note> <p>This operation deletes the resource permanently. If the tracker resource is in use, you may encounter an error. Make sure that the target resource isn't a dependency for your applications.</p> </note>", "endpoint":{"hostPrefix":"cp.tracking."}, "idempotent":true }, "DescribeGeofenceCollection":{ "name":"DescribeGeofenceCollection", "http":{ "method":"GET", "requestUri":"/geofencing/v0/collections/{CollectionName}", "responseCode":200 }, "input":{"shape":"DescribeGeofenceCollectionRequest"}, "output":{"shape":"DescribeGeofenceCollectionResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Retrieves the geofence collection details.</p>", "endpoint":{"hostPrefix":"cp.geofencing."}, "readonly":true }, "DescribeKey":{ "name":"DescribeKey", "http":{ "method":"GET", "requestUri":"/metadata/v0/keys/{KeyName}", "responseCode":200 }, "input":{"shape":"DescribeKeyRequest"}, "output":{"shape":"DescribeKeyResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Retrieves the API key resource details.</p> <p>For more information, see <a href=\"https://docs.aws.amazon.com/location/latest/developerguide/using-apikeys.html\">Use API keys to authenticate</a> in the <i>Amazon Location Service Developer Guide</i>.</p>", "endpoint":{"hostPrefix":"cp.metadata."}, "readonly":true }, "DescribeMap":{ "name":"DescribeMap", "http":{ "method":"GET", "requestUri":"/maps/v0/maps/{MapName}", "responseCode":200 }, "input":{"shape":"DescribeMapRequest"}, "output":{"shape":"DescribeMapResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend upgrading to the Maps API V2 unless you require <code>Grab</code> data.</p> <ul> <li> <p> <code>DescribeMap</code> is part of a previous Amazon Location Service Maps API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The Maps API version 2 has a simplified interface that can be used without creating or managing map resources.</p> </li> <li> <p>If you are using an AWS SDK or the AWS CLI, note that the Maps API version 2 is found under <code>geo-maps</code> or <code>geo_maps</code>, not under <code>location</code>.</p> </li> <li> <p>Since <code>Grab</code> is not yet fully supported in Maps API version 2, we recommend you continue using API version 1 when using <code>Grab</code>.</p> </li> <li> <p>Start your version 2 API journey with the <a href=\"https://docs.aws.amazon.com/location/latest/APIReference/API_Operations_Amazon_Location_Service_Maps_V2.html\">Maps V2 API Reference</a> or the <a href=\"https://docs.aws.amazon.com/location/latest/developerguide/maps.html\">Developer Guide</a>.</p> </li> </ul> </important> <p>Retrieves the map resource details.</p></p>", "endpoint":{"hostPrefix":"cp.maps."}, "readonly":true }, "DescribePlaceIndex":{ "name":"DescribePlaceIndex", "http":{ "method":"GET", "requestUri":"/places/v0/indexes/{IndexName}", "responseCode":200 }, "input":{"shape":"DescribePlaceIndexRequest"}, "output":{"shape":"DescribePlaceIndexResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend you upgrade to the Places API V2 unless you require Grab data.</p> <ul> <li> <p> <code>DescribePlaceIndex</code> is part of a previous Amazon Location Service Places API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The Places API version 2 has a simplified interface that can be used without creating or managing place index resources.</p> </li> <li> <p>If you are using an Amazon Web Services SDK or the Amazon Web Services CLI, note that the Places API version 2 is found under <code>geo-places</code> or <code>geo_places</code>, not under <code>location</code>.</p> </li> <li> <p>Since Grab is not yet fully supported in Places API version 2, we recommend you continue using API version 1 when using Grab.</p> </li> <li> <p>Start your version 2 API journey with the Places V2 <a href=\"/location/latest/APIReference/API_Operations_Amazon_Location_Service_Places_V2.html\">API Reference</a> or the <a href=\"/location/latest/developerguide/places.html\">Developer Guide</a>.</p> </li> </ul> </important> <p>Retrieves the place index resource details.</p></p>", "endpoint":{"hostPrefix":"cp.places."}, "readonly":true }, "DescribeRouteCalculator":{ "name":"DescribeRouteCalculator", "http":{ "method":"GET", "requestUri":"/routes/v0/calculators/{CalculatorName}", "responseCode":200 }, "input":{"shape":"DescribeRouteCalculatorRequest"}, "output":{"shape":"DescribeRouteCalculatorResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend you upgrade to the Routes API V2 unless you require Grab data.</p> <ul> <li> <p> <code>DescribeRouteCalculator</code> is part of a previous Amazon Location Service Routes API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The Routes API version 2 has a simplified interface that can be used without creating or managing route calculator resources.</p> </li> <li> <p>If you are using an Amazon Web Services SDK or the Amazon Web Services CLI, note that the Routes API version 2 is found under <code>geo-routes</code> or <code>geo_routes</code>, not under <code>location</code>.</p> </li> <li> <p>Since Grab is not yet fully supported in Routes API version 2, we recommend you continue using API version 1 when using Grab.</p> </li> <li> <p>Start your version 2 API journey with the Routes V2 <a href=\"/location/latest/APIReference/API_Operations_Amazon_Location_Service_Routes_V2.html\">API Reference</a> or the <a href=\"/location/latest/developerguide/routes.html\">Developer Guide</a>.</p> </li> </ul> </important> <p>Retrieves the route calculator resource details.</p></p>", "endpoint":{"hostPrefix":"cp.routes."}, "readonly":true }, "DescribeTracker":{ "name":"DescribeTracker", "http":{ "method":"GET", "requestUri":"/tracking/v0/trackers/{TrackerName}", "responseCode":200 }, "input":{"shape":"DescribeTrackerRequest"}, "output":{"shape":"DescribeTrackerResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Retrieves the tracker resource details.</p>", "endpoint":{"hostPrefix":"cp.tracking."}, "readonly":true }, "DisassociateTrackerConsumer":{ "name":"DisassociateTrackerConsumer", "http":{ "method":"DELETE", "requestUri":"/tracking/v0/trackers/{TrackerName}/consumers/{ConsumerArn}", "responseCode":200 }, "input":{"shape":"DisassociateTrackerConsumerRequest"}, "output":{"shape":"DisassociateTrackerConsumerResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Removes the association between a tracker resource and a geofence collection.</p> <note> <p>Once you unlink a tracker resource from a geofence collection, the tracker positions will no longer be automatically evaluated against geofences.</p> </note>", "endpoint":{"hostPrefix":"cp.tracking."} }, "ForecastGeofenceEvents":{ "name":"ForecastGeofenceEvents", "http":{ "method":"POST", "requestUri":"/geofencing/v0/collections/{CollectionName}/forecast-geofence-events", "responseCode":200 }, "input":{"shape":"ForecastGeofenceEventsRequest"}, "output":{"shape":"ForecastGeofenceEventsResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>This action forecasts future geofence events that are likely to occur within a specified time horizon if a device continues moving at its current speed. Each forecasted event is associated with a geofence from a provided geofence collection. A forecast event can have one of the following states:</p> <p> <code>ENTER</code>: The device position is outside the referenced geofence, but the device may cross into the geofence during the forecasting time horizon if it maintains its current speed.</p> <p> <code>EXIT</code>: The device position is inside the referenced geofence, but the device may leave the geofence during the forecasted time horizon if the device maintains it's current speed.</p> <p> <code>IDLE</code>:The device is inside the geofence, and it will remain inside the geofence through the end of the time horizon if the device maintains it's current speed.</p> <note> <p>Heading direction is not considered in the current version. The API takes a conservative approach and includes events that can occur for any heading.</p> </note>", "endpoint":{"hostPrefix":"geofencing."}, "readonly":true }, "GetDevicePosition":{ "name":"GetDevicePosition", "http":{ "method":"GET", "requestUri":"/tracking/v0/trackers/{TrackerName}/devices/{DeviceId}/positions/latest", "responseCode":200 }, "input":{"shape":"GetDevicePositionRequest"}, "output":{"shape":"GetDevicePositionResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Retrieves a device's most recent position according to its sample time.</p> <note> <p>Device positions are deleted after 30 days.</p> </note>", "endpoint":{"hostPrefix":"tracking."}, "readonly":true }, "GetDevicePositionHistory":{ "name":"GetDevicePositionHistory", "http":{ "method":"POST", "requestUri":"/tracking/v0/trackers/{TrackerName}/devices/{DeviceId}/list-positions", "responseCode":200 }, "input":{"shape":"GetDevicePositionHistoryRequest"}, "output":{"shape":"GetDevicePositionHistoryResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Retrieves the device position history from a tracker resource within a specified range of time.</p> <note> <p>Device positions are deleted after 30 days.</p> </note>", "endpoint":{"hostPrefix":"tracking."}, "readonly":true }, "GetGeofence":{ "name":"GetGeofence", "http":{ "method":"GET", "requestUri":"/geofencing/v0/collections/{CollectionName}/geofences/{GeofenceId}", "responseCode":200 }, "input":{"shape":"GetGeofenceRequest"}, "output":{"shape":"GetGeofenceResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Retrieves the geofence details from a geofence collection.</p> <note> <p>The returned geometry will always match the geometry format used when the geofence was created.</p> </note>", "endpoint":{"hostPrefix":"geofencing."}, "readonly":true }, "GetMapGlyphs":{ "name":"GetMapGlyphs", "http":{ "method":"GET", "requestUri":"/maps/v0/maps/{MapName}/glyphs/{FontStack}/{FontUnicodeRange}", "responseCode":200 }, "input":{"shape":"GetMapGlyphsRequest"}, "output":{"shape":"GetMapGlyphsResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend upgrading to <a href=\"https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetGlyphs.html\"> <code>GetGlyphs</code> </a> unless you require <code>Grab</code> data.</p> <ul> <li> <p> <code>GetMapGlyphs</code> is part of a previous Amazon Location Service Maps API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The version 2 <code>GetGlyphs</code> operation gives a better user experience and is compatible with the remainder of the V2 Maps API.</p> </li> <li> <p>If you are using an AWS SDK or the AWS CLI, note that the Maps API version 2 is found under <code>geo-maps</code> or <code>geo_maps</code>, not under <code>location</code>.</p> </li> <li> <p>Since <code>Grab</code> is not yet fully supported in Maps API version 2, we recommend you continue using API version 1 when using <code>Grab</code>.</p> </li> <li> <p>Start your version 2 API journey with the <a href=\"https://docs.aws.amazon.com/location/latest/APIReference/API_Operations_Amazon_Location_Service_Maps_V2.html\">Maps V2 API Reference</a> or the <a href=\"https://docs.aws.amazon.com/location/latest/developerguide/maps.html\">Developer Guide</a>.</p> </li> </ul> </important> <p>Retrieves glyphs used to display labels on a map.</p></p>", "endpoint":{"hostPrefix":"maps."}, "readonly":true }, "GetMapSprites":{ "name":"GetMapSprites", "http":{ "method":"GET", "requestUri":"/maps/v0/maps/{MapName}/sprites/{FileName}", "responseCode":200 }, "input":{"shape":"GetMapSpritesRequest"}, "output":{"shape":"GetMapSpritesResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend upgrading to <a href=\"https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetSprites.html\"> <code>GetSprites</code> </a> unless you require <code>Grab</code> data.</p> <ul> <li> <p> <code>GetMapSprites</code> is part of a previous Amazon Location Service Maps API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The version 2 <code>GetSprites</code> operation gives a better user experience and is compatible with the remainder of the V2 Maps API.</p> </li> <li> <p>If you are using an AWS SDK or the AWS CLI, note that the Maps API version 2 is found under <code>geo-maps</code> or <code>geo_maps</code>, not under <code>location</code>.</p> </li> <li> <p>Since <code>Grab</code> is not yet fully supported in Maps API version 2, we recommend you continue using API version 1 when using <code>Grab</code>.</p> </li> <li> <p>Start your version 2 API journey with the <a href=\"https://docs.aws.amazon.com/location/latest/APIReference/API_Operations_Amazon_Location_Service_Maps_V2.html\">Maps V2 API Reference</a> or the <a href=\"https://docs.aws.amazon.com/location/latest/developerguide/maps.html\">Developer Guide</a>.</p> </li> </ul> </important> <p>Retrieves the sprite sheet corresponding to a map resource. The sprite sheet is a PNG image paired with a JSON document describing the offsets of individual icons that will be displayed on a rendered map.</p></p>", "endpoint":{"hostPrefix":"maps."}, "readonly":true }, "GetMapStyleDescriptor":{ "name":"GetMapStyleDescriptor", "http":{ "method":"GET", "requestUri":"/maps/v0/maps/{MapName}/style-descriptor", "responseCode":200 }, "input":{"shape":"GetMapStyleDescriptorRequest"}, "output":{"shape":"GetMapStyleDescriptorResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend upgrading to <a href=\"https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetStyleDescriptor.html\"> <code>GetStyleDescriptor</code> </a> unless you require <code>Grab</code> data.</p> <ul> <li> <p> <code>GetMapStyleDescriptor</code> is part of a previous Amazon Location Service Maps API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The version 2 <code>GetStyleDescriptor</code> operation gives a better user experience and is compatible with the remainder of the V2 Maps API.</p> </li> <li> <p>If you are using an AWS SDK or the AWS CLI, note that the Maps API version 2 is found under <code>geo-maps</code> or <code>geo_maps</code>, not under <code>location</code>.</p> </li> <li> <p>Since <code>Grab</code> is not yet fully supported in Maps API version 2, we recommend you continue using API version 1 when using <code>Grab</code>.</p> </li> <li> <p>Start your version 2 API journey with the <a href=\"https://docs.aws.amazon.com/location/latest/APIReference/API_Operations_Amazon_Location_Service_Maps_V2.html\">Maps V2 API Reference</a> or the <a href=\"https://docs.aws.amazon.com/location/latest/developerguide/maps.html\">Developer Guide</a>.</p> </li> </ul> </important> <p>Retrieves the map style descriptor from a map resource. </p> <p>The style descriptor contains specifications on how features render on a map. For example, what data to display, what order to display the data in, and the style for the data. Style descriptors follow the Mapbox Style Specification.</p></p>", "endpoint":{"hostPrefix":"maps."}, "readonly":true }, "GetMapTile":{ "name":"GetMapTile", "http":{ "method":"GET", "requestUri":"/maps/v0/maps/{MapName}/tiles/{Z}/{X}/{Y}", "responseCode":200 }, "input":{"shape":"GetMapTileRequest"}, "output":{"shape":"GetMapTileResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend upgrading to <a href=\"https://docs.aws.amazon.com/location/latest/APIReference/API_geomaps_GetTile.html\"> <code>GetTile</code> </a> unless you require <code>Grab</code> data.</p> <ul> <li> <p> <code>GetMapTile</code> is part of a previous Amazon Location Service Maps API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The version 2 <code>GetTile</code> operation gives a better user experience and is compatible with the remainder of the V2 Maps API.</p> </li> <li> <p>If you are using an AWS SDK or the AWS CLI, note that the Maps API version 2 is found under <code>geo-maps</code> or <code>geo_maps</code>, not under <code>location</code>.</p> </li> <li> <p>Since <code>Grab</code> is not yet fully supported in Maps API version 2, we recommend you continue using API version 1 when using <code>Grab</code>.</p> </li> <li> <p>Start your version 2 API journey with the <a href=\"https://docs.aws.amazon.com/location/latest/APIReference/API_Operations_Amazon_Location_Service_Maps_V2.html\">Maps V2 API Reference</a> or the <a href=\"https://docs.aws.amazon.com/location/latest/developerguide/maps.html\">Developer Guide</a>.</p> </li> </ul> </important> <p>Retrieves a vector data tile from the map resource. Map tiles are used by clients to render a map. they're addressed using a grid arrangement with an X coordinate, Y coordinate, and Z (zoom) level. </p> <p>The origin (0, 0) is the top left of the map. Increasing the zoom level by 1 doubles both the X and Y dimensions, so a tile containing data for the entire world at (0/0/0) will be split into 4 tiles at zoom 1 (1/0/0, 1/0/1, 1/1/0, 1/1/1).</p></p>", "endpoint":{"hostPrefix":"maps."}, "readonly":true }, "GetPlace":{ "name":"GetPlace", "http":{ "method":"GET", "requestUri":"/places/v0/indexes/{IndexName}/places/{PlaceId}", "responseCode":200 }, "input":{"shape":"GetPlaceRequest"}, "output":{"shape":"GetPlaceResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend you upgrade to the <a href=\"/location/latest/APIReference/API_geoplaces_GetPlace.html\">V2 <code>GetPlace</code> </a> operation unless you require Grab data.</p> <ul> <li> <p>This version of <code>GetPlace</code> is part of a previous Amazon Location Service Places API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>Version 2 of the <code>GetPlace</code> operation interoperates with the rest of the Places V2 API, while this version does not.</p> </li> <li> <p>If you are using an Amazon Web Services SDK or the Amazon Web Services CLI, note that the Places API version 2 is found under <code>geo-places</code> or <code>geo_places</code>, not under <code>location</code>.</p> </li> <li> <p>Since Grab is not yet fully supported in Places API version 2, we recommend you continue using API version 1 when using Grab.</p> </li> <li> <p>Start your version 2 API journey with the Places V2 <a href=\"/location/latest/APIReference/API_Operations_Amazon_Location_Service_Places_V2.html\">API Reference</a> or the <a href=\"/location/latest/developerguide/places.html\">Developer Guide</a>.</p> </li> </ul> </important> <p>Finds a place by its unique ID. A <code>PlaceId</code> is returned by other search operations.</p> <note> <p>A PlaceId is valid only if all of the following are the same in the original search request and the call to <code>GetPlace</code>.</p> <ul> <li> <p>Customer Amazon Web Services account</p> </li> <li> <p>Amazon Web Services Region</p> </li> <li> <p>Data provider specified in the place index resource</p> </li> </ul> </note> <note> <p>If your Place index resource is configured with Grab as your geolocation provider and Storage as Intended use, the GetPlace operation is unavailable. For more information, see <a href=\"http://aws.amazon.com/service-terms\">AWS service terms</a>.</p> </note></p>", "endpoint":{"hostPrefix":"places."}, "readonly":true }, "ListDevicePositions":{ "name":"ListDevicePositions", "http":{ "method":"POST", "requestUri":"/tracking/v0/trackers/{TrackerName}/list-positions", "responseCode":200 }, "input":{"shape":"ListDevicePositionsRequest"}, "output":{"shape":"ListDevicePositionsResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>A batch request to retrieve all device positions.</p>", "endpoint":{"hostPrefix":"tracking."}, "readonly":true }, "ListGeofenceCollections":{ "name":"ListGeofenceCollections", "http":{ "method":"POST", "requestUri":"/geofencing/v0/list-collections", "responseCode":200 }, "input":{"shape":"ListGeofenceCollectionsRequest"}, "output":{"shape":"ListGeofenceCollectionsResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Lists geofence collections in your Amazon Web Services account.</p>", "endpoint":{"hostPrefix":"cp.geofencing."}, "readonly":true }, "ListGeofences":{ "name":"ListGeofences", "http":{ "method":"POST", "requestUri":"/geofencing/v0/collections/{CollectionName}/list-geofences", "responseCode":200 }, "input":{"shape":"ListGeofencesRequest"}, "output":{"shape":"ListGeofencesResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Lists geofences stored in a given geofence collection.</p>", "endpoint":{"hostPrefix":"geofencing."}, "readonly":true }, "ListKeys":{ "name":"ListKeys", "http":{ "method":"POST", "requestUri":"/metadata/v0/list-keys", "responseCode":200 }, "input":{"shape":"ListKeysRequest"}, "output":{"shape":"ListKeysResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Lists API key resources in your Amazon Web Services account.</p> <p>For more information, see <a href=\"https://docs.aws.amazon.com/location/latest/developerguide/using-apikeys.html\">Use API keys to authenticate</a> in the <i>Amazon Location Service Developer Guide</i>.</p>", "endpoint":{"hostPrefix":"cp.metadata."}, "readonly":true }, "ListMaps":{ "name":"ListMaps", "http":{ "method":"POST", "requestUri":"/maps/v0/list-maps", "responseCode":200 }, "input":{"shape":"ListMapsRequest"}, "output":{"shape":"ListMapsResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend upgrading to the Maps API V2 unless you require <code>Grab</code> data.</p> <ul> <li> <p> <code>ListMaps</code> is part of a previous Amazon Location Service Maps API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The Maps API version 2 has a simplified interface that can be used without creating or managing map resources.</p> </li> <li> <p>If you are using an AWS SDK or the AWS CLI, note that the Maps API version 2 is found under <code>geo-maps</code> or <code>geo_maps</code>, not under <code>location</code>.</p> </li> <li> <p>Since <code>Grab</code> is not yet fully supported in Maps API version 2, we recommend you continue using API version 1 when using <code>Grab</code>.</p> </li> <li> <p>Start your version 2 API journey with the <a href=\"https://docs.aws.amazon.com/location/latest/APIReference/API_Operations_Amazon_Location_Service_Maps_V2.html\">Maps V2 API Reference</a> or the <a href=\"https://docs.aws.amazon.com/location/latest/developerguide/maps.html\">Developer Guide</a>.</p> </li> </ul> </important> <p>Lists map resources in your Amazon Web Services account.</p></p>", "endpoint":{"hostPrefix":"cp.maps."}, "readonly":true }, "ListPlaceIndexes":{ "name":"ListPlaceIndexes", "http":{ "method":"POST", "requestUri":"/places/v0/list-indexes", "responseCode":200 }, "input":{"shape":"ListPlaceIndexesRequest"}, "output":{"shape":"ListPlaceIndexesResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend you upgrade to the Places API V2 unless you require Grab data.</p> <ul> <li> <p> <code>ListPlaceIndexes</code> is part of a previous Amazon Location Service Places API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The Places API version 2 has a simplified interface that can be used without creating or managing place index resources.</p> </li> <li> <p>If you are using an Amazon Web Services SDK or the Amazon Web Services CLI, note that the Places API version 2 is found under <code>geo-places</code> or <code>geo_places</code>, not under <code>location</code>.</p> </li> <li> <p>Since Grab is not yet fully supported in Places API version 2, we recommend you continue using API version 1 when using Grab.</p> </li> <li> <p>Start your version 2 API journey with the Places V2 <a href=\"/location/latest/APIReference/API_Operations_Amazon_Location_Service_Places_V2.html\">API Reference</a> or the <a href=\"/location/latest/developerguide/places.html\">Developer Guide</a>.</p> </li> </ul> </important> <p>Lists place index resources in your Amazon Web Services account.</p></p>", "endpoint":{"hostPrefix":"cp.places."}, "readonly":true }, "ListRouteCalculators":{ "name":"ListRouteCalculators", "http":{ "method":"POST", "requestUri":"/routes/v0/list-calculators", "responseCode":200 }, "input":{"shape":"ListRouteCalculatorsRequest"}, "output":{"shape":"ListRouteCalculatorsResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend you upgrade to the Routes API V2 unless you require Grab data.</p> <ul> <li> <p> <code>ListRouteCalculators</code> is part of a previous Amazon Location Service Routes API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The Routes API version 2 has a simplified interface that can be used without creating or managing route calculator resources.</p> </li> <li> <p>If you are using an Amazon Web Services SDK or the Amazon Web Services CLI, note that the Routes API version 2 is found under <code>geo-routes</code> or <code>geo_routes</code>, not under <code>location</code>.</p> </li> <li> <p>Since Grab is not yet fully supported in Routes API version 2, we recommend you continue using API version 1 when using Grab.</p> </li> <li> <p>Start your version 2 API journey with the Routes V2 <a href=\"/location/latest/APIReference/API_Operations_Amazon_Location_Service_Routes_V2.html\">API Reference</a> or the <a href=\"/location/latest/developerguide/routes.html\">Developer Guide</a>.</p> </li> </ul> </important> <p>Lists route calculator resources in your Amazon Web Services account.</p></p>", "endpoint":{"hostPrefix":"cp.routes."}, "readonly":true }, "ListTagsForResource":{ "name":"ListTagsForResource", "http":{ "method":"GET", "requestUri":"/tags/{ResourceArn}", "responseCode":200 }, "input":{"shape":"ListTagsForResourceRequest"}, "output":{"shape":"ListTagsForResourceResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Returns a list of tags that are applied to the specified Amazon Location resource.</p>", "endpoint":{"hostPrefix":"cp.metadata."}, "readonly":true }, "ListTrackerConsumers":{ "name":"ListTrackerConsumers", "http":{ "method":"POST", "requestUri":"/tracking/v0/trackers/{TrackerName}/list-consumers", "responseCode":200 }, "input":{"shape":"ListTrackerConsumersRequest"}, "output":{"shape":"ListTrackerConsumersResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Lists geofence collections currently associated to the given tracker resource.</p>", "endpoint":{"hostPrefix":"cp.tracking."}, "readonly":true }, "ListTrackers":{ "name":"ListTrackers", "http":{ "method":"POST", "requestUri":"/tracking/v0/list-trackers", "responseCode":200 }, "input":{"shape":"ListTrackersRequest"}, "output":{"shape":"ListTrackersResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Lists tracker resources in your Amazon Web Services account.</p>", "endpoint":{"hostPrefix":"cp.tracking."}, "readonly":true }, "PutGeofence":{ "name":"PutGeofence", "http":{ "method":"PUT", "requestUri":"/geofencing/v0/collections/{CollectionName}/geofences/{GeofenceId}", "responseCode":200 }, "input":{"shape":"PutGeofenceRequest"}, "output":{"shape":"PutGeofenceResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ConflictException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Stores 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. </p>", "endpoint":{"hostPrefix":"geofencing."} }, "SearchPlaceIndexForPosition":{ "name":"SearchPlaceIndexForPosition", "http":{ "method":"POST", "requestUri":"/places/v0/indexes/{IndexName}/search/position", "responseCode":200 }, "input":{"shape":"SearchPlaceIndexForPositionRequest"}, "output":{"shape":"SearchPlaceIndexForPositionResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend you upgrade to <a href=\"/location/latest/APIReference/API_geoplaces_ReverseGeocode.html\"> <code>ReverseGeocode</code> </a> or <a href=\"/location/latest/APIReference/API_geoplaces_SearchNearby.html\"> <code>SearchNearby</code> </a> unless you require Grab data.</p> <ul> <li> <p> <code>SearchPlaceIndexForPosition</code> is part of a previous Amazon Location Service Places API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The version 2 <code>ReverseGeocode</code> operation gives better results in the address reverse-geocoding use case, while the version 2 <code>SearchNearby</code> operation gives better results when searching for businesses and points of interest near a specific location.</p> </li> <li> <p>If you are using an Amazon Web Services SDK or the Amazon Web Services CLI, note that the Places API version 2 is found under <code>geo-places</code> or <code>geo_places</code>, not under <code>location</code>.</p> </li> <li> <p>Since Grab is not yet fully supported in Places API version 2, we recommend you continue using API version 1 when using Grab.</p> </li> </ul> </important> <p>Reverse geocodes a given coordinate and returns a legible address. Allows you to search for Places or points of interest near a given position.</p></p>", "endpoint":{"hostPrefix":"places."}, "readonly":true }, "SearchPlaceIndexForSuggestions":{ "name":"SearchPlaceIndexForSuggestions", "http":{ "method":"POST", "requestUri":"/places/v0/indexes/{IndexName}/search/suggestions", "responseCode":200 }, "input":{"shape":"SearchPlaceIndexForSuggestionsRequest"}, "output":{"shape":"SearchPlaceIndexForSuggestionsResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend you upgrade to <a href=\"/location/latest/APIReference/API_geoplaces_Suggest.html\"> <code>Suggest</code> </a> or <a href=\"/location/latest/APIReference/API_geoplaces_Autocomplete.html\"> <code>Autocomplete</code> </a> unless you require Grab data.</p> <ul> <li> <p> <code>SearchPlaceIndexForSuggestions</code> is part of a previous Amazon Location Service Places API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The version 2 <code>Suggest</code> operation gives better results for typeahead place search suggestions with fuzzy matching, while the version 2 <code>Autocomplete</code> operation gives better results for address completion based on partial input.</p> </li> <li> <p>If you are using an Amazon Web Services SDK or the Amazon Web Services CLI, note that the Places API version 2 is found under <code>geo-places</code> or <code>geo_places</code>, not under <code>location</code>.</p> </li> <li> <p>Since Grab is not yet fully supported in Places API version 2, we recommend you continue using API version 1 when using Grab.</p> </li> </ul> </important> <p>Generates suggestions for addresses and points of interest based on partial or misspelled free-form text. This operation is also known as autocomplete, autosuggest, or fuzzy matching.</p> <p>Optional parameters let you narrow your search results by bounding box or country, or bias your search toward a specific position on the globe.</p> <note> <p>You can search for suggested place names near a specified position by using <code>BiasPosition</code>, or filter results within a bounding box by using <code>FilterBBox</code>. These parameters are mutually exclusive; using both <code>BiasPosition</code> and <code>FilterBBox</code> in the same command returns an error.</p> </note></p>", "endpoint":{"hostPrefix":"places."}, "readonly":true }, "SearchPlaceIndexForText":{ "name":"SearchPlaceIndexForText", "http":{ "method":"POST", "requestUri":"/places/v0/indexes/{IndexName}/search/text", "responseCode":200 }, "input":{"shape":"SearchPlaceIndexForTextRequest"}, "output":{"shape":"SearchPlaceIndexForTextResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend you upgrade to <a href=\"/location/latest/APIReference/API_geoplaces_Geocode.html\"> <code>Geocode</code> </a> or <a href=\"/location/latest/APIReference/API_geoplaces_SearchText.html\"> <code>SearchText</code> </a> unless you require Grab data.</p> <ul> <li> <p> <code>SearchPlaceIndexForText</code> is part of a previous Amazon Location Service Places API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The version 2 <code>Geocode</code> operation gives better results in the address geocoding use case, while the version 2 <code>SearchText</code> operation gives better results when searching for businesses and points of interest.</p> </li> <li> <p>If you are using an Amazon Web Services SDK or the Amazon Web Services CLI, note that the Places API version 2 is found under <code>geo-places</code> or <code>geo_places</code>, not under <code>location</code>.</p> </li> <li> <p>Since Grab is not yet fully supported in Places API version 2, we recommend you continue using API version 1 when using Grab.</p> </li> </ul> </important> <p>Geocodes free-form text, such as an address, name, city, or region to allow you to search for Places or points of interest. </p> <p>Optional parameters let you narrow your search results by bounding box or country, or bias your search toward a specific position on the globe.</p> <note> <p>You can search for places near a given position using <code>BiasPosition</code>, or filter results within a bounding box using <code>FilterBBox</code>. Providing both parameters simultaneously returns an error.</p> </note> <p>Search results are returned in order of highest to lowest relevance.</p></p>", "endpoint":{"hostPrefix":"places."}, "readonly":true }, "TagResource":{ "name":"TagResource", "http":{ "method":"POST", "requestUri":"/tags/{ResourceArn}", "responseCode":200 }, "input":{"shape":"TagResourceRequest"}, "output":{"shape":"TagResourceResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Assigns one or more tags (key-value pairs) to the specified Amazon Location Service resource.</p> <p>Tags can help you organize and categorize your resources. You can also use them to scope user permissions, by granting a user permission to access or change only resources with certain tag values.</p> <p>You can use the <code>TagResource</code> operation with an Amazon Location Service resource that already has tags. If you specify a new tag key for the resource, this tag is appended to the tags already associated with the resource. If you specify a tag key that's already associated with the resource, the new tag value that you specify replaces the previous value for that tag. </p> <p>You can associate up to 50 tags with a resource.</p>", "endpoint":{"hostPrefix":"cp.metadata."} }, "UntagResource":{ "name":"UntagResource", "http":{ "method":"DELETE", "requestUri":"/tags/{ResourceArn}", "responseCode":200 }, "input":{"shape":"UntagResourceRequest"}, "output":{"shape":"UntagResourceResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Removes one or more tags from the specified Amazon Location resource.</p>", "endpoint":{"hostPrefix":"cp.metadata."}, "idempotent":true }, "UpdateGeofenceCollection":{ "name":"UpdateGeofenceCollection", "http":{ "method":"PATCH", "requestUri":"/geofencing/v0/collections/{CollectionName}", "responseCode":200 }, "input":{"shape":"UpdateGeofenceCollectionRequest"}, "output":{"shape":"UpdateGeofenceCollectionResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Updates the specified properties of a given geofence collection.</p>", "endpoint":{"hostPrefix":"cp.geofencing."}, "idempotent":true }, "UpdateKey":{ "name":"UpdateKey", "http":{ "method":"PATCH", "requestUri":"/metadata/v0/keys/{KeyName}", "responseCode":200 }, "input":{"shape":"UpdateKeyRequest"}, "output":{"shape":"UpdateKeyResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Updates the specified properties of a given API key resource.</p>", "endpoint":{"hostPrefix":"cp.metadata."}, "idempotent":true }, "UpdateMap":{ "name":"UpdateMap", "http":{ "method":"PATCH", "requestUri":"/maps/v0/maps/{MapName}", "responseCode":200 }, "input":{"shape":"UpdateMapRequest"}, "output":{"shape":"UpdateMapResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend upgrading to the Maps API V2 unless you require <code>Grab</code> data.</p> <ul> <li> <p> <code>UpdateMap</code> is part of a previous Amazon Location Service Maps API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The Maps API version 2 has a simplified interface that can be used without creating or managing map resources.</p> </li> <li> <p>If you are using an AWS SDK or the AWS CLI, note that the Maps API version 2 is found under <code>geo-maps</code> or <code>geo_maps</code>, not under <code>location</code>.</p> </li> <li> <p>Since <code>Grab</code> is not yet fully supported in Maps API version 2, we recommend you continue using API version 1 when using <code>Grab</code>.</p> </li> <li> <p>Start your version 2 API journey with the <a href=\"https://docs.aws.amazon.com/location/latest/APIReference/API_Operations_Amazon_Location_Service_Maps_V2.html\">Maps V2 API Reference</a> or the <a href=\"https://docs.aws.amazon.com/location/latest/developerguide/maps.html\">Developer Guide</a>.</p> </li> </ul> </important> <p>Updates the specified properties of a given map resource.</p></p>", "endpoint":{"hostPrefix":"cp.maps."}, "idempotent":true }, "UpdatePlaceIndex":{ "name":"UpdatePlaceIndex", "http":{ "method":"PATCH", "requestUri":"/places/v0/indexes/{IndexName}", "responseCode":200 }, "input":{"shape":"UpdatePlaceIndexRequest"}, "output":{"shape":"UpdatePlaceIndexResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend you upgrade to the Places API V2 unless you require Grab data.</p> <ul> <li> <p> <code>UpdatePlaceIndex</code> is part of a previous Amazon Location Service Places API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The Places API version 2 has a simplified interface that can be used without creating or managing place index resources.</p> </li> <li> <p>If you are using an Amazon Web Services SDK or the Amazon Web Services CLI, note that the Places API version 2 is found under <code>geo-places</code> or <code>geo_places</code>, not under <code>location</code>.</p> </li> <li> <p>Since Grab is not yet fully supported in Places API version 2, we recommend you continue using API version 1 when using Grab.</p> </li> <li> <p>Start your version 2 API journey with the Places V2 <a href=\"/location/latest/APIReference/API_Operations_Amazon_Location_Service_Places_V2.html\">API Reference</a> or the <a href=\"/location/latest/developerguide/places.html\">Developer Guide</a>.</p> </li> </ul> </important> <p>Updates the specified properties of a given place index resource.</p></p>", "endpoint":{"hostPrefix":"cp.places."}, "idempotent":true }, "UpdateRouteCalculator":{ "name":"UpdateRouteCalculator", "http":{ "method":"PATCH", "requestUri":"/routes/v0/calculators/{CalculatorName}", "responseCode":200 }, "input":{"shape":"UpdateRouteCalculatorRequest"}, "output":{"shape":"UpdateRouteCalculatorResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p><important> <p>This operation is no longer current and may be deprecated in the future. We recommend you upgrade to the Routes API V2 unless you require Grab data.</p> <ul> <li> <p> <code>UpdateRouteCalculator</code> is part of a previous Amazon Location Service Routes API (version 1) which has been superseded by a more intuitive, powerful, and complete API (version 2).</p> </li> <li> <p>The Routes API version 2 has a simplified interface that can be used without creating or managing route calculator resources.</p> </li> <li> <p>If you are using an Amazon Web Services SDK or the Amazon Web Services CLI, note that the Routes API version 2 is found under <code>geo-routes</code> or <code>geo_routes</code>, not under <code>location</code>.</p> </li> <li> <p>Since Grab is not yet fully supported in Routes API version 2, we recommend you continue using API version 1 when using Grab.</p> </li> <li> <p>Start your version 2 API journey with the Routes V2 <a href=\"/location/latest/APIReference/API_Operations_Amazon_Location_Service_Routes_V2.html\">API Reference</a> or the <a href=\"/location/latest/developerguide/routes.html\">Developer Guide</a>.</p> </li> </ul> </important> <p>Updates the specified properties for a given route calculator resource.</p></p>", "endpoint":{"hostPrefix":"cp.routes."}, "idempotent":true }, "UpdateTracker":{ "name":"UpdateTracker", "http":{ "method":"PATCH", "requestUri":"/tracking/v0/trackers/{TrackerName}", "responseCode":200 }, "input":{"shape":"UpdateTrackerRequest"}, "output":{"shape":"UpdateTrackerResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Updates the specified properties of a given tracker resource.</p>", "endpoint":{"hostPrefix":"cp.tracking."}, "idempotent":true }, "VerifyDevicePosition":{ "name":"VerifyDevicePosition", "http":{ "method":"POST", "requestUri":"/tracking/v0/trackers/{TrackerName}/positions/verify", "responseCode":200 }, "input":{"shape":"VerifyDevicePositionRequest"}, "output":{"shape":"VerifyDevicePositionResponse"}, "errors":[ {"shape":"InternalServerException"}, {"shape":"ResourceNotFoundException"}, {"shape":"AccessDeniedException"}, {"shape":"ValidationException"}, {"shape":"ThrottlingException"} ], "documentation":"<p>Verifies 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.</p> <note> <p>The Location Integrity SDK provides enhanced features related to device verification, and it is available for use by request. To get access to the SDK, contact <a href=\"https://aws.amazon.com/contact-us/sales-support/?pg=locationprice&cta=herobtn\">Sales Support</a>.</p> </note>", "endpoint":{"hostPrefix":"tracking."} } }, "shapes":{ "AccessDeniedException":{ "type":"structure", "required":["Message"], "members":{ "Message":{ "shape":"String", "locationName":"message" } }, "documentation":"<p>The request was denied because of insufficient access or permissions. Check with an administrator to verify your permissions.</p>", "error":{ "httpStatusCode":403, "senderFault":true }, "exception":true }, "AndroidApp":{ "type":"structure", "required":[ "Package", "CertificateFingerprint" ], "members":{ "Package":{ "shape":"AndroidPackageName", "documentation":"<p>Unique package name for an Android app.</p>" }, "CertificateFingerprint":{ "shape":"Sha1CertificateFingerprint", "documentation":"<p>20 byte SHA-1 certificate fingerprint associated with the Android app signing certificate.</p>" } }, "documentation":"<p>Unique identifying information for an Android app. Consists of a package name and a 20 byte SHA-1 certificate fingerprint.</p>" }, "AndroidPackageName":{ "type":"string", "max":255, "min":1, "pattern":"([A-Za-z][A-Za-z\\d_]*\\.)+[A-Za-z][A-Za-z\\d_]*" }, "ApiKey":{ "type":"string", "max":1000, "min":0, "sensitive":true }, "ApiKeyAction":{ "type":"string", "max":200, "min":5, "pattern":"(geo|geo-routes|geo-places|geo-maps):\\w*\\*?" }, "ApiKeyFilter":{ "type":"structure", "members":{ "KeyStatus":{ "shape":"Status", "documentation":"<p>Filter on <code>Active</code> or <code>Expired</code> API keys.</p>" } }, "documentation":"<p>Options for filtering API keys.</p>" }, "ApiKeyRestrictions":{ "type":"structure", "required":[ "AllowActions", "AllowResources" ], "members":{ "AllowActions":{ "shape":"ApiKeyRestrictionsAllowActionsList", "documentation":"<p>A list of allowed actions that an API key resource grants permissions to perform. You must have at least one action for each type of resource. For example, if you have a place resource, you must include at least one place action.</p> <p>The following are valid values for the actions.</p> <ul> <li> <p> <b>Map actions</b> </p> <ul> <li> <p> <code>geo:GetMap*</code> - Allows all actions needed for map rendering.</p> </li> <li> <p> <code>geo-maps:GetTile</code> - Allows retrieving map tiles.</p> </li> <li> <p> <code>geo-maps:GetStaticMap</code> - Allows retrieving static map images.</p> </li> <li> <p> <code>geo-maps:*</code> - Allows all actions related to map functionalities.</p> </li> </ul> </li> <li> <p> <b>Place actions</b> </p> <ul> <li> <p> <code>geo:SearchPlaceIndexForText</code> - Allows geocoding.</p> </li> <li> <p> <code>geo:SearchPlaceIndexForPosition</code> - Allows reverse geocoding.</p> </li> <li> <p> <code>geo:SearchPlaceIndexForSuggestions</code> - Allows generating suggestions from text.</p> </li> <li> <p> <code>GetPlace</code> - Allows finding a place by place ID.</p> </li> <li> <p> <code>geo-places:Geocode</code> - Allows geocoding using place information.</p> </li> <li> <p> <code>geo-places:ReverseGeocode</code> - Allows reverse geocoding from location coordinates.</p> </li> <li> <p> <code>geo-places:SearchNearby</code> - Allows searching for places near a location.</p> </li> <li> <p> <code>geo-places:SearchText</code> - Allows searching for places based on text input.</p> </li> <li> <p> <code>geo-places:Autocomplete</code> - Allows auto-completion of place names based on text input.</p> </li> <li> <p> <code>geo-places:Suggest</code> - Allows generating suggestions for places based on partial input.</p> </li> <li> <p> <code>geo-places:GetPlace</code> - Allows finding a place by its ID.</p> </li> <li> <p> <code>geo-places:*</code> - Allows all actions related to place services.</p> </li> </ul> </li> <li> <p> <b>Route actions</b> </p> <ul> <li> <p> <code>geo:CalculateRoute</code> - Allows point to point routing.</p> </li> <li> <p> <code>geo:CalculateRouteMatrix</code> - Allows calculating a matrix of routes.</p> </li> <li> <p> <code>geo-routes:CalculateRoutes</code> - Allows calculating multiple routes between points.</p> </li> <li> <p> <code>geo-routes:CalculateRouteMatrix</code> - Allows calculating a matrix of routes between points.</p> </li> <li> <p> <code>geo-routes:CalculateIsolines</code> - Allows calculating isolines for a given area.</p> </li> <li> <p> <code>geo-routes:OptimizeWaypoints</code> - Allows optimizing the order of waypoints in a route.</p> </li> <li> <p> <code>geo-routes:SnapToRoads</code> - Allows snapping a route to the nearest roads.</p> </li> <li> <p> <code>geo-routes:*</code> - Allows all actions related to routing functionalities.</p> </li> </ul> </li> </ul> <note> <p>You must use these strings exactly. For example, to provide access to map rendering, the only valid action is <code>geo:GetMap*</code> as an input to the list. <code>[\"geo:GetMap*\"]</code> is valid but <code>[\"geo:GetMapTile\"]</code> is not. Similarly, you cannot use <code>[\"geo:SearchPlaceIndexFor*\"]</code> - you must list each of the Place actions separately.</p> </note>" }, "AllowResources":{ "shape":"ApiKeyRestrictionsAllowResourcesList", "documentation":"<p>A list of allowed resource ARNs that a API key bearer can perform actions on.</p> <ul> <li> <p>The ARN must be the correct ARN for a map, place, or route ARN. You may include wildcards in the resource-id to match multiple resources of the same type.</p> </li> <li> <p>The resources must be in the same <code>partition</code>, <code>region</code>, and <code>account-id</code> as the key that is being created.</p> </li> <li> <p>Other than wildcards, you must include the full ARN, including the <code>arn</code>, <code>partition</code>, <code>service</code>, <code>region</code>, <code>account-id</code> and <code>resource-id</code> delimited by colons (:).</p> </li> <li> <p>No spaces allowed, even with wildcards. For example, <code>arn:aws:geo:region:<i>account-id</i>:map/ExampleMap*</code>.</p> </li> </ul> <p>For more information about ARN format, see <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html\">Amazon Resource Names (ARNs)</a>.</p>" }, "AllowReferers":{ "shape":"ApiKeyRestrictionsAllowReferersList", "documentation":"<p>An optional list of allowed HTTP referers for which requests must originate from. Requests using this API key from other domains will not be allowed.</p> <p>Requirements:</p> <ul> <li> <p>Contain only alphanumeric characters (A–Z, a–z, 0–9) or any symbols in this list <code>$\\-._+!*`(),;/?:@=&</code> </p> </li> <li> <p>May contain a percent (%) if followed by 2 hexadecimal digits (A-F, a-f, 0-9); this is used for URL encoding purposes.</p> </li> <li> <p>May contain wildcard characters question mark (?) and asterisk (*).</p> <p>Question mark (?) will replace any single character (including hexadecimal digits).</p> <p>Asterisk (*) will replace any multiple characters (including multiple hexadecimal digits).</p> </li> <li> <p>No spaces allowed. For example, <code>https://example.com</code>.</p> </li> </ul>" }, "AllowAndroidApps":{ "shape":"ApiKeyRestrictionsAllowAndroidAppsList", "documentation":"<p>An optional list of allowed Android applications for which requests must originate from. Requests using this API key from other sources will not be allowed.</p>" }, "AllowAppleApps":{ "shape":"ApiKeyRestrictionsAllowAppleAppsList", "documentation":"<p>An optional list of allowed Apple applications for which requests must originate from. Requests using this API key from other sources will not be allowed.</p>" } }, "documentation":"<p>API Restrictions on the allowed actions, resources, and referers for an API key resource.</p>" }, "ApiKeyRestrictionsAllowActionsList":{ "type":"list", "member":{"shape":"ApiKeyAction"}, "max":24, "min":1 }, "ApiKeyRestrictionsAllowAndroidAppsList":{ "type":"list", "member":{"shape":"AndroidApp"}, "max":5, "min":0 }, "ApiKeyRestrictionsAllowAppleAppsList":{ "type":"list", "member":{"shape":"AppleApp"}, "max":5, "min":0 }, "ApiKeyRestrictionsAllowReferersList":{ "type":"list", "member":{"shape":"RefererPattern"}, "max":5, "min":0 }, "ApiKeyRestrictionsAllowResourcesList":{ "type":"list", "member":{"shape":"GeoArnV2"}, "max":8, "min":1 }, "AppleApp":{ "type":"structure", "required":["BundleId"], "members":{ "BundleId":{ "shape":"AppleBundleId", "documentation":"<p>The unique identifier of the app across all Apple platforms (iOS, macOS, tvOS, watchOS, etc.)</p>" } }, "documentation":"<p>Unique identifying information for an Apple app (iOS, macOS, tvOS and watchOS). Consists of an Apple Bundle ID.</p>" }, "AppleBundleId":{ "type":"string", "max":155, "min":1, "pattern":"[A-Za-z0-9\\-]+(\\.[A-Za-z0-9\\-]+)+" }, "Arn":{ "type":"string", "max":1600, "min":0, "pattern":"arn(:[a-z0-9]+([.-][a-z0-9]+)*){2}(:([a-z0-9]+([.-][a-z0-9]+)*)?){2}:([^/].*)?" }, "ArnList":{ "type":"list", "member":{"shape":"Arn"} }, "AssociateTrackerConsumerRequest":{ "type":"structure", "required":[ "TrackerName", "ConsumerArn" ], "members":{ "TrackerName":{ "shape":"ResourceName", "documentation":"<p>The name of the tracker resource to be associated with a geofence collection.</p>", "location":"uri", "locationName":"TrackerName" }, "ConsumerArn":{ "shape":"Arn", "documentation":"<p>The Amazon Resource Name (ARN) for the geofence collection to be associated to tracker resource. Used when you need to specify a resource across all Amazon Web Services.</p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:geofence-collection/ExampleGeofenceCollectionConsumer</code> </p> </li> </ul>" } } }, "AssociateTrackerConsumerResponse":{ "type":"structure", "members":{} }, "Base64EncodedGeobuf":{ "type":"blob", "max":700000, "min":0, "sensitive":true }, "BatchDeleteDevicePositionHistoryError":{ "type":"structure", "required":[ "DeviceId", "Error" ], "members":{ "DeviceId":{ "shape":"Id", "documentation":"<p>The ID of the device for this position.</p>" }, "Error":{"shape":"BatchItemError"} }, "documentation":"<p>Contains the tracker resource details.</p>" }, "BatchDeleteDevicePositionHistoryErrorList":{ "type":"list", "member":{"shape":"BatchDeleteDevicePositionHistoryError"} }, "BatchDeleteDevicePositionHistoryRequest":{ "type":"structure", "required":[ "TrackerName", "DeviceIds" ], "members":{ "TrackerName":{ "shape":"ResourceName", "documentation":"<p>The name of the tracker resource to delete the device position history from.</p>", "location":"uri", "locationName":"TrackerName" }, "DeviceIds":{ "shape":"BatchDeleteDevicePositionHistoryRequestDeviceIdsList", "documentation":"<p>Devices whose position history you want to delete.</p> <ul> <li> <p>For example, for two devices: <code>“DeviceIds” : [DeviceId1,DeviceId2]</code> </p> </li> </ul>" } } }, "BatchDeleteDevicePositionHistoryRequestDeviceIdsList":{ "type":"list", "member":{"shape":"Id"}, "max":100, "min":1 }, "BatchDeleteDevicePositionHistoryResponse":{ "type":"structure", "required":["Errors"], "members":{ "Errors":{ "shape":"BatchDeleteDevicePositionHistoryErrorList", "documentation":"<p>Contains error details for each device history that failed to delete.</p>" } } }, "BatchDeleteGeofenceError":{ "type":"structure", "required":[ "GeofenceId", "Error" ], "members":{ "GeofenceId":{ "shape":"Id", "documentation":"<p>The geofence associated with the error message.</p>" }, "Error":{ "shape":"BatchItemError", "documentation":"<p>Contains details associated to the batch error.</p>" } }, "documentation":"<p>Contains error details for each geofence that failed to delete from the geofence collection.</p>" }, "BatchDeleteGeofenceErrorList":{ "type":"list", "member":{"shape":"BatchDeleteGeofenceError"} }, "BatchDeleteGeofenceRequest":{ "type":"structure", "required":[ "CollectionName", "GeofenceIds" ], "members":{ "CollectionName":{ "shape":"ResourceName", "documentation":"<p>The geofence collection storing the geofences to be deleted.</p>", "location":"uri", "locationName":"CollectionName" }, "GeofenceIds":{ "shape":"BatchDeleteGeofenceRequestGeofenceIdsList", "documentation":"<p>The batch of geofences to be deleted.</p>" } } }, "BatchDeleteGeofenceRequestGeofenceIdsList":{ "type":"list", "member":{"shape":"Id"}, "max":10, "min":1 }, "BatchDeleteGeofenceResponse":{ "type":"structure", "required":["Errors"], "members":{ "Errors":{ "shape":"BatchDeleteGeofenceErrorList", "documentation":"<p>Contains error details for each geofence that failed to delete.</p>" } } }, "BatchEvaluateGeofencesError":{ "type":"structure", "required":[ "DeviceId", "SampleTime", "Error" ], "members":{ "DeviceId":{ "shape":"Id", "documentation":"<p>The device associated with the position evaluation error.</p>" }, "SampleTime":{ "shape":"Timestamp", "documentation":"<p>Specifies a timestamp for when the error occurred in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code> </p>" }, "Error":{ "shape":"BatchItemError", "documentation":"<p>Contains details associated to the batch error.</p>" } }, "documentation":"<p>Contains error details for each device that failed to evaluate its position against the geofences in a given geofence collection.</p>" }, "BatchEvaluateGeofencesErrorList":{ "type":"list", "member":{"shape":"BatchEvaluateGeofencesError"} }, "BatchEvaluateGeofencesRequest":{ "type":"structure", "required":[ "CollectionName", "DevicePositionUpdates" ], "members":{ "CollectionName":{ "shape":"ResourceName", "documentation":"<p>The geofence collection used in evaluating the position of devices against its geofences.</p>", "location":"uri", "locationName":"CollectionName" }, "DevicePositionUpdates":{ "shape":"BatchEvaluateGeofencesRequestDevicePositionUpdatesList", "documentation":"<p>Contains device details for each device to be evaluated against the given geofence collection.</p>" } } }, "BatchEvaluateGeofencesRequestDevicePositionUpdatesList":{ "type":"list", "member":{"shape":"DevicePositionUpdate"}, "max":10, "min":1 }, "BatchEvaluateGeofencesResponse":{ "type":"structure", "required":["Errors"], "members":{ "Errors":{ "shape":"BatchEvaluateGeofencesErrorList", "documentation":"<p>Contains error details for each device that failed to evaluate its position against the given geofence collection.</p>" } } }, "BatchGetDevicePositionError":{ "type":"structure", "required":[ "DeviceId", "Error" ], "members":{ "DeviceId":{ "shape":"Id", "documentation":"<p>The ID of the device that didn't return a position.</p>" }, "Error":{ "shape":"BatchItemError", "documentation":"<p>Contains details related to the error code.</p>" } }, "documentation":"<p>Contains error details for each device that didn't return a position.</p>" }, "BatchGetDevicePositionErrorList":{ "type":"list", "member":{"shape":"BatchGetDevicePositionError"} }, "BatchGetDevicePositionRequest":{ "type":"structure", "required":[ "TrackerName", "DeviceIds" ], "members":{ "TrackerName":{ "shape":"BatchGetDevicePositionRequestTrackerNameString", "documentation":"<p>The tracker resource retrieving the device position.</p>", "location":"uri", "locationName":"TrackerName" }, "DeviceIds":{ "shape":"BatchGetDevicePositionRequestDeviceIdsList", "documentation":"<p>Devices whose position you want to retrieve.</p> <ul> <li> <p>For example, for two devices: <code>device-ids=DeviceId1&device-ids=DeviceId2</code> </p> </li> </ul>" } } }, "BatchGetDevicePositionRequestDeviceIdsList":{ "type":"list", "member":{"shape":"Id"}, "max":10, "min":1 }, "BatchGetDevicePositionRequestTrackerNameString":{ "type":"string", "min":1, "pattern":"[-._\\w]+" }, "BatchGetDevicePositionResponse":{ "type":"structure", "required":[ "Errors", "DevicePositions" ], "members":{ "Errors":{ "shape":"BatchGetDevicePositionErrorList", "documentation":"<p>Contains error details for each device that failed to send its position to the tracker resource.</p>" }, "DevicePositions":{ "shape":"DevicePositionList", "documentation":"<p>Contains device position details such as the device ID, position, and timestamps for when the position was received and sampled.</p>" } } }, "BatchItemError":{ "type":"structure", "members":{ "Code":{ "shape":"BatchItemErrorCode", "documentation":"<p>The error code associated with the batch request error.</p>" }, "Message":{ "shape":"String", "documentation":"<p>A message with the reason for the batch request error.</p>" } }, "documentation":"<p>Contains the batch request error details associated with the request.</p>" }, "BatchItemErrorCode":{ "type":"string", "enum":[ "AccessDeniedError", "ConflictError", "InternalServerError", "ResourceNotFoundError", "ThrottlingError", "ValidationError" ] }, "BatchPutGeofenceError":{ "type":"structure", "required":[ "GeofenceId", "Error" ], "members":{ "GeofenceId":{ "shape":"Id", "documentation":"<p>The geofence associated with the error message.</p>" }, "Error":{ "shape":"BatchItemError", "documentation":"<p>Contains details associated to the batch error.</p>" } }, "documentation":"<p>Contains error details for each geofence that failed to be stored in a given geofence collection.</p>" }, "BatchPutGeofenceErrorList":{ "type":"list", "member":{"shape":"BatchPutGeofenceError"} }, "BatchPutGeofenceRequest":{ "type":"structure", "required":[ "CollectionName", "Entries" ], "members":{ "CollectionName":{ "shape":"ResourceName", "documentation":"<p>The geofence collection storing the geofences.</p>", "location":"uri", "locationName":"CollectionName" }, "Entries":{ "shape":"BatchPutGeofenceRequestEntriesList", "documentation":"<p>The batch of geofences to be stored in a geofence collection.</p>" } } }, "BatchPutGeofenceRequestEntriesList":{ "type":"list", "member":{"shape":"BatchPutGeofenceRequestEntry"}, "max":10, "min":1 }, "BatchPutGeofenceRequestEntry":{ "type":"structure", "required":[ "GeofenceId", "Geometry" ], "members":{ "GeofenceId":{ "shape":"Id", "documentation":"<p>The identifier for the geofence to be stored in a given geofence collection.</p>" }, "Geometry":{ "shape":"GeofenceGeometry", "documentation":"<p>Contains the details to specify the position of the geofence. Can be a circle, a polygon, or a multipolygon. <code>Polygon</code> and <code>MultiPolygon</code> geometries can be defined using their respective parameters, or encoded in Geobuf format using the <code>Geobuf</code> parameter. Including multiple geometry types in the same request will return a validation error.</p> <note> <p>The geofence <code>Polygon</code> and <code>MultiPolygon</code> formats support a maximum of 1,000 total vertices. The <code>Geobuf</code> format supports a maximum of 100,000 vertices.</p> </note>" }, "GeofenceProperties":{ "shape":"PropertyMap", "documentation":"<p>Associates one of more properties with the geofence. A property is a key-value pair stored with the geofence and added to any geofence event triggered with that geofence.</p> <p>Format: <code>\"key\" : \"value\"</code> </p>" } }, "documentation":"<p>Contains geofence geometry details. </p>" }, "BatchPutGeofenceResponse":{ "type":"structure", "required":[ "Successes", "Errors" ], "members":{ "Successes":{ "shape":"BatchPutGeofenceSuccessList", "documentation":"<p>Contains each geofence that was successfully stored in a geofence collection.</p>" }, "Errors":{ "shape":"BatchPutGeofenceErrorList", "documentation":"<p>Contains additional error details for each geofence that failed to be stored in a geofence collection.</p>" } } }, "BatchPutGeofenceSuccess":{ "type":"structure", "required":[ "GeofenceId", "CreateTime", "UpdateTime" ], "members":{ "GeofenceId":{ "shape":"Id", "documentation":"<p>The geofence successfully stored in a geofence collection.</p>" }, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the geofence was stored in a geofence collection in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code> </p>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the geofence was last updated in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code> </p>" } }, "documentation":"<p>Contains a summary of each geofence that was successfully stored in a given geofence collection.</p>" }, "BatchPutGeofenceSuccessList":{ "type":"list", "member":{"shape":"BatchPutGeofenceSuccess"} }, "BatchUpdateDevicePositionError":{ "type":"structure", "required":[ "DeviceId", "SampleTime", "Error" ], "members":{ "DeviceId":{ "shape":"Id", "documentation":"<p>The device associated with the failed location update.</p>" }, "SampleTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp at which the device position was determined. Uses <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" }, "Error":{ "shape":"BatchItemError", "documentation":"<p>Contains details related to the error code such as the error code and error message.</p>" } }, "documentation":"<p>Contains error details for each device that failed to update its position.</p>" }, "BatchUpdateDevicePositionErrorList":{ "type":"list", "member":{"shape":"BatchUpdateDevicePositionError"} }, "BatchUpdateDevicePositionRequest":{ "type":"structure", "required":[ "TrackerName", "Updates" ], "members":{ "TrackerName":{ "shape":"ResourceName", "documentation":"<p>The name of the tracker resource to update.</p>", "location":"uri", "locationName":"TrackerName" }, "Updates":{ "shape":"BatchUpdateDevicePositionRequestUpdatesList", "documentation":"<p>Contains the position update details for each device, up to 10 devices.</p>" } } }, "BatchUpdateDevicePositionRequestUpdatesList":{ "type":"list", "member":{"shape":"DevicePositionUpdate"}, "max":10, "min":1 }, "BatchUpdateDevicePositionResponse":{ "type":"structure", "required":["Errors"], "members":{ "Errors":{ "shape":"BatchUpdateDevicePositionErrorList", "documentation":"<p>Contains error details for each device that failed to update its position.</p>" } } }, "Blob":{"type":"blob"}, "Boolean":{ "type":"boolean", "box":true }, "BoundingBox":{ "type":"list", "member":{"shape":"Double"}, "max":4, "min":4, "sensitive":true }, "CalculateRouteCarModeOptions":{ "type":"structure", "members":{ "AvoidFerries":{ "shape":"SensitiveBoolean", "documentation":"<p>Avoids ferries when calculating routes.</p> <p>Default Value: <code>false</code> </p> <p>Valid Values: <code>false</code> | <code>true</code> </p>" }, "AvoidTolls":{ "shape":"SensitiveBoolean", "documentation":"<p>Avoids tolls when calculating routes.</p> <p>Default Value: <code>false</code> </p> <p>Valid Values: <code>false</code> | <code>true</code> </p>" } }, "documentation":"<p>Contains details about additional route preferences for requests that specify <code>TravelMode</code> as <code>Car</code>.</p>" }, "CalculateRouteMatrixRequest":{ "type":"structure", "required":[ "CalculatorName", "DeparturePositions", "DestinationPositions" ], "members":{ "CalculatorName":{ "shape":"ResourceName", "documentation":"<p>The name of the route calculator resource that you want to use to calculate the route matrix. </p>", "location":"uri", "locationName":"CalculatorName" }, "DeparturePositions":{ "shape":"CalculateRouteMatrixRequestDeparturePositionsList", "documentation":"<p>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 <a href=\"https://earth-info.nga.mil/GandG/wgs84/index.html\">WGS 84</a> format: <code>[longitude, latitude]</code>. For example, <code>[-123.115, 49.285]</code>.</p> <important> <p>Depending on the data provider selected in the route calculator resource there may be additional restrictions on the inputs you can choose. See <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/calculate-route-matrix.html#matrix-routing-position-limits\"> Position restrictions</a> in the <i>Amazon Location Service Developer Guide</i>.</p> </important> <note> <p>For route calculators that use Esri as the data provider, if you specify a departure that's not located on a road, Amazon Location <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/snap-to-nearby-road.html\"> moves the position to the nearest road</a>. The snapped value is available in the result in <code>SnappedDeparturePositions</code>.</p> </note> <p>Valid Values: <code>[-180 to 180,-90 to 90]</code> </p>" }, "DestinationPositions":{ "shape":"CalculateRouteMatrixRequestDestinationPositionsList", "documentation":"<p>The list of destination positions for the route matrix. An array of points, each of which is itself a 2-value array defined in <a href=\"https://earth-info.nga.mil/GandG/wgs84/index.html\">WGS 84</a> format: <code>[longitude, latitude]</code>. For example, <code>[-122.339, 47.615]</code> </p> <important> <p>Depending on the data provider selected in the route calculator resource there may be additional restrictions on the inputs you can choose. See <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/calculate-route-matrix.html#matrix-routing-position-limits\"> Position restrictions</a> in the <i>Amazon Location Service Developer Guide</i>.</p> </important> <note> <p>For route calculators that use Esri as the data provider, if you specify a destination that's not located on a road, Amazon Location <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/snap-to-nearby-road.html\"> moves the position to the nearest road</a>. The snapped value is available in the result in <code>SnappedDestinationPositions</code>.</p> </note> <p>Valid Values: <code>[-180 to 180,-90 to 90]</code> </p>" }, "TravelMode":{ "shape":"TravelMode", "documentation":"<p>Specifies the mode of transport when calculating a route. Used in estimating the speed of travel and road compatibility.</p> <p>The <code>TravelMode</code> you specify also determines how you specify route preferences: </p> <ul> <li> <p>If traveling by <code>Car</code> use the <code>CarModeOptions</code> parameter.</p> </li> <li> <p>If traveling by <code>Truck</code> use the <code>TruckModeOptions</code> parameter.</p> </li> </ul> <note> <p> <code>Bicycle</code> or <code>Motorcycle</code> are only valid when using <code>Grab</code> as a data provider, and only within Southeast Asia.</p> <p> <code>Truck</code> is not available for Grab.</p> <p>For more information about using Grab as a data provider, see <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/grab.html\">GrabMaps</a> in the <i>Amazon Location Service Developer Guide</i>.</p> </note> <p>Default Value: <code>Car</code> </p>" }, "DepartureTime":{ "shape":"Timestamp", "documentation":"<p>Specifies the desired time of departure. Uses the given time to calculate the route matrix. You can't set both <code>DepartureTime</code> and <code>DepartNow</code>. If neither is set, the best time of day to travel with the best traffic conditions is used to calculate the route matrix.</p> <note> <p>Setting a departure time in the past returns a <code>400 ValidationException</code> error.</p> </note> <ul> <li> <p>In <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. For example, <code>2020–07-2T12:15:20.000Z+01:00</code> </p> </li> </ul>" }, "DepartNow":{ "shape":"SensitiveBoolean", "documentation":"<p>Sets the time of departure as the current time. Uses the current time to calculate the route matrix. You can't set both <code>DepartureTime</code> and <code>DepartNow</code>. If neither is set, the best time of day to travel with the best traffic conditions is used to calculate the route matrix.</p> <p>Default Value: <code>false</code> </p> <p>Valid Values: <code>false</code> | <code>true</code> </p>" }, "DistanceUnit":{ "shape":"DistanceUnit", "documentation":"<p>Set the unit system to specify the distance.</p> <p>Default Value: <code>Kilometers</code> </p>" }, "CarModeOptions":{ "shape":"CalculateRouteCarModeOptions", "documentation":"<p>Specifies route preferences when traveling by <code>Car</code>, such as avoiding routes that use ferries or tolls.</p> <p>Requirements: <code>TravelMode</code> must be specified as <code>Car</code>.</p>" }, "TruckModeOptions":{ "shape":"CalculateRouteTruckModeOptions", "documentation":"<p>Specifies route preferences when traveling by <code>Truck</code>, such as avoiding routes that use ferries or tolls, and truck specifications to consider when choosing an optimal road.</p> <p>Requirements: <code>TravelMode</code> must be specified as <code>Truck</code>.</p>" }, "Key":{ "shape":"ApiKey", "documentation":"<p>The optional <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/using-apikeys.html\">API key</a> to authorize the request.</p>", "location":"querystring", "locationName":"key" } } }, "CalculateRouteMatrixRequestDeparturePositionsList":{ "type":"list", "member":{"shape":"Position"}, "max":350, "min":1 }, "CalculateRouteMatrixRequestDestinationPositionsList":{ "type":"list", "member":{"shape":"Position"}, "max":350, "min":1 }, "CalculateRouteMatrixResponse":{ "type":"structure", "required":[ "RouteMatrix", "Summary" ], "members":{ "RouteMatrix":{ "shape":"RouteMatrix", "documentation":"<p>The calculated route matrix containing the results for all pairs of <code>DeparturePositions</code> to <code>DestinationPositions</code>. Each row corresponds to one entry in <code>DeparturePositions</code>. Each entry in the row corresponds to the route from that entry in <code>DeparturePositions</code> to an entry in <code>DestinationPositions</code>. </p>" }, "SnappedDeparturePositions":{ "shape":"CalculateRouteMatrixResponseSnappedDeparturePositionsList", "documentation":"<p>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 <code>RouteMatrix</code>.</p>" }, "SnappedDestinationPositions":{ "shape":"CalculateRouteMatrixResponseSnappedDestinationPositionsList", "documentation":"<p>The list of destination positions for the route matrix used for calculation of the <code>RouteMatrix</code>.</p>" }, "Summary":{ "shape":"CalculateRouteMatrixSummary", "documentation":"<p>Contains information about the route matrix, <code>DataSource</code>, <code>DistanceUnit</code>, <code>RouteCount</code> and <code>ErrorCount</code>.</p>" } }, "documentation":"<p>Returns the result of the route matrix calculation.</p>" }, "CalculateRouteMatrixResponseSnappedDeparturePositionsList":{ "type":"list", "member":{"shape":"Position"}, "max":350, "min":1 }, "CalculateRouteMatrixResponseSnappedDestinationPositionsList":{ "type":"list", "member":{"shape":"Position"}, "max":350, "min":1 }, "CalculateRouteMatrixSummary":{ "type":"structure", "required":[ "DataSource", "RouteCount", "ErrorCount", "DistanceUnit" ], "members":{ "DataSource":{ "shape":"String", "documentation":"<p>The data provider of traffic and road network data used to calculate the routes. Indicates one of the available providers:</p> <ul> <li> <p> <code>Esri</code> </p> </li> <li> <p> <code>Grab</code> </p> </li> <li> <p> <code>Here</code> </p> </li> </ul> <p>For more information about data providers, see <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/what-is-data-provider.html\">Amazon Location Service data providers</a>.</p>" }, "RouteCount":{ "shape":"CalculateRouteMatrixSummaryRouteCountInteger", "documentation":"<p>The count of cells in the route matrix. Equal to the number of <code>DeparturePositions</code> multiplied by the number of <code>DestinationPositions</code>.</p>" }, "ErrorCount":{ "shape":"CalculateRouteMatrixSummaryErrorCountInteger", "documentation":"<p>The count of error results in the route matrix. If this number is 0, all routes were calculated successfully.</p>" }, "DistanceUnit":{ "shape":"DistanceUnit", "documentation":"<p>The unit of measurement for route distances.</p>" } }, "documentation":"<p>A summary of the calculated route matrix.</p>" }, "CalculateRouteMatrixSummaryErrorCountInteger":{ "type":"integer", "box":true, "max":160000, "min":1 }, "CalculateRouteMatrixSummaryRouteCountInteger":{ "type":"integer", "box":true, "max":160000, "min":1 }, "CalculateRouteRequest":{ "type":"structure", "required":[ "CalculatorName", "DeparturePosition", "DestinationPosition" ], "members":{ "CalculatorName":{ "shape":"ResourceName", "documentation":"<p>The name of the route calculator resource that you want to use to calculate the route. </p>", "location":"uri", "locationName":"CalculatorName" }, "DeparturePosition":{ "shape":"Position", "documentation":"<p>The start position for the route. Defined in <a href=\"https://earth-info.nga.mil/index.php?dir=wgs84&action=wgs84\">World Geodetic System (WGS 84)</a> format: <code>[longitude, latitude]</code>.</p> <ul> <li> <p>For example, <code>[-123.115, 49.285]</code> </p> </li> </ul> <note> <p>If you specify a departure that's not located on a road, Amazon Location <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/snap-to-nearby-road.html\">moves the position to the nearest road</a>. If Esri is the provider for your route calculator, specifying a route that is longer than 400 km returns a <code>400 RoutesValidationException</code> error.</p> </note> <p>Valid Values: <code>[-180 to 180,-90 to 90]</code> </p>" }, "DestinationPosition":{ "shape":"Position", "documentation":"<p>The finish position for the route. Defined in <a href=\"https://earth-info.nga.mil/index.php?dir=wgs84&action=wgs84\">World Geodetic System (WGS 84)</a> format: <code>[longitude, latitude]</code>.</p> <ul> <li> <p> For example, <code>[-122.339, 47.615]</code> </p> </li> </ul> <note> <p>If you specify a destination that's not located on a road, Amazon Location <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/snap-to-nearby-road.html\">moves the position to the nearest road</a>. </p> </note> <p>Valid Values: <code>[-180 to 180,-90 to 90]</code> </p>" }, "WaypointPositions":{ "shape":"CalculateRouteRequestWaypointPositionsList", "documentation":"<p>Specifies an ordered list of up to 23 intermediate positions to include along a route between the departure position and destination position. </p> <ul> <li> <p>For example, from the <code>DeparturePosition</code> <code>[-123.115, 49.285]</code>, the route follows the order that the waypoint positions are given <code>[[-122.757, 49.0021],[-122.349, 47.620]]</code> </p> </li> </ul> <note> <p>If you specify a waypoint position that's not located on a road, Amazon Location <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/snap-to-nearby-road.html\">moves the position to the nearest road</a>. </p> <p>Specifying more than 23 waypoints returns a <code>400 ValidationException</code> error.</p> <p>If Esri is the provider for your route calculator, specifying a route that is longer than 400 km returns a <code>400 RoutesValidationException</code> error.</p> </note> <p>Valid Values: <code>[-180 to 180,-90 to 90]</code> </p>" }, "TravelMode":{ "shape":"TravelMode", "documentation":"<p>Specifies the mode of transport when calculating a route. Used in estimating the speed of travel and road compatibility. You can choose <code>Car</code>, <code>Truck</code>, <code>Walking</code>, <code>Bicycle</code> or <code>Motorcycle</code> as options for the <code>TravelMode</code>.</p> <note> <p> <code>Bicycle</code> and <code>Motorcycle</code> are only valid when using Grab as a data provider, and only within Southeast Asia.</p> <p> <code>Truck</code> is not available for Grab.</p> <p>For more details on the using Grab for routing, including areas of coverage, see <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/grab.html\">GrabMaps</a> in the <i>Amazon Location Service Developer Guide</i>.</p> </note> <p>The <code>TravelMode</code> you specify also determines how you specify route preferences: </p> <ul> <li> <p>If traveling by <code>Car</code> use the <code>CarModeOptions</code> parameter.</p> </li> <li> <p>If traveling by <code>Truck</code> use the <code>TruckModeOptions</code> parameter.</p> </li> </ul> <p>Default Value: <code>Car</code> </p>" }, "DepartureTime":{ "shape":"Timestamp", "documentation":"<p>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.</p> <ul> <li> <p>In <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. For example, <code>2020–07-2T12:15:20.000Z+01:00</code> </p> </li> </ul>" }, "DepartNow":{ "shape":"SensitiveBoolean", "documentation":"<p>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.</p> <p>Default Value: <code>false</code> </p> <p>Valid Values: <code>false</code> | <code>true</code> </p>" }, "DistanceUnit":{ "shape":"DistanceUnit", "documentation":"<p>Set the unit system to specify the distance.</p> <p>Default Value: <code>Kilometers</code> </p>" }, "IncludeLegGeometry":{ "shape":"SensitiveBoolean", "documentation":"<p>Set to include the geometry details in the result for each path between a pair of positions.</p> <p>Default Value: <code>false</code> </p> <p>Valid Values: <code>false</code> | <code>true</code> </p>" }, "CarModeOptions":{ "shape":"CalculateRouteCarModeOptions", "documentation":"<p>Specifies route preferences when traveling by <code>Car</code>, such as avoiding routes that use ferries or tolls.</p> <p>Requirements: <code>TravelMode</code> must be specified as <code>Car</code>.</p>" }, "TruckModeOptions":{ "shape":"CalculateRouteTruckModeOptions", "documentation":"<p>Specifies route preferences when traveling by <code>Truck</code>, such as avoiding routes that use ferries or tolls, and truck specifications to consider when choosing an optimal road.</p> <p>Requirements: <code>TravelMode</code> must be specified as <code>Truck</code>.</p>" }, "ArrivalTime":{ "shape":"Timestamp", "documentation":"<p>Specifies the desired time of arrival. 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.</p> <note> <p>ArrivalTime is not supported Esri.</p> </note>" }, "OptimizeFor":{ "shape":"OptimizationMode", "documentation":"<p>Specifies the distance to optimize for when calculating a route.</p>" }, "Key":{ "shape":"ApiKey", "documentation":"<p>The optional <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/using-apikeys.html\">API key</a> to authorize the request.</p>", "location":"querystring", "locationName":"key" } } }, "CalculateRouteRequestWaypointPositionsList":{ "type":"list", "member":{"shape":"Position"}, "max":23, "min":0 }, "CalculateRouteResponse":{ "type":"structure", "required":[ "Legs", "Summary" ], "members":{ "Legs":{ "shape":"LegList", "documentation":"<p>Contains details about each path between a pair of positions included along a route such as: <code>StartPosition</code>, <code>EndPosition</code>, <code>Distance</code>, <code>DurationSeconds</code>, <code>Geometry</code>, and <code>Steps</code>. The number of legs returned corresponds to one fewer than the total number of positions in the request. </p> <p>For example, a route with a departure position and destination position returns one leg with the positions <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/snap-to-nearby-road.html\">snapped to a nearby road</a>:</p> <ul> <li> <p>The <code>StartPosition</code> is the departure position.</p> </li> <li> <p>The <code>EndPosition</code> is the destination position.</p> </li> </ul> <p>A route with a waypoint between the departure and destination position returns two legs with the positions snapped to a nearby road:</p> <ul> <li> <p>Leg 1: The <code>StartPosition</code> is the departure position . The <code>EndPosition</code> is the waypoint positon.</p> </li> <li> <p>Leg 2: The <code>StartPosition</code> is the waypoint position. The <code>EndPosition</code> is the destination position.</p> </li> </ul>" }, "Summary":{ "shape":"CalculateRouteSummary", "documentation":"<p>Contains information about the whole route, such as: <code>RouteBBox</code>, <code>DataSource</code>, <code>Distance</code>, <code>DistanceUnit</code>, and <code>DurationSeconds</code>.</p>" } }, "documentation":"<p>Returns the result of the route calculation. Metadata includes legs and route summary.</p>" }, "CalculateRouteSummary":{ "type":"structure", "required":[ "RouteBBox", "DataSource", "Distance", "DurationSeconds", "DistanceUnit" ], "members":{ "RouteBBox":{ "shape":"BoundingBox", "documentation":"<p>Specifies a geographical box surrounding a route. Used to zoom into a route when displaying it in a map. For example, <code>[min x, min y, max x, max y]</code>.</p> <p>The first 2 <code>bbox</code> parameters describe the lower southwest corner: </p> <ul> <li> <p>The first <code>bbox</code> position is the X coordinate or longitude of the lower southwest corner. </p> </li> <li> <p>The second <code>bbox</code> position is the Y coordinate or latitude of the lower southwest corner. </p> </li> </ul> <p>The next 2 <code>bbox</code> parameters describe the upper northeast corner: </p> <ul> <li> <p>The third <code>bbox</code> position is the X coordinate, or longitude of the upper northeast corner. </p> </li> <li> <p>The fourth <code>bbox</code> position is the Y coordinate, or latitude of the upper northeast corner. </p> </li> </ul>" }, "DataSource":{ "shape":"String", "documentation":"<p>The data provider of traffic and road network data used to calculate the route. Indicates one of the available providers:</p> <ul> <li> <p> <code>Esri</code> </p> </li> <li> <p> <code>Grab</code> </p> </li> <li> <p> <code>Here</code> </p> </li> </ul> <p>For more information about data providers, see <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/what-is-data-provider.html\">Amazon Location Service data providers</a>.</p>" }, "Distance":{ "shape":"CalculateRouteSummaryDistanceDouble", "documentation":"<p>The total distance covered by the route. The sum of the distance travelled between every stop on the route.</p> <note> <p>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 <code>400 RoutesValidationException</code> error.</p> </note>" }, "DurationSeconds":{ "shape":"CalculateRouteSummaryDurationSecondsDouble", "documentation":"<p>The total travel time for the route measured in seconds. The sum of the travel time between every stop on the route.</p>" }, "DistanceUnit":{ "shape":"DistanceUnit", "documentation":"<p>The unit of measurement for route distances.</p>" } }, "documentation":"<p>A summary of the calculated route.</p>" }, "CalculateRouteSummaryDistanceDouble":{ "type":"double", "box":true, "min":0, "sensitive":true }, "CalculateRouteSummaryDurationSecondsDouble":{ "type":"double", "box":true, "min":0, "sensitive":true }, "CalculateRouteTruckModeOptions":{ "type":"structure", "members":{ "AvoidFerries":{ "shape":"SensitiveBoolean", "documentation":"<p>Avoids ferries when calculating routes.</p> <p>Default Value: <code>false</code> </p> <p>Valid Values: <code>false</code> | <code>true</code> </p>" }, "AvoidTolls":{ "shape":"SensitiveBoolean", "documentation":"<p>Avoids tolls when calculating routes.</p> <p>Default Value: <code>false</code> </p> <p>Valid Values: <code>false</code> | <code>true</code> </p>" }, "Dimensions":{ "shape":"TruckDimensions", "documentation":"<p>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.</p>" }, "Weight":{ "shape":"TruckWeight", "documentation":"<p>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.</p>" } }, "documentation":"<p>Contains details about additional route preferences for requests that specify <code>TravelMode</code> as <code>Truck</code>.</p>" }, "CellSignals":{ "type":"structure", "required":["LteCellDetails"], "members":{ "LteCellDetails":{ "shape":"CellSignalsLteCellDetailsList", "documentation":"<p>Information about the Long-Term Evolution (LTE) network the device is connected to.</p>" } }, "documentation":"<p>The cellular network communication infrastructure that the device uses.</p>" }, "CellSignalsLteCellDetailsList":{ "type":"list", "member":{"shape":"LteCellDetails"}, "max":16, "min":1 }, "Circle":{ "type":"structure", "required":[ "Center", "Radius" ], "members":{ "Center":{ "shape":"Position", "documentation":"<p>A single point geometry, specifying the center of the circle, using <a href=\"https://gisgeography.com/wgs84-world-geodetic-system/\">WGS 84</a> coordinates, in the form <code>[longitude, latitude]</code>.</p>" }, "Radius":{ "shape":"SensitiveDouble", "documentation":"<p>The radius of the circle in meters. Must be greater than zero and no larger than 100,000 (100 kilometers).</p>" } }, "documentation":"<p>A circle on the earth, as defined by a center point and a radius.</p>", "sensitive":true }, "ConflictException":{ "type":"structure", "required":["Message"], "members":{ "Message":{ "shape":"String", "locationName":"message" } }, "documentation":"<p>The request was unsuccessful because of a conflict.</p>", "error":{ "httpStatusCode":409, "senderFault":true }, "exception":true }, "CountryCode3":{ "type":"string", "max":3, "min":3, "pattern":"[A-Z]{3}", "sensitive":true }, "CountryCode3OrEmpty":{ "type":"string", "max":3, "min":0, "pattern":"[A-Z]{3}$|^", "sensitive":true }, "CountryCodeList":{ "type":"list", "member":{"shape":"CountryCode3"}, "max":100, "min":1 }, "CreateGeofenceCollectionRequest":{ "type":"structure", "required":["CollectionName"], "members":{ "CollectionName":{ "shape":"ResourceName", "documentation":"<p>A custom name for the geofence collection.</p> <p>Requirements:</p> <ul> <li> <p>Contain only alphanumeric characters (A–Z, a–z, 0–9), hyphens (-), periods (.), and underscores (_). </p> </li> <li> <p>Must be a unique geofence collection name.</p> </li> <li> <p>No spaces allowed. For example, <code>ExampleGeofenceCollection</code>.</p> </li> </ul>" }, "PricingPlan":{ "shape":"PricingPlan", "documentation":"<p>No longer used. If included, the only allowed value is <code>RequestBasedUsage</code>.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. If included, the only allowed value is RequestBasedUsage.", "deprecatedSince":"2022-02-01" }, "PricingPlanDataSource":{ "shape":"String", "documentation":"<p>This parameter is no longer used.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. No longer allowed.", "deprecatedSince":"2022-02-01" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>An optional description for the geofence collection.</p>" }, "Tags":{ "shape":"TagMap", "documentation":"<p>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.</p> <p>Format: <code>\"key\" : \"value\"</code> </p> <p>Restrictions:</p> <ul> <li> <p>Maximum 50 tags per resource</p> </li> <li> <p>Each resource tag must be unique with a maximum of one value.</p> </li> <li> <p>Maximum key length: 128 Unicode characters in UTF-8</p> </li> <li> <p>Maximum value length: 256 Unicode characters in UTF-8</p> </li> <li> <p>Can use alphanumeric characters (A–Z, a–z, 0–9), and the following characters: + - = . _ : / @. </p> </li> <li> <p>Cannot use \"aws:\" as a prefix for a key.</p> </li> </ul>" }, "KmsKeyId":{ "shape":"KmsKeyId", "documentation":"<p>A key identifier for an <a href=\"https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html\">Amazon Web Services KMS customer managed key</a>. Enter a key ID, key ARN, alias name, or alias ARN. </p>" } } }, "CreateGeofenceCollectionResponse":{ "type":"structure", "required":[ "CollectionName", "CollectionArn", "CreateTime" ], "members":{ "CollectionName":{ "shape":"ResourceName", "documentation":"<p>The name for the geofence collection.</p>" }, "CollectionArn":{ "shape":"Arn", "documentation":"<p>The Amazon Resource Name (ARN) for the geofence collection resource. Used when you need to specify a resource across all Amazon Web Services. </p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:geofence-collection/ExampleGeofenceCollection</code> </p> </li> </ul>" }, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the geofence collection was created in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code> </p>" } } }, "CreateKeyRequest":{ "type":"structure", "required":[ "KeyName", "Restrictions" ], "members":{ "KeyName":{ "shape":"ResourceName", "documentation":"<p>A custom name for the API key resource.</p> <p>Requirements:</p> <ul> <li> <p>Contain only alphanumeric characters (A–Z, a–z, 0–9), hyphens (-), periods (.), and underscores (_). </p> </li> <li> <p>Must be a unique API key name.</p> </li> <li> <p>No spaces allowed. For example, <code>ExampleAPIKey</code>.</p> </li> </ul>" }, "Restrictions":{ "shape":"ApiKeyRestrictions", "documentation":"<p>The API key restrictions for the API key resource.</p>" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>An optional description for the API key resource.</p>" }, "ExpireTime":{ "shape":"Timestamp", "documentation":"<p>The optional timestamp for when the API key resource will expire in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. One of <code>NoExpiry</code> or <code>ExpireTime</code> must be set.</p>" }, "NoExpiry":{ "shape":"Boolean", "documentation":"<p>Optionally set to <code>true</code> to set no expiration time for the API key. One of <code>NoExpiry</code> or <code>ExpireTime</code> must be set.</p>" }, "Tags":{ "shape":"TagMap", "documentation":"<p>Applies one or more tags to the map resource. A tag is a key-value pair that helps manage, identify, search, and filter your resources by labelling them.</p> <p>Format: <code>\"key\" : \"value\"</code> </p> <p>Restrictions:</p> <ul> <li> <p>Maximum 50 tags per resource</p> </li> <li> <p>Each resource tag must be unique with a maximum of one value.</p> </li> <li> <p>Maximum key length: 128 Unicode characters in UTF-8</p> </li> <li> <p>Maximum value length: 256 Unicode characters in UTF-8</p> </li> <li> <p>Can use alphanumeric characters (A–Z, a–z, 0–9), and the following characters: + - = . _ : / @. </p> </li> <li> <p>Cannot use \"aws:\" as a prefix for a key.</p> </li> </ul>" } } }, "CreateKeyResponse":{ "type":"structure", "required":[ "Key", "KeyArn", "KeyName", "CreateTime" ], "members":{ "Key":{ "shape":"ApiKey", "documentation":"<p>The key value/string of an API key. This value is used when making API calls to authorize the call. For example, see <a href=\"https://docs.aws.amazon.com/location/previous/APIReference/API_GetMapGlyphs.html\">GetMapGlyphs</a>.</p>" }, "KeyArn":{ "shape":"Arn", "documentation":"<p>The Amazon Resource Name (ARN) for the API key resource. Used when you need to specify a resource across all Amazon Web Services.</p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:key/ExampleKey</code> </p> </li> </ul>" }, "KeyName":{ "shape":"ResourceName", "documentation":"<p>The name of the API key resource.</p>" }, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the API key resource was created in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" } } }, "CreateMapRequest":{ "type":"structure", "required":[ "MapName", "Configuration" ], "members":{ "MapName":{ "shape":"ResourceName", "documentation":"<p>The name for the map resource.</p> <p>Requirements:</p> <ul> <li> <p>Must contain only alphanumeric characters (A–Z, a–z, 0–9), hyphens (-), periods (.), and underscores (_). </p> </li> <li> <p>Must be a unique map resource name. </p> </li> <li> <p>No spaces allowed. For example, <code>ExampleMap</code>.</p> </li> </ul>" }, "Configuration":{ "shape":"MapConfiguration", "documentation":"<p>Specifies the <code>MapConfiguration</code>, including the map style, for the map resource that you create. The map style defines the look of maps and the data provider for your map resource.</p>" }, "PricingPlan":{ "shape":"PricingPlan", "documentation":"<p>No longer used. If included, the only allowed value is <code>RequestBasedUsage</code>.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. If included, the only allowed value is RequestBasedUsage.", "deprecatedSince":"2022-02-01" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>An optional description for the map resource.</p>" }, "Tags":{ "shape":"TagMap", "documentation":"<p>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.</p> <p>Format: <code>\"key\" : \"value\"</code> </p> <p>Restrictions:</p> <ul> <li> <p>Maximum 50 tags per resource</p> </li> <li> <p>Each resource tag must be unique with a maximum of one value.</p> </li> <li> <p>Maximum key length: 128 Unicode characters in UTF-8</p> </li> <li> <p>Maximum value length: 256 Unicode characters in UTF-8</p> </li> <li> <p>Can use alphanumeric characters (A–Z, a–z, 0–9), and the following characters: + - = . _ : / @. </p> </li> <li> <p>Cannot use \"aws:\" as a prefix for a key.</p> </li> </ul>" } } }, "CreateMapResponse":{ "type":"structure", "required":[ "MapName", "MapArn", "CreateTime" ], "members":{ "MapName":{ "shape":"ResourceName", "documentation":"<p>The name of the map resource.</p>" }, "MapArn":{ "shape":"GeoArn", "documentation":"<p>The Amazon Resource Name (ARN) for the map resource. Used to specify a resource across all Amazon Web Services.</p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:map/ExampleMap</code> </p> </li> </ul>" }, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the map resource was created in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>.</p>" } } }, "CreatePlaceIndexRequest":{ "type":"structure", "required":[ "IndexName", "DataSource" ], "members":{ "IndexName":{ "shape":"ResourceName", "documentation":"<p>The name of the place index resource. </p> <p>Requirements:</p> <ul> <li> <p>Contain only alphanumeric characters (A–Z, a–z, 0–9), hyphens (-), periods (.), and underscores (_).</p> </li> <li> <p>Must be a unique place index resource name.</p> </li> <li> <p>No spaces allowed. For example, <code>ExamplePlaceIndex</code>.</p> </li> </ul>" }, "DataSource":{ "shape":"String", "documentation":"<p>Specifies the geospatial data provider for the new place index.</p> <note> <p>This field is case-sensitive. Enter the valid values as shown. For example, entering <code>HERE</code> returns an error.</p> </note> <p>Valid values include:</p> <ul> <li> <p> <code>Esri</code> – For additional information about <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/esri.html\">Esri</a>'s coverage in your region of interest, see <a href=\"https://developers.arcgis.com/rest/geocode/api-reference/geocode-coverage.htm\">Esri details on geocoding coverage</a>.</p> </li> <li> <p> <code>Grab</code> – Grab provides place index functionality for Southeast Asia. For additional information about <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/grab.html\">GrabMaps</a>' coverage, see <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/grab.html#grab-coverage-area\">GrabMaps countries and areas covered</a>.</p> </li> <li> <p> <code>Here</code> – For additional information about <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/HERE.html\">HERE Technologies</a>' coverage in your region of interest, see <a href=\"https://developer.here.com/documentation/geocoder/dev_guide/topics/coverage-geocoder.html\">HERE details on goecoding coverage</a>.</p> <important> <p>If you specify HERE Technologies (<code>Here</code>) as the data provider, you may not <a href=\"https://docs.aws.amazon.com/location-places/latest/APIReference/API_DataSourceConfiguration.html\">store results</a> for locations in Japan. For more information, see the <a href=\"http://aws.amazon.com/service-terms/\">Amazon Web Services service terms</a> for Amazon Location Service.</p> </important> </li> </ul> <p>For additional information , see <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/what-is-data-provider.html\">Data providers</a> on the <i>Amazon Location Service developer guide</i>.</p>" }, "PricingPlan":{ "shape":"PricingPlan", "documentation":"<p>No longer used. If included, the only allowed value is <code>RequestBasedUsage</code>.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. If included, the only allowed value is RequestBasedUsage.", "deprecatedSince":"2022-02-01" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>The optional description for the place index resource.</p>" }, "DataSourceConfiguration":{ "shape":"DataSourceConfiguration", "documentation":"<p>Specifies the data storage option requesting Places.</p>" }, "Tags":{ "shape":"TagMap", "documentation":"<p>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.</p> <p>Format: <code>\"key\" : \"value\"</code> </p> <p>Restrictions:</p> <ul> <li> <p>Maximum 50 tags per resource.</p> </li> <li> <p>Each tag key must be unique and must have exactly one associated value.</p> </li> <li> <p>Maximum key length: 128 Unicode characters in UTF-8.</p> </li> <li> <p>Maximum value length: 256 Unicode characters in UTF-8.</p> </li> <li> <p>Can use alphanumeric characters (A–Z, a–z, 0–9), and the following characters: + - = . _ : / @</p> </li> <li> <p>Cannot use \"aws:\" as a prefix for a key.</p> </li> </ul>" } } }, "CreatePlaceIndexResponse":{ "type":"structure", "required":[ "IndexName", "IndexArn", "CreateTime" ], "members":{ "IndexName":{ "shape":"ResourceName", "documentation":"<p>The name for the place index resource.</p>" }, "IndexArn":{ "shape":"GeoArn", "documentation":"<p>The Amazon Resource Name (ARN) for the place index resource. Used to specify a resource across Amazon Web Services. </p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:place-index/ExamplePlaceIndex</code> </p> </li> </ul>" }, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the place index resource was created in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" } } }, "CreateRouteCalculatorRequest":{ "type":"structure", "required":[ "CalculatorName", "DataSource" ], "members":{ "CalculatorName":{ "shape":"ResourceName", "documentation":"<p>The name of the route calculator resource. </p> <p>Requirements:</p> <ul> <li> <p>Can use alphanumeric characters (A–Z, a–z, 0–9) , hyphens (-), periods (.), and underscores (_).</p> </li> <li> <p>Must be a unique Route calculator resource name.</p> </li> <li> <p>No spaces allowed. For example, <code>ExampleRouteCalculator</code>.</p> </li> </ul>" }, "DataSource":{ "shape":"String", "documentation":"<p>Specifies the data provider of traffic and road network data.</p> <note> <p>This field is case-sensitive. Enter the valid values as shown. For example, entering <code>HERE</code> returns an error.</p> </note> <p>Valid values include:</p> <ul> <li> <p> <code>Esri</code> – For additional information about <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/esri.html\">Esri</a>'s coverage in your region of interest, see <a href=\"https://doc.arcgis.com/en/arcgis-online/reference/network-coverage.htm\">Esri details on street networks and traffic coverage</a>.</p> <p>Route calculators that use Esri as a data source only calculate routes that are shorter than 400 km.</p> </li> <li> <p> <code>Grab</code> – Grab provides routing functionality for Southeast Asia. For additional information about <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/grab.html\">GrabMaps</a>' coverage, see <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/grab.html#grab-coverage-area\">GrabMaps countries and areas covered</a>.</p> </li> <li> <p> <code>Here</code> – For additional information about <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/HERE.html\">HERE Technologies</a>' coverage in your region of interest, see <a href=\"https://developer.here.com/documentation/routing-api/dev_guide/topics/coverage/car-routing.html\">HERE car routing coverage</a> and <a href=\"https://developer.here.com/documentation/routing-api/dev_guide/topics/coverage/truck-routing.html\">HERE truck routing coverage</a>.</p> </li> </ul> <p>For additional information , see <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/what-is-data-provider.html\">Data providers</a> on the <i>Amazon Location Service Developer Guide</i>.</p>" }, "PricingPlan":{ "shape":"PricingPlan", "documentation":"<p>No longer used. If included, the only allowed value is <code>RequestBasedUsage</code>.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. If included, the only allowed value is RequestBasedUsage.", "deprecatedSince":"2022-02-01" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>The optional description for the route calculator resource.</p>" }, "Tags":{ "shape":"TagMap", "documentation":"<p>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.</p> <ul> <li> <p>For example: { <code>\"tag1\" : \"value1\"</code>, <code>\"tag2\" : \"value2\"</code>}</p> </li> </ul> <p>Format: <code>\"key\" : \"value\"</code> </p> <p>Restrictions:</p> <ul> <li> <p>Maximum 50 tags per resource</p> </li> <li> <p>Each resource tag must be unique with a maximum of one value.</p> </li> <li> <p>Maximum key length: 128 Unicode characters in UTF-8</p> </li> <li> <p>Maximum value length: 256 Unicode characters in UTF-8</p> </li> <li> <p>Can use alphanumeric characters (A–Z, a–z, 0–9), and the following characters: + - = . _ : / @. </p> </li> <li> <p>Cannot use \"aws:\" as a prefix for a key.</p> </li> </ul>" } } }, "CreateRouteCalculatorResponse":{ "type":"structure", "required":[ "CalculatorName", "CalculatorArn", "CreateTime" ], "members":{ "CalculatorName":{ "shape":"ResourceName", "documentation":"<p>The name of the route calculator resource. </p> <ul> <li> <p>For example, <code>ExampleRouteCalculator</code>.</p> </li> </ul>" }, "CalculatorArn":{ "shape":"GeoArn", "documentation":"<p>The Amazon Resource Name (ARN) for the route calculator resource. Use the ARN when you specify a resource across all Amazon Web Services.</p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:route-calculator/ExampleCalculator</code> </p> </li> </ul>" }, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp when the route calculator resource was created in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p> <ul> <li> <p>For example, <code>2020–07-2T12:15:20.000Z+01:00</code> </p> </li> </ul>" } } }, "CreateTrackerRequest":{ "type":"structure", "required":["TrackerName"], "members":{ "TrackerName":{ "shape":"ResourceName", "documentation":"<p>The name for the tracker resource.</p> <p>Requirements:</p> <ul> <li> <p>Contain only alphanumeric characters (A-Z, a-z, 0-9) , hyphens (-), periods (.), and underscores (_).</p> </li> <li> <p>Must be a unique tracker resource name.</p> </li> <li> <p>No spaces allowed. For example, <code>ExampleTracker</code>.</p> </li> </ul>" }, "PricingPlan":{ "shape":"PricingPlan", "documentation":"<p>No longer used. If included, the only allowed value is <code>RequestBasedUsage</code>.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. If included, the only allowed value is RequestBasedUsage.", "deprecatedSince":"2022-02-01" }, "KmsKeyId":{ "shape":"KmsKeyId", "documentation":"<p>A key identifier for an <a href=\"https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html\">Amazon Web Services KMS customer managed key</a>. Enter a key ID, key ARN, alias name, or alias ARN.</p>" }, "PricingPlanDataSource":{ "shape":"String", "documentation":"<p>This parameter is no longer used.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. No longer allowed.", "deprecatedSince":"2022-02-01" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>An optional description for the tracker resource.</p>" }, "Tags":{ "shape":"TagMap", "documentation":"<p>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.</p> <p>Format: <code>\"key\" : \"value\"</code> </p> <p>Restrictions:</p> <ul> <li> <p>Maximum 50 tags per resource</p> </li> <li> <p>Each resource tag must be unique with a maximum of one value.</p> </li> <li> <p>Maximum key length: 128 Unicode characters in UTF-8</p> </li> <li> <p>Maximum value length: 256 Unicode characters in UTF-8</p> </li> <li> <p>Can use alphanumeric characters (A–Z, a–z, 0–9), and the following characters: + - = . _ : / @. </p> </li> <li> <p>Cannot use \"aws:\" as a prefix for a key.</p> </li> </ul>" }, "PositionFiltering":{ "shape":"PositionFiltering", "documentation":"<p>Specifies the position filtering for the tracker resource.</p> <p>Valid values:</p> <ul> <li> <p> <code>TimeBased</code> - 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. </p> </li> <li> <p> <code>DistanceBased</code> - 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. </p> </li> <li> <p> <code>AccuracyBased</code> - 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. </p> </li> </ul> <p>This field is optional. If not specified, the default value is <code>TimeBased</code>.</p>" }, "EventBridgeEnabled":{ "shape":"Boolean", "documentation":"<p>Whether to enable position <code>UPDATE</code> events from this tracker to be sent to EventBridge.</p> <note> <p>You do not need enable this feature to get <code>ENTER</code> and <code>EXIT</code> events for geofences with this tracker. Those events are always sent to EventBridge.</p> </note>" }, "KmsKeyEnableGeospatialQueries":{ "shape":"Boolean", "documentation":"<p>Enables <code>GeospatialQueries</code> for a tracker that uses a <a href=\"https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html\">Amazon Web Services KMS customer managed key</a>.</p> <p>This parameter is only used if you are using a KMS customer managed key.</p> <note> <p>If you wish to encrypt your data using your own KMS customer managed key, then the Bounding Polygon Queries feature will be disabled by default. This is because by using this feature, a representation of your device positions will not be encrypted using the your KMS managed key. The exact device position, however; is still encrypted using your managed key.</p> <p>You can choose to opt-in to the Bounding Polygon Quseries feature. This is done by setting the <code>KmsKeyEnableGeospatialQueries</code> parameter to true when creating or updating a Tracker.</p> </note>" } } }, "CreateTrackerResponse":{ "type":"structure", "required":[ "TrackerName", "TrackerArn", "CreateTime" ], "members":{ "TrackerName":{ "shape":"ResourceName", "documentation":"<p>The name of the tracker resource.</p>" }, "TrackerArn":{ "shape":"Arn", "documentation":"<p>The Amazon Resource Name (ARN) for the tracker resource. Used when you need to specify a resource across all Amazon Web Services.</p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:tracker/ExampleTracker</code> </p> </li> </ul>" }, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the tracker resource was created in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" } } }, "CustomLayer":{ "type":"string", "max":100, "min":1, "pattern":"[-._\\w]+" }, "CustomLayerList":{ "type":"list", "member":{"shape":"CustomLayer"}, "max":10, "min":0 }, "DataSourceConfiguration":{ "type":"structure", "members":{ "IntendedUse":{ "shape":"IntendedUse", "documentation":"<p>Specifies how the results of an operation will be stored by the caller. </p> <p>Valid values include:</p> <ul> <li> <p> <code>SingleUse</code> specifies that the results won't be stored. </p> </li> <li> <p> <code>Storage</code> specifies that the result can be cached or stored in a database.</p> </li> </ul> <p>Default value: <code>SingleUse</code> </p>" } }, "documentation":"<p>Specifies the data storage option chosen for requesting Places.</p> <important> <p>When using Amazon Location Places:</p> <ul> <li> <p>If using HERE Technologies as a data provider, you can't store results for locations in Japan by setting <code>IntendedUse</code> to <code>Storage</code>. parameter.</p> </li> <li> <p>Under the <code>MobileAssetTracking</code> or <code>MobilAssetManagement</code> pricing plan, you can't store results from your place index resources by setting <code>IntendedUse</code> to <code>Storage</code>. This returns a validation exception error.</p> </li> </ul> <p>For more information, see the <a href=\"https://aws.amazon.com/service-terms/\">AWS Service Terms</a> for Amazon Location Service.</p> </important>" }, "DeleteGeofenceCollectionRequest":{ "type":"structure", "required":["CollectionName"], "members":{ "CollectionName":{ "shape":"ResourceName", "documentation":"<p>The name of the geofence collection to be deleted.</p>", "location":"uri", "locationName":"CollectionName" } } }, "DeleteGeofenceCollectionResponse":{ "type":"structure", "members":{} }, "DeleteKeyRequest":{ "type":"structure", "required":["KeyName"], "members":{ "KeyName":{ "shape":"ResourceName", "documentation":"<p>The name of the API key to delete.</p>", "location":"uri", "locationName":"KeyName" }, "ForceDelete":{ "shape":"Boolean", "documentation":"<p>ForceDelete bypasses an API key's expiry conditions and deletes the key. Set the parameter <code>true</code> to delete the key or to <code>false</code> to not preemptively delete the API key.</p> <p>Valid values: <code>true</code>, or <code>false</code>.</p> <p>Required: No</p> <note> <p>This action is irreversible. Only use ForceDelete if you are certain the key is no longer in use.</p> </note>", "location":"querystring", "locationName":"forceDelete" } } }, "DeleteKeyResponse":{ "type":"structure", "members":{} }, "DeleteMapRequest":{ "type":"structure", "required":["MapName"], "members":{ "MapName":{ "shape":"ResourceName", "documentation":"<p>The name of the map resource to be deleted.</p>", "location":"uri", "locationName":"MapName" } } }, "DeleteMapResponse":{ "type":"structure", "members":{} }, "DeletePlaceIndexRequest":{ "type":"structure", "required":["IndexName"], "members":{ "IndexName":{ "shape":"ResourceName", "documentation":"<p>The name of the place index resource to be deleted.</p>", "location":"uri", "locationName":"IndexName" } } }, "DeletePlaceIndexResponse":{ "type":"structure", "members":{} }, "DeleteRouteCalculatorRequest":{ "type":"structure", "required":["CalculatorName"], "members":{ "CalculatorName":{ "shape":"ResourceName", "documentation":"<p>The name of the route calculator resource to be deleted.</p>", "location":"uri", "locationName":"CalculatorName" } } }, "DeleteRouteCalculatorResponse":{ "type":"structure", "members":{} }, "DeleteTrackerRequest":{ "type":"structure", "required":["TrackerName"], "members":{ "TrackerName":{ "shape":"ResourceName", "documentation":"<p>The name of the tracker resource to be deleted.</p>", "location":"uri", "locationName":"TrackerName" } } }, "DeleteTrackerResponse":{ "type":"structure", "members":{} }, "DescribeGeofenceCollectionRequest":{ "type":"structure", "required":["CollectionName"], "members":{ "CollectionName":{ "shape":"ResourceName", "documentation":"<p>The name of the geofence collection.</p>", "location":"uri", "locationName":"CollectionName" } } }, "DescribeGeofenceCollectionResponse":{ "type":"structure", "required":[ "CollectionName", "CollectionArn", "Description", "CreateTime", "UpdateTime" ], "members":{ "CollectionName":{ "shape":"ResourceName", "documentation":"<p>The name of the geofence collection.</p>" }, "CollectionArn":{ "shape":"Arn", "documentation":"<p>The Amazon Resource Name (ARN) for the geofence collection resource. Used when you need to specify a resource across all Amazon Web Services. </p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:geofence-collection/ExampleGeofenceCollection</code> </p> </li> </ul>" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>The optional description for the geofence collection.</p>" }, "PricingPlan":{ "shape":"PricingPlan", "documentation":"<p>No longer used. Always returns <code>RequestBasedUsage</code>.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. Always returns RequestBasedUsage.", "deprecatedSince":"2022-02-01" }, "PricingPlanDataSource":{ "shape":"String", "documentation":"<p>No longer used. Always returns an empty string.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. Unused.", "deprecatedSince":"2022-02-01" }, "KmsKeyId":{ "shape":"KmsKeyId", "documentation":"<p>A key identifier for an <a href=\"https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html\">Amazon Web Services KMS customer managed key</a> assigned to the Amazon Location resource</p>" }, "Tags":{ "shape":"TagMap", "documentation":"<p>Displays the key, value pairs of tags associated with this resource.</p>" }, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the geofence resource was created in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code> </p>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the geofence collection was last updated in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code> </p>" }, "GeofenceCount":{ "shape":"DescribeGeofenceCollectionResponseGeofenceCountInteger", "documentation":"<p>The number of geofences in the geofence collection.</p>" } } }, "DescribeGeofenceCollectionResponseGeofenceCountInteger":{ "type":"integer", "box":true, "min":0 }, "DescribeKeyRequest":{ "type":"structure", "required":["KeyName"], "members":{ "KeyName":{ "shape":"ResourceName", "documentation":"<p>The name of the API key resource.</p>", "location":"uri", "locationName":"KeyName" } } }, "DescribeKeyResponse":{ "type":"structure", "required":[ "Key", "KeyArn", "KeyName", "Restrictions", "CreateTime", "ExpireTime", "UpdateTime" ], "members":{ "Key":{ "shape":"ApiKey", "documentation":"<p>The key value/string of an API key.</p>" }, "KeyArn":{ "shape":"Arn", "documentation":"<p>The Amazon Resource Name (ARN) for the API key resource. Used when you need to specify a resource across all Amazon Web Services.</p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:key/ExampleKey</code> </p> </li> </ul>" }, "KeyName":{ "shape":"ResourceName", "documentation":"<p>The name of the API key resource.</p>" }, "Restrictions":{"shape":"ApiKeyRestrictions"}, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the API key resource was created in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" }, "ExpireTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the API key resource will expire in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the API key resource was last updated in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>The optional description for the API key resource.</p>" }, "Tags":{ "shape":"TagMap", "documentation":"<p>Tags associated with the API key resource.</p>" } } }, "DescribeMapRequest":{ "type":"structure", "required":["MapName"], "members":{ "MapName":{ "shape":"ResourceName", "documentation":"<p>The name of the map resource.</p>", "location":"uri", "locationName":"MapName" } } }, "DescribeMapResponse":{ "type":"structure", "required":[ "MapName", "MapArn", "DataSource", "Configuration", "Description", "CreateTime", "UpdateTime" ], "members":{ "MapName":{ "shape":"ResourceName", "documentation":"<p>The map style selected from an available provider.</p>" }, "MapArn":{ "shape":"GeoArn", "documentation":"<p>The Amazon Resource Name (ARN) for the map resource. Used to specify a resource across all Amazon Web Services.</p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:map/ExampleMap</code> </p> </li> </ul>" }, "PricingPlan":{ "shape":"PricingPlan", "documentation":"<p>No longer used. Always returns <code>RequestBasedUsage</code>.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. Always returns RequestBasedUsage.", "deprecatedSince":"2022-02-01" }, "DataSource":{ "shape":"String", "documentation":"<p>Specifies the data provider for the associated map tiles.</p>" }, "Configuration":{ "shape":"MapConfiguration", "documentation":"<p>Specifies the map tile style selected from a partner data provider.</p>" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>The optional description for the map resource.</p>" }, "Tags":{ "shape":"TagMap", "documentation":"<p>Tags associated with the map resource.</p>" }, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the map resource was created in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>.</p>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the map resource was last update in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>.</p>" } } }, "DescribePlaceIndexRequest":{ "type":"structure", "required":["IndexName"], "members":{ "IndexName":{ "shape":"ResourceName", "documentation":"<p>The name of the place index resource.</p>", "location":"uri", "locationName":"IndexName" } } }, "DescribePlaceIndexResponse":{ "type":"structure", "required":[ "IndexName", "IndexArn", "Description", "CreateTime", "UpdateTime", "DataSource", "DataSourceConfiguration" ], "members":{ "IndexName":{ "shape":"ResourceName", "documentation":"<p>The name of the place index resource being described.</p>" }, "IndexArn":{ "shape":"GeoArn", "documentation":"<p>The Amazon Resource Name (ARN) for the place index resource. Used to specify a resource across Amazon Web Services. </p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:place-index/ExamplePlaceIndex</code> </p> </li> </ul>" }, "PricingPlan":{ "shape":"PricingPlan", "documentation":"<p>No longer used. Always returns <code>RequestBasedUsage</code>.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. Always returns RequestBasedUsage.", "deprecatedSince":"2022-02-01" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>The optional description for the place index resource.</p>" }, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the place index resource was created in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the place index resource was last updated in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" }, "DataSource":{ "shape":"String", "documentation":"<p>The data provider of geospatial data. Values can be one of the following:</p> <ul> <li> <p> <code>Esri</code> </p> </li> <li> <p> <code>Grab</code> </p> </li> <li> <p> <code>Here</code> </p> </li> </ul> <p>For more information about data providers, see <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/what-is-data-provider.html\">Amazon Location Service data providers</a>.</p>" }, "DataSourceConfiguration":{ "shape":"DataSourceConfiguration", "documentation":"<p>The specified data storage option for requesting Places.</p>" }, "Tags":{ "shape":"TagMap", "documentation":"<p>Tags associated with place index resource.</p>" } } }, "DescribeRouteCalculatorRequest":{ "type":"structure", "required":["CalculatorName"], "members":{ "CalculatorName":{ "shape":"ResourceName", "documentation":"<p>The name of the route calculator resource.</p>", "location":"uri", "locationName":"CalculatorName" } } }, "DescribeRouteCalculatorResponse":{ "type":"structure", "required":[ "CalculatorName", "CalculatorArn", "Description", "CreateTime", "UpdateTime", "DataSource" ], "members":{ "CalculatorName":{ "shape":"ResourceName", "documentation":"<p>The name of the route calculator resource being described.</p>" }, "CalculatorArn":{ "shape":"GeoArn", "documentation":"<p>The Amazon Resource Name (ARN) for the Route calculator resource. Use the ARN when you specify a resource across Amazon Web Services.</p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:route-calculator/ExampleCalculator</code> </p> </li> </ul>" }, "PricingPlan":{ "shape":"PricingPlan", "documentation":"<p>Always returns <code>RequestBasedUsage</code>.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. Always returns RequestBasedUsage.", "deprecatedSince":"2022-02-01" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>The optional description of the route calculator resource.</p>" }, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp when the route calculator resource was created in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p> <ul> <li> <p>For example, <code>2020–07-2T12:15:20.000Z+01:00</code> </p> </li> </ul>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp when the route calculator resource was last updated in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p> <ul> <li> <p>For example, <code>2020–07-2T12:15:20.000Z+01:00</code> </p> </li> </ul>" }, "DataSource":{ "shape":"String", "documentation":"<p>The data provider of traffic and road network data. Indicates one of the available providers:</p> <ul> <li> <p> <code>Esri</code> </p> </li> <li> <p> <code>Grab</code> </p> </li> <li> <p> <code>Here</code> </p> </li> </ul> <p>For more information about data providers, see <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/what-is-data-provider.html\">Amazon Location Service data providers</a>.</p>" }, "Tags":{ "shape":"TagMap", "documentation":"<p>Tags associated with route calculator resource.</p>" } } }, "DescribeTrackerRequest":{ "type":"structure", "required":["TrackerName"], "members":{ "TrackerName":{ "shape":"ResourceName", "documentation":"<p>The name of the tracker resource.</p>", "location":"uri", "locationName":"TrackerName" } } }, "DescribeTrackerResponse":{ "type":"structure", "required":[ "TrackerName", "TrackerArn", "Description", "CreateTime", "UpdateTime" ], "members":{ "TrackerName":{ "shape":"ResourceName", "documentation":"<p>The name of the tracker resource.</p>" }, "TrackerArn":{ "shape":"Arn", "documentation":"<p>The Amazon Resource Name (ARN) for the tracker resource. Used when you need to specify a resource across all Amazon Web Services.</p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:tracker/ExampleTracker</code> </p> </li> </ul>" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>The optional description for the tracker resource.</p>" }, "PricingPlan":{ "shape":"PricingPlan", "documentation":"<p>Always returns <code>RequestBasedUsage</code>.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. Always returns RequestBasedUsage.", "deprecatedSince":"2022-02-01" }, "PricingPlanDataSource":{ "shape":"String", "documentation":"<p>No longer used. Always returns an empty string.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. Unused.", "deprecatedSince":"2022-02-01" }, "Tags":{ "shape":"TagMap", "documentation":"<p>The tags associated with the tracker resource.</p>" }, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the tracker resource was created in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the tracker resource was last updated in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" }, "KmsKeyId":{ "shape":"KmsKeyId", "documentation":"<p>A key identifier for an <a href=\"https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html\">Amazon Web Services KMS customer managed key</a> assigned to the Amazon Location resource.</p>" }, "PositionFiltering":{ "shape":"PositionFiltering", "documentation":"<p>The position filtering method of the tracker resource.</p>" }, "EventBridgeEnabled":{ "shape":"Boolean", "documentation":"<p>Whether <code>UPDATE</code> events from this tracker in EventBridge are enabled. If set to <code>true</code> these events will be sent to EventBridge.</p>" }, "KmsKeyEnableGeospatialQueries":{ "shape":"Boolean", "documentation":"<p>Enables <code>GeospatialQueries</code> for a tracker that uses a <a href=\"https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html\">Amazon Web Services KMS customer managed key</a>.</p> <p>This parameter is only used if you are using a KMS customer managed key.</p> <note> <p>If you wish to encrypt your data using your own KMS customer managed key, then the Bounding Polygon Queries feature will be disabled by default. This is because by using this feature, a representation of your device positions will not be encrypted using the your KMS managed key. The exact device position, however; is still encrypted using your managed key.</p> <p>You can choose to opt-in to the Bounding Polygon Quseries feature. This is done by setting the <code>KmsKeyEnableGeospatialQueries</code> parameter to true when creating or updating a Tracker.</p> </note>" } } }, "DevicePosition":{ "type":"structure", "required":[ "SampleTime", "ReceivedTime", "Position" ], "members":{ "DeviceId":{ "shape":"Id", "documentation":"<p>The device whose position you retrieved.</p>" }, "SampleTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp at which the device's position was determined. Uses <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" }, "ReceivedTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the tracker resource received the device position in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" }, "Position":{ "shape":"Position", "documentation":"<p>The last known device position.</p>" }, "Accuracy":{ "shape":"PositionalAccuracy", "documentation":"<p>The accuracy of the device position.</p>" }, "PositionProperties":{ "shape":"PositionPropertyMap", "documentation":"<p>The properties associated with the position.</p>" } }, "documentation":"<p>Contains the device position details.</p>" }, "DevicePositionList":{ "type":"list", "member":{"shape":"DevicePosition"} }, "DevicePositionUpdate":{ "type":"structure", "required":[ "DeviceId", "SampleTime", "Position" ], "members":{ "DeviceId":{ "shape":"Id", "documentation":"<p>The device associated to the position update.</p>" }, "SampleTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp at which the device's position was determined. Uses <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code> </p>" }, "Position":{ "shape":"Position", "documentation":"<p>The latest device position defined in <a href=\"https://earth-info.nga.mil/index.php?dir=wgs84&action=wgs84\">WGS 84</a> format: <code>[X or longitude, Y or latitude]</code>.</p>" }, "Accuracy":{ "shape":"PositionalAccuracy", "documentation":"<p>The accuracy of the device position.</p>" }, "PositionProperties":{ "shape":"PositionPropertyMap", "documentation":"<p>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.</p> <p>Format: <code>\"key\" : \"value\"</code> </p>" } }, "documentation":"<p>Contains the position update details for a device.</p>" }, "DeviceState":{ "type":"structure", "required":[ "DeviceId", "SampleTime", "Position" ], "members":{ "DeviceId":{ "shape":"Id", "documentation":"<p>The device identifier.</p>" }, "SampleTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp at which the device's position was determined. Uses <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601 </a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" }, "Position":{ "shape":"Position", "documentation":"<p>The last known device position.</p>" }, "Accuracy":{"shape":"PositionalAccuracy"}, "Ipv4Address":{ "shape":"DeviceStateIpv4AddressString", "documentation":"<p>The device's Ipv4 address.</p>" }, "WiFiAccessPoints":{ "shape":"WiFiAccessPointList", "documentation":"<p>The Wi-Fi access points the device is using.</p>" }, "CellSignals":{ "shape":"CellSignals", "documentation":"<p>The cellular network infrastructure that the device is connected to.</p>" } }, "documentation":"<p>The device's position, IP address, and Wi-Fi access points.</p>" }, "DeviceStateIpv4AddressString":{ "type":"string", "pattern":"(?:(?:25[0-5]|(?:2[0-4]|1\\d|[0-9]|)\\d)\\.?\\b){4}" }, "DimensionUnit":{ "type":"string", "enum":[ "Meters", "Feet" ] }, "DisassociateTrackerConsumerRequest":{ "type":"structure", "required":[ "TrackerName", "ConsumerArn" ], "members":{ "TrackerName":{ "shape":"ResourceName", "documentation":"<p>The name of the tracker resource to be dissociated from the consumer.</p>", "location":"uri", "locationName":"TrackerName" }, "ConsumerArn":{ "shape":"Arn", "documentation":"<p>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 Amazon Web Services. </p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:geofence-collection/ExampleGeofenceCollectionConsumer</code> </p> </li> </ul>", "location":"uri", "locationName":"ConsumerArn" } } }, "DisassociateTrackerConsumerResponse":{ "type":"structure", "members":{} }, "DistanceUnit":{ "type":"string", "enum":[ "Kilometers", "Miles" ] }, "Double":{ "type":"double", "box":true }, "Earfcn":{ "type":"integer", "max":262143, "min":0 }, "EutranCellId":{ "type":"integer", "max":268435455, "min":0 }, "FilterPlaceCategoryList":{ "type":"list", "member":{"shape":"PlaceCategory"}, "max":5, "min":1 }, "ForecastGeofenceEventsDeviceState":{ "type":"structure", "required":["Position"], "members":{ "Position":{ "shape":"Position", "documentation":"<p>The device's position.</p>" }, "Speed":{ "shape":"ForecastGeofenceEventsDeviceStateSpeedDouble", "documentation":"<p>The device's speed.</p>" } }, "documentation":"<p>The device's position and speed.</p>" }, "ForecastGeofenceEventsDeviceStateSpeedDouble":{ "type":"double", "box":true, "min":0 }, "ForecastGeofenceEventsRequest":{ "type":"structure", "required":[ "CollectionName", "DeviceState" ], "members":{ "CollectionName":{ "shape":"ResourceName", "documentation":"<p>The name of the geofence collection.</p>", "location":"uri", "locationName":"CollectionName" }, "DeviceState":{ "shape":"ForecastGeofenceEventsDeviceState", "documentation":"<p>Represents the device's state, including its current position and speed. When speed is omitted, this API performs a <i>containment check</i>. The <i>containment check</i> operation returns <code>IDLE</code> events for geofences where the device is currently inside of, but no other events.</p>" }, "TimeHorizonMinutes":{ "shape":"ForecastGeofenceEventsRequestTimeHorizonMinutesDouble", "documentation":"<p>The forward-looking time window for forecasting, specified in minutes. The API only returns events that are predicted to occur within this time horizon. When no value is specified, this API performs a <i>containment check</i>. The <i>containment check</i> operation returns <code>IDLE</code> events for geofences where the device is currently inside of, but no other events.</p>" }, "DistanceUnit":{ "shape":"DistanceUnit", "documentation":"<p>The distance unit used for the <code>NearestDistance</code> property returned in a forecasted event. The measurement system must match for <code>DistanceUnit</code> and <code>SpeedUnit</code>; if <code>Kilometers</code> is specified for <code>DistanceUnit</code>, then <code>SpeedUnit</code> must be <code>KilometersPerHour</code>. </p> <p>Default Value: <code>Kilometers</code> </p>" }, "SpeedUnit":{ "shape":"SpeedUnit", "documentation":"<p>The speed unit for the device captured by the device state. The measurement system must match for <code>DistanceUnit</code> and <code>SpeedUnit</code>; if <code>Kilometers</code> is specified for <code>DistanceUnit</code>, then <code>SpeedUnit</code> must be <code>KilometersPerHour</code>.</p> <p>Default Value: <code>KilometersPerHour</code>.</p>" }, "NextToken":{ "shape":"LargeToken", "documentation":"<p>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.</p> <p>Default value: <code>null</code> </p>" }, "MaxResults":{ "shape":"ForecastGeofenceEventsRequestMaxResultsInteger", "documentation":"<p>An optional limit for the number of resources returned in a single call.</p> <p>Default value: <code>20</code> </p>" } } }, "ForecastGeofenceEventsRequestMaxResultsInteger":{ "type":"integer", "box":true, "max":20, "min":1 }, "ForecastGeofenceEventsRequestTimeHorizonMinutesDouble":{ "type":"double", "box":true, "min":0 }, "ForecastGeofenceEventsResponse":{ "type":"structure", "required":[ "ForecastedEvents", "DistanceUnit", "SpeedUnit" ], "members":{ "ForecastedEvents":{ "shape":"ForecastedEventsList", "documentation":"<p>The list of forecasted events.</p>" }, "NextToken":{ "shape":"LargeToken", "documentation":"<p>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. </p>" }, "DistanceUnit":{ "shape":"DistanceUnit", "documentation":"<p>The distance unit for the forecasted events.</p>" }, "SpeedUnit":{ "shape":"SpeedUnit", "documentation":"<p>The speed unit for the forecasted events.</p>" } } }, "ForecastedEvent":{ "type":"structure", "required":[ "EventId", "GeofenceId", "IsDeviceInGeofence", "NearestDistance", "EventType" ], "members":{ "EventId":{ "shape":"Uuid", "documentation":"<p>The forecasted event identifier.</p>" }, "GeofenceId":{ "shape":"Id", "documentation":"<p>The geofence identifier pertaining to the forecasted event.</p>" }, "IsDeviceInGeofence":{ "shape":"Boolean", "documentation":"<p>Indicates if the device is located within the geofence.</p>" }, "NearestDistance":{ "shape":"NearestDistance", "documentation":"<p>The closest distance from the device's position to the geofence.</p>" }, "EventType":{ "shape":"ForecastedGeofenceEventType", "documentation":"<p>The event type, forecasting three states for which a device can be in relative to a geofence:</p> <p> <code>ENTER</code>: If a device is outside of a geofence, but would breach the fence if the device is moving at its current speed within time horizon window.</p> <p> <code>EXIT</code>: If a device is inside of a geofence, but would breach the fence if the device is moving at its current speed within time horizon window.</p> <p> <code>IDLE</code>: If a device is inside of a geofence, and the device is not moving.</p>" }, "ForecastedBreachTime":{ "shape":"Timestamp", "documentation":"<p>The forecasted time the device will breach the geofence in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code> </p>" }, "GeofenceProperties":{ "shape":"PropertyMap", "documentation":"<p>The geofence properties.</p>" } }, "documentation":"<p>A forecasted event represents a geofence event in relation to the requested device state, that may occur given the provided device state and time horizon.</p>" }, "ForecastedEventsList":{ "type":"list", "member":{"shape":"ForecastedEvent"} }, "ForecastedGeofenceEventType":{ "type":"string", "enum":[ "ENTER", "EXIT", "IDLE" ] }, "GeoArn":{ "type":"string", "max":1600, "min":0, "pattern":"arn(:[a-z0-9]+([.-][a-z0-9]+)*):geo(:([a-z0-9]+([.-][a-z0-9]+)*))(:[0-9]+):((\\*)|([-a-z]+[/][*-._\\w]+))" }, "GeoArnV2":{ "type":"string", "max":1600, "min":0, "pattern":".*(^arn(:[a-z0-9]+([.-][a-z0-9]+)*):geo(:([a-z0-9]+([.-][a-z0-9]+)*))(:[0-9]+):((\\*)|([-a-z]+[/][*-._\\w]+))$)|(^arn(:[a-z0-9]+([.-][a-z0-9]+)*):(geo-routes|geo-places|geo-maps)(:((\\*)|([a-z0-9]+([.-][a-z0-9]+)*)))::((provider[\\/][*-._\\w]+))$).*" }, "GeofenceGeometry":{ "type":"structure", "members":{ "Polygon":{ "shape":"GeofenceGeometryPolygonList", "documentation":"<p>A <code>Polygon</code> is a list of up to 250 linear rings which represent the shape of a geofence. This list <i>must</i> include 1 exterior ring (representing the outer perimeter of the geofence), and can optionally include up to 249 interior rings (representing polygonal spaces within the perimeter, which are excluded from the geofence area).</p> <p>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 represented as an array of doubles of length 2: <code>[longitude, latitude]</code>.</p> <p>Each linear ring is represented as an array of arrays of doubles (<code>[[longitude, latitude], [longitude, latitude], ...]</code>). The vertices for the exterior ring must be listed in <i>counter-clockwise</i> sequence. Vertices for all interior rings must be listed in <i>clockwise</i> sequence.</p> <p>The list of linear rings that describe the entire <code>Polygon</code> is represented as an array of arrays of arrays of doubles (<code>[[[longitude, latitude], [longitude, latitude], ...], [[longitude, latitude], [longitude, latitude], ...], ...]</code>). The exterior ring must be listed first, before any interior rings.</p> <note> <p>The following additional requirements and limitations apply to geometries defined using the <code>Polygon</code> parameter:</p> <ul> <li> <p>The entire <code>Polygon</code> must consist of no more than 1,000 vertices, including all vertices from the exterior ring and all interior rings.</p> </li> <li> <p>Rings must not touch or cross each other.</p> </li> <li> <p>All interior rings must be fully contained within the exterior ring.</p> </li> <li> <p>Interior rings must not contain other interior rings.</p> </li> <li> <p>No ring is permitted to intersect itself.</p> </li> </ul> </note>" }, "Circle":{ "shape":"Circle", "documentation":"<p>A circle on the earth, as defined by a center point and a radius.</p>" }, "Geobuf":{ "shape":"Base64EncodedGeobuf", "documentation":"<p>Geobuf is a compact binary encoding for geographic data that provides lossless compression of GeoJSON polygons. The Geobuf must be Base64-encoded.</p> <p>This parameter can contain a Geobuf-encoded GeoJSON geometry object of type <code>Polygon</code> <i>OR</i> <code>MultiPolygon</code>. For more information and specific configuration requirements for these object types, see <a href=\"https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GeofenceGeometry.html#location-Type-WaypointGeofencing_GeofenceGeometry-Polygon\">Polygon</a> and <a href=\"https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GeofenceGeometry.html#location-Type-WaypointGeofencing_GeofenceGeometry-MultiPolygon\">MultiPolygon</a>.</p> <note> <p>The following limitations apply specifically to geometries defined using the <code>Geobuf</code> parameter, and supercede the corresponding limitations of the <code>Polygon</code> and <code>MultiPolygon</code> parameters:</p> <ul> <li> <p>A <code>Polygon</code> in <code>Geobuf</code> format can have up to 25,000 rings and up to 100,000 total vertices, including all vertices from all component rings.</p> </li> <li> <p>A <code>MultiPolygon</code> in <code>Geobuf</code> format can contain up to 10,000 <code>Polygons</code> and up to 100,000 total vertices, including all vertices from all component <code>Polygons</code>.</p> </li> </ul> </note>" }, "MultiPolygon":{ "shape":"GeofenceGeometryMultiPolygonList", "documentation":"<p>A <code>MultiPolygon</code> is a list of up to 250 <code>Polygon</code> elements which represent the shape of a geofence. The <code>Polygon</code> components of a <code>MultiPolygon</code> geometry can define separate geographical areas that are considered part of the same geofence, perimeters of larger exterior areas with smaller interior spaces that are excluded from the geofence, or some combination of these use cases to form complex geofence boundaries.</p> <p>For more information and specific configuration requirements for the <code>Polygon</code> components that form a <code>MultiPolygon</code>, see <a href=\"https://docs.aws.amazon.com/location/latest/APIReference/API_WaypointGeofencing_GeofenceGeometry.html#location-Type-WaypointGeofencing_GeofenceGeometry-Polygon\">Polygon</a>.</p> <note> <p>The following additional requirements and limitations apply to geometries defined using the <code>MultiPolygon</code> parameter:</p> <ul> <li> <p>The entire <code>MultiPolygon</code> must consist of no more than 1,000 vertices, including all vertices from all component <code>Polygons</code>.</p> </li> <li> <p>Each edge of a component <code>Polygon</code> must intersect no more than 5 edges from other <code>Polygons</code>. Parallel edges that are shared but do not cross are not counted toward this limit.</p> </li> <li> <p>The total number of intersecting edges of component <code>Polygons</code> must be no more than 100,000. Parallel edges that are shared but do not cross are not counted toward this limit.</p> </li> </ul> </note>" } }, "documentation":"<p>Contains the geofence geometry details.</p> <p>A geofence geometry can be a circle, a polygon, or a multipolygon. <code>Polygon</code> and <code>MultiPolygon</code> geometries can be defined using their respective parameters, or encoded in Geobuf format using the <code>Geobuf</code> parameter. Including multiple geometry types in the same request will return a validation error.</p> <note> <p>Amazon Location doesn't currently support polygons that cross the antimeridian.</p> </note>" }, "GeofenceGeometryMultiPolygonList":{ "type":"list", "member":{"shape":"LinearRings"}, "max":250, "min":1 }, "GeofenceGeometryPolygonList":{ "type":"list", "member":{"shape":"LinearRing"}, "max":250, "min":1 }, "GetDevicePositionHistoryRequest":{ "type":"structure", "required":[ "TrackerName", "DeviceId" ], "members":{ "TrackerName":{ "shape":"ResourceName", "documentation":"<p>The tracker resource receiving the request for the device position history.</p>", "location":"uri", "locationName":"TrackerName" }, "DeviceId":{ "shape":"Id", "documentation":"<p>The device whose position history you want to retrieve.</p>", "location":"uri", "locationName":"DeviceId" }, "NextToken":{ "shape":"Token", "documentation":"<p>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. </p> <p>Default value: <code>null</code> </p>" }, "StartTimeInclusive":{ "shape":"Timestamp", "documentation":"<p>Specify the start time for the position history in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. By default, the value will be 24 hours prior to the time that the request is made.</p> <p>Requirement:</p> <ul> <li> <p>The time specified for <code>StartTimeInclusive</code> must be before <code>EndTimeExclusive</code>.</p> </li> </ul>" }, "EndTimeExclusive":{ "shape":"Timestamp", "documentation":"<p>Specify the end time for the position history in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. By default, the value will be the time that the request is made.</p> <p>Requirement:</p> <ul> <li> <p>The time specified for <code>EndTimeExclusive</code> must be after the time for <code>StartTimeInclusive</code>.</p> </li> </ul>" }, "MaxResults":{ "shape":"GetDevicePositionHistoryRequestMaxResultsInteger", "documentation":"<p>An optional limit for the number of device positions returned in a single call.</p> <p>Default value: <code>100</code> </p>" } } }, "GetDevicePositionHistoryRequestMaxResultsInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "GetDevicePositionHistoryResponse":{ "type":"structure", "required":["DevicePositions"], "members":{ "DevicePositions":{ "shape":"DevicePositionList", "documentation":"<p>Contains the position history details for the requested device.</p>" }, "NextToken":{ "shape":"Token", "documentation":"<p>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.</p>" } } }, "GetDevicePositionRequest":{ "type":"structure", "required":[ "TrackerName", "DeviceId" ], "members":{ "TrackerName":{ "shape":"ResourceName", "documentation":"<p>The tracker resource receiving the position update.</p>", "location":"uri", "locationName":"TrackerName" }, "DeviceId":{ "shape":"Id", "documentation":"<p>The device whose position you want to retrieve.</p>", "location":"uri", "locationName":"DeviceId" } } }, "GetDevicePositionResponse":{ "type":"structure", "required":[ "SampleTime", "ReceivedTime", "Position" ], "members":{ "DeviceId":{ "shape":"Id", "documentation":"<p>The device whose position you retrieved.</p>" }, "SampleTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp at which the device's position was determined. Uses <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601 </a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" }, "ReceivedTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the tracker resource received the device position. Uses <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601 </a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" }, "Position":{ "shape":"Position", "documentation":"<p>The last known device position.</p>" }, "Accuracy":{ "shape":"PositionalAccuracy", "documentation":"<p>The accuracy of the device position.</p>" }, "PositionProperties":{ "shape":"PositionPropertyMap", "documentation":"<p>The properties associated with the position.</p>" } } }, "GetGeofenceRequest":{ "type":"structure", "required":[ "CollectionName", "GeofenceId" ], "members":{ "CollectionName":{ "shape":"ResourceName", "documentation":"<p>The geofence collection storing the target geofence.</p>", "location":"uri", "locationName":"CollectionName" }, "GeofenceId":{ "shape":"Id", "documentation":"<p>The geofence you're retrieving details for.</p>", "location":"uri", "locationName":"GeofenceId" } } }, "GetGeofenceResponse":{ "type":"structure", "required":[ "GeofenceId", "Geometry", "Status", "CreateTime", "UpdateTime" ], "members":{ "GeofenceId":{ "shape":"Id", "documentation":"<p>The geofence identifier.</p>" }, "Geometry":{ "shape":"GeofenceGeometry", "documentation":"<p>Contains the geofence geometry details describing the position of the geofence. Can be a circle, a polygon, or a multipolygon.</p>" }, "Status":{ "shape":"String", "documentation":"<p>Identifies the state of the geofence. A geofence will hold one of the following states:</p> <ul> <li> <p> <code>ACTIVE</code> — The geofence has been indexed by the system. </p> </li> <li> <p> <code>PENDING</code> — The geofence is being processed by the system.</p> </li> <li> <p> <code>FAILED</code> — The geofence failed to be indexed by the system.</p> </li> <li> <p> <code>DELETED</code> — The geofence has been deleted from the system index.</p> </li> <li> <p> <code>DELETING</code> — The geofence is being deleted from the system index.</p> </li> </ul>" }, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the geofence collection was created in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code> </p>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the geofence collection was last updated in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code> </p>" }, "GeofenceProperties":{ "shape":"PropertyMap", "documentation":"<p>User defined properties of the geofence. A property is a key-value pair stored with the geofence and added to any geofence event triggered with that geofence.</p> <p>Format: <code>\"key\" : \"value\"</code> </p>" } } }, "GetMapGlyphsRequest":{ "type":"structure", "required":[ "MapName", "FontStack", "FontUnicodeRange" ], "members":{ "MapName":{ "shape":"ResourceName", "documentation":"<p>The map resource associated with the glyph file.</p>", "location":"uri", "locationName":"MapName" }, "FontStack":{ "shape":"String", "documentation":"<p>A comma-separated list of fonts to load glyphs from in order of preference. For example, <code>Noto Sans Regular, Arial Unicode</code>.</p> <p>Valid font stacks for <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/esri.html\">Esri</a> styles: </p> <ul> <li> <p>VectorEsriDarkGrayCanvas – <code>Ubuntu Medium Italic</code> | <code>Ubuntu Medium</code> | <code>Ubuntu Italic</code> | <code>Ubuntu Regular</code> | <code>Ubuntu Bold</code> </p> </li> <li> <p>VectorEsriLightGrayCanvas – <code>Ubuntu Italic</code> | <code>Ubuntu Regular</code> | <code>Ubuntu Light</code> | <code>Ubuntu Bold</code> </p> </li> <li> <p>VectorEsriTopographic – <code>Noto Sans Italic</code> | <code>Noto Sans Regular</code> | <code>Noto Sans Bold</code> | <code>Noto Serif Regular</code> | <code>Roboto Condensed Light Italic</code> </p> </li> <li> <p>VectorEsriStreets – <code>Arial Regular</code> | <code>Arial Italic</code> | <code>Arial Bold</code> </p> </li> <li> <p>VectorEsriNavigation – <code>Arial Regular</code> | <code>Arial Italic</code> | <code>Arial Bold</code> </p> </li> </ul> <p>Valid font stacks for <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/HERE.html\">HERE Technologies</a> styles:</p> <ul> <li> <p>VectorHereContrast – <code>Fira GO Regular</code> | <code>Fira GO Bold</code> </p> </li> <li> <p>VectorHereExplore, VectorHereExploreTruck, HybridHereExploreSatellite – <code>Fira GO Italic</code> | <code>Fira GO Map</code> | <code>Fira GO Map Bold</code> | <code>Noto Sans CJK JP Bold</code> | <code>Noto Sans CJK JP Light</code> | <code>Noto Sans CJK JP Regular</code> </p> </li> </ul> <p>Valid font stacks for <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/grab.html\">GrabMaps</a> styles:</p> <ul> <li> <p>VectorGrabStandardLight, VectorGrabStandardDark – <code>Noto Sans Regular</code> | <code>Noto Sans Medium</code> | <code>Noto Sans Bold</code> </p> </li> </ul> <p>Valid font stacks for <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/open-data.html\">Open Data</a> styles:</p> <ul> <li> <p>VectorOpenDataStandardLight, VectorOpenDataStandardDark, VectorOpenDataVisualizationLight, VectorOpenDataVisualizationDark – <code>Amazon Ember Regular,Noto Sans Regular</code> | <code>Amazon Ember Bold,Noto Sans Bold</code> | <code>Amazon Ember Medium,Noto Sans Medium</code> | <code>Amazon Ember Regular Italic,Noto Sans Italic</code> | <code>Amazon Ember Condensed RC Regular,Noto Sans Regular</code> | <code>Amazon Ember Condensed RC Bold,Noto Sans Bold</code> | <code>Amazon Ember Regular,Noto Sans Regular,Noto Sans Arabic Regular</code> | <code>Amazon Ember Condensed RC Bold,Noto Sans Bold,Noto Sans Arabic Condensed Bold</code> | <code>Amazon Ember Bold,Noto Sans Bold,Noto Sans Arabic Bold</code> | <code>Amazon Ember Regular Italic,Noto Sans Italic,Noto Sans Arabic Regular</code> | <code>Amazon Ember Condensed RC Regular,Noto Sans Regular,Noto Sans Arabic Condensed Regular</code> | <code>Amazon Ember Medium,Noto Sans Medium,Noto Sans Arabic Medium</code> </p> </li> </ul> <note> <p>The fonts used by the Open Data map styles are combined fonts that use <code>Amazon Ember</code> for most glyphs but <code>Noto Sans</code> for glyphs unsupported by <code>Amazon Ember</code>.</p> </note>", "location":"uri", "locationName":"FontStack" }, "FontUnicodeRange":{ "shape":"GetMapGlyphsRequestFontUnicodeRangeString", "documentation":"<p>A Unicode range of characters to download glyphs for. Each response will contain 256 characters. For example, 0–255 includes all characters from range <code>U+0000</code> to <code>00FF</code>. Must be aligned to multiples of 256.</p>", "location":"uri", "locationName":"FontUnicodeRange" }, "Key":{ "shape":"ApiKey", "documentation":"<p>The optional <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/using-apikeys.html\">API key</a> to authorize the request.</p>", "location":"querystring", "locationName":"key" } } }, "GetMapGlyphsRequestFontUnicodeRangeString":{ "type":"string", "pattern":"[0-9]+-[0-9]+\\.pbf" }, "GetMapGlyphsResponse":{ "type":"structure", "members":{ "Blob":{ "shape":"Blob", "documentation":"<p>The glyph, as binary blob.</p>" }, "ContentType":{ "shape":"String", "documentation":"<p>The map glyph content type. For example, <code>application/octet-stream</code>.</p>", "location":"header", "locationName":"Content-Type" }, "CacheControl":{ "shape":"String", "documentation":"<p>The HTTP Cache-Control directive for the value.</p>", "location":"header", "locationName":"Cache-Control" } }, "payload":"Blob" }, "GetMapSpritesRequest":{ "type":"structure", "required":[ "MapName", "FileName" ], "members":{ "MapName":{ "shape":"ResourceName", "documentation":"<p>The map resource associated with the sprite file.</p>", "location":"uri", "locationName":"MapName" }, "FileName":{ "shape":"GetMapSpritesRequestFileNameString", "documentation":"<p>The name of the sprite file. Use the following file names for the sprite sheet:</p> <ul> <li> <p> <code>sprites.png</code> </p> </li> <li> <p> <code>sprites@2x.png</code> for high pixel density displays</p> </li> </ul> <p>For the JSON document containing image offsets. Use the following file names:</p> <ul> <li> <p> <code>sprites.json</code> </p> </li> <li> <p> <code>sprites@2x.json</code> for high pixel density displays</p> </li> </ul>", "location":"uri", "locationName":"FileName" }, "Key":{ "shape":"ApiKey", "documentation":"<p>The optional <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/using-apikeys.html\">API key</a> to authorize the request.</p>", "location":"querystring", "locationName":"key" } } }, "GetMapSpritesRequestFileNameString":{ "type":"string", "pattern":"sprites(@2x)?\\.(png|json)" }, "GetMapSpritesResponse":{ "type":"structure", "members":{ "Blob":{ "shape":"Blob", "documentation":"<p>Contains the body of the sprite sheet or JSON offset file.</p>" }, "ContentType":{ "shape":"String", "documentation":"<p>The content type of the sprite sheet and offsets. For example, the sprite sheet content type is <code>image/png</code>, and the sprite offset JSON document is <code>application/json</code>. </p>", "location":"header", "locationName":"Content-Type" }, "CacheControl":{ "shape":"String", "documentation":"<p>The HTTP Cache-Control directive for the value.</p>", "location":"header", "locationName":"Cache-Control" } }, "payload":"Blob" }, "GetMapStyleDescriptorRequest":{ "type":"structure", "required":["MapName"], "members":{ "MapName":{ "shape":"ResourceName", "documentation":"<p>The map resource to retrieve the style descriptor from.</p>", "location":"uri", "locationName":"MapName" }, "Key":{ "shape":"ApiKey", "documentation":"<p>The optional <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/using-apikeys.html\">API key</a> to authorize the request.</p>", "location":"querystring", "locationName":"key" } } }, "GetMapStyleDescriptorResponse":{ "type":"structure", "members":{ "Blob":{ "shape":"Blob", "documentation":"<p>Contains the body of the style descriptor.</p>" }, "ContentType":{ "shape":"String", "documentation":"<p>The style descriptor's content type. For example, <code>application/json</code>.</p>", "location":"header", "locationName":"Content-Type" }, "CacheControl":{ "shape":"String", "documentation":"<p>The HTTP Cache-Control directive for the value.</p>", "location":"header", "locationName":"Cache-Control" } }, "payload":"Blob" }, "GetMapTileRequest":{ "type":"structure", "required":[ "MapName", "Z", "X", "Y" ], "members":{ "MapName":{ "shape":"ResourceName", "documentation":"<p>The map resource to retrieve the map tiles from.</p>", "location":"uri", "locationName":"MapName" }, "Z":{ "shape":"GetMapTileRequestZString", "documentation":"<p>The zoom value for the map tile.</p>", "location":"uri", "locationName":"Z" }, "X":{ "shape":"GetMapTileRequestXString", "documentation":"<p>The X axis value for the map tile.</p>", "location":"uri", "locationName":"X" }, "Y":{ "shape":"GetMapTileRequestYString", "documentation":"<p>The Y axis value for the map tile. </p>", "location":"uri", "locationName":"Y" }, "Key":{ "shape":"ApiKey", "documentation":"<p>The optional <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/using-apikeys.html\">API key</a> to authorize the request.</p>", "location":"querystring", "locationName":"key" } } }, "GetMapTileRequestXString":{ "type":"string", "pattern":".*\\d+.*", "sensitive":true }, "GetMapTileRequestYString":{ "type":"string", "pattern":".*\\d+.*", "sensitive":true }, "GetMapTileRequestZString":{ "type":"string", "pattern":".*\\d+.*", "sensitive":true }, "GetMapTileResponse":{ "type":"structure", "members":{ "Blob":{ "shape":"Blob", "documentation":"<p>Contains Mapbox Vector Tile (MVT) data.</p>" }, "ContentType":{ "shape":"String", "documentation":"<p>The map tile's content type. For example, <code>application/vnd.mapbox-vector-tile</code>.</p>", "location":"header", "locationName":"Content-Type" }, "CacheControl":{ "shape":"String", "documentation":"<p>The HTTP Cache-Control directive for the value.</p>", "location":"header", "locationName":"Cache-Control" } }, "payload":"Blob" }, "GetPlaceRequest":{ "type":"structure", "required":[ "IndexName", "PlaceId" ], "members":{ "IndexName":{ "shape":"ResourceName", "documentation":"<p>The name of the place index resource that you want to use for the search.</p>", "location":"uri", "locationName":"IndexName" }, "PlaceId":{ "shape":"PlaceId", "documentation":"<p>The identifier of the place to find.</p>", "location":"uri", "locationName":"PlaceId" }, "Language":{ "shape":"LanguageTag", "documentation":"<p>The preferred language used to return results. The value must be a valid <a href=\"https://tools.ietf.org/search/bcp47\">BCP 47</a> language tag, for example, <code>en</code> for English.</p> <p>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.</p> <p>For an example, we'll use the Greek language. You search for a location around Athens, Greece, with the <code>language</code> parameter set to <code>en</code>. The <code>city</code> in the results will most likely be returned as <code>Athens</code>.</p> <p>If you set the <code>language</code> parameter to <code>el</code>, for Greek, then the <code>city</code> in the results will more likely be returned as <code>Αθήνα</code>.</p> <p>If the data provider does not have a value for Greek, the result will be in a language that the provider does support.</p>", "location":"querystring", "locationName":"language" }, "Key":{ "shape":"ApiKey", "documentation":"<p>The optional <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/using-apikeys.html\">API key</a> to authorize the request.</p>", "location":"querystring", "locationName":"key" } } }, "GetPlaceResponse":{ "type":"structure", "required":["Place"], "members":{ "Place":{ "shape":"Place", "documentation":"<p>Details about the result, such as its address and position.</p>" } } }, "Id":{ "type":"string", "max":100, "min":1, "pattern":"[-._\\p{L}\\p{N}]+" }, "InferredState":{ "type":"structure", "required":["ProxyDetected"], "members":{ "Position":{ "shape":"Position", "documentation":"<p>The device position inferred by the provided position, IP address, cellular signals, and Wi-Fi- access points.</p>" }, "Accuracy":{ "shape":"PositionalAccuracy", "documentation":"<p>The level of certainty of the inferred position.</p>" }, "DeviationDistance":{ "shape":"Double", "documentation":"<p>The distance between the inferred position and the device's self-reported position.</p>" }, "ProxyDetected":{ "shape":"Boolean", "documentation":"<p>Indicates if a proxy was used.</p>" } }, "documentation":"<p>The inferred state of the device, given the provided position, IP address, cellular signals, and Wi-Fi- access points.</p>" }, "Integer":{ "type":"integer", "box":true }, "IntendedUse":{ "type":"string", "enum":[ "SingleUse", "Storage" ] }, "InternalServerException":{ "type":"structure", "required":["Message"], "members":{ "Message":{ "shape":"String", "locationName":"message" } }, "documentation":"<p>The request has failed to process because of an unknown server error, exception, or failure.</p>", "error":{"httpStatusCode":500}, "exception":true, "fault":true, "retryable":{"throttling":false} }, "KmsKeyId":{ "type":"string", "max":2048, "min":1 }, "LanguageTag":{ "type":"string", "max":35, "min":2 }, "LargeToken":{ "type":"string", "max":60000, "min":1 }, "Leg":{ "type":"structure", "required":[ "StartPosition", "EndPosition", "Distance", "DurationSeconds", "Steps" ], "members":{ "StartPosition":{ "shape":"Position", "documentation":"<p>The starting position of the leg. Follows the format <code>[longitude,latitude]</code>.</p> <note> <p>If the <code>StartPosition</code> isn't located on a road, it's <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/snap-to-nearby-road.html\">snapped to a nearby road</a>. </p> </note>" }, "EndPosition":{ "shape":"Position", "documentation":"<p>The terminating position of the leg. Follows the format <code>[longitude,latitude]</code>.</p> <note> <p>If the <code>EndPosition</code> isn't located on a road, it's <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/nap-to-nearby-road.html\">snapped to a nearby road</a>. </p> </note>" }, "Distance":{ "shape":"LegDistanceDouble", "documentation":"<p>The distance between the leg's <code>StartPosition</code> and <code>EndPosition</code> along a calculated route. </p> <ul> <li> <p>The default measurement is <code>Kilometers</code> unless the request specifies a <code>DistanceUnit</code> of <code>Miles</code>.</p> </li> </ul>" }, "DurationSeconds":{ "shape":"LegDurationSecondsDouble", "documentation":"<p>The estimated travel time between the leg's <code>StartPosition</code> and <code>EndPosition</code>. The travel mode and departure time that you specify in the request determines the calculated time.</p>" }, "Geometry":{ "shape":"LegGeometry", "documentation":"<p>Contains the calculated route's path as a linestring geometry.</p>" }, "Steps":{ "shape":"StepList", "documentation":"<p>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.</p>" } }, "documentation":"<p>Contains the calculated route's details for each path between a pair of positions. The number of legs returned corresponds to one fewer than the total number of positions in the request. </p> <p>For example, a route with a departure position and destination position returns one leg with the positions <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/snap-to-nearby-road.html\">snapped to a nearby road</a>:</p> <ul> <li> <p>The <code>StartPosition</code> is the departure position.</p> </li> <li> <p>The <code>EndPosition</code> is the destination position.</p> </li> </ul> <p>A route with a waypoint between the departure and destination position returns two legs with the positions snapped to a nearby road:</p> <ul> <li> <p>Leg 1: The <code>StartPosition</code> is the departure position . The <code>EndPosition</code> is the waypoint positon.</p> </li> <li> <p>Leg 2: The <code>StartPosition</code> is the waypoint position. The <code>EndPosition</code> is the destination position.</p> </li> </ul>" }, "LegDistanceDouble":{ "type":"double", "box":true, "min":0, "sensitive":true }, "LegDurationSecondsDouble":{ "type":"double", "box":true, "min":0, "sensitive":true }, "LegGeometry":{ "type":"structure", "members":{ "LineString":{ "shape":"LineString", "documentation":"<p>An ordered list of positions used to plot a route on a map. </p> <p>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.</p> <ul> <li> <p>For example, <code>[[-123.117, 49.284],[-123.115, 49.285],[-123.115, 49.285]]</code> </p> </li> </ul>" } }, "documentation":"<p>Contains the geometry details for each path between a pair of positions. Used in plotting a route leg on a map.</p>" }, "LegList":{ "type":"list", "member":{"shape":"Leg"} }, "LineString":{ "type":"list", "member":{"shape":"Position"}, "min":2 }, "LinearRing":{ "type":"list", "member":{"shape":"Position"}, "min":4 }, "LinearRings":{ "type":"list", "member":{"shape":"LinearRing"}, "min":1 }, "ListDevicePositionsRequest":{ "type":"structure", "required":["TrackerName"], "members":{ "TrackerName":{ "shape":"ResourceName", "documentation":"<p>The tracker resource containing the requested devices.</p>", "location":"uri", "locationName":"TrackerName" }, "MaxResults":{ "shape":"ListDevicePositionsRequestMaxResultsInteger", "documentation":"<p>An optional limit for the number of entries returned in a single call.</p> <p>Default value: <code>100</code> </p>" }, "NextToken":{ "shape":"Token", "documentation":"<p>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.</p> <p>Default value: <code>null</code> </p>" }, "FilterGeometry":{ "shape":"TrackingFilterGeometry", "documentation":"<p>The geometry used to filter device positions.</p>" } } }, "ListDevicePositionsRequestMaxResultsInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ListDevicePositionsResponse":{ "type":"structure", "required":["Entries"], "members":{ "Entries":{ "shape":"ListDevicePositionsResponseEntryList", "documentation":"<p>Contains details about each device's last known position.</p>" }, "NextToken":{ "shape":"Token", "documentation":"<p>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.</p>" } } }, "ListDevicePositionsResponseEntry":{ "type":"structure", "required":[ "DeviceId", "SampleTime", "Position" ], "members":{ "DeviceId":{ "shape":"Id", "documentation":"<p>The ID of the device for this position.</p>" }, "SampleTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp at which the device position was determined. Uses <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>.</p>" }, "Position":{ "shape":"Position", "documentation":"<p>The last known device position. Empty if no positions currently stored.</p>" }, "Accuracy":{ "shape":"PositionalAccuracy", "documentation":"<p>The accuracy of the device position.</p>" }, "PositionProperties":{ "shape":"PositionPropertyMap", "documentation":"<p>The properties associated with the position.</p>" } }, "documentation":"<p>Contains the tracker resource details.</p>" }, "ListDevicePositionsResponseEntryList":{ "type":"list", "member":{"shape":"ListDevicePositionsResponseEntry"} }, "ListGeofenceCollectionsRequest":{ "type":"structure", "members":{ "MaxResults":{ "shape":"ListGeofenceCollectionsRequestMaxResultsInteger", "documentation":"<p>An optional limit for the number of resources returned in a single call. </p> <p>Default value: <code>100</code> </p>" }, "NextToken":{ "shape":"Token", "documentation":"<p>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. </p> <p>Default value: <code>null</code> </p>" } } }, "ListGeofenceCollectionsRequestMaxResultsInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ListGeofenceCollectionsResponse":{ "type":"structure", "required":["Entries"], "members":{ "Entries":{ "shape":"ListGeofenceCollectionsResponseEntryList", "documentation":"<p>Lists the geofence collections that exist in your Amazon Web Services account.</p>" }, "NextToken":{ "shape":"Token", "documentation":"<p>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. </p>" } } }, "ListGeofenceCollectionsResponseEntry":{ "type":"structure", "required":[ "CollectionName", "Description", "CreateTime", "UpdateTime" ], "members":{ "CollectionName":{ "shape":"ResourceName", "documentation":"<p>The name of the geofence collection.</p>" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>The description for the geofence collection</p>" }, "PricingPlan":{ "shape":"PricingPlan", "documentation":"<p>No longer used. Always returns <code>RequestBasedUsage</code>.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. Always returns RequestBasedUsage.", "deprecatedSince":"2022-02-01" }, "PricingPlanDataSource":{ "shape":"String", "documentation":"<p>No longer used. Always returns an empty string.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. Unused.", "deprecatedSince":"2022-02-01" }, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the geofence collection was created in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code> </p>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>Specifies a timestamp for when the resource was last updated in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code> </p>" } }, "documentation":"<p>Contains the geofence collection details.</p> <note> <p>The returned geometry will always match the geometry format used when the geofence was created.</p> </note>" }, "ListGeofenceCollectionsResponseEntryList":{ "type":"list", "member":{"shape":"ListGeofenceCollectionsResponseEntry"} }, "ListGeofenceResponseEntry":{ "type":"structure", "required":[ "GeofenceId", "Geometry", "Status", "CreateTime", "UpdateTime" ], "members":{ "GeofenceId":{ "shape":"Id", "documentation":"<p>The geofence identifier.</p>" }, "Geometry":{ "shape":"GeofenceGeometry", "documentation":"<p>Contains the geofence geometry details describing the position of the geofence. Can be a circle, a polygon, or a multipolygon.</p>" }, "Status":{ "shape":"String", "documentation":"<p>Identifies the state of the geofence. A geofence will hold one of the following states:</p> <ul> <li> <p> <code>ACTIVE</code> — The geofence has been indexed by the system. </p> </li> <li> <p> <code>PENDING</code> — The geofence is being processed by the system.</p> </li> <li> <p> <code>FAILED</code> — The geofence failed to be indexed by the system.</p> </li> <li> <p> <code>DELETED</code> — The geofence has been deleted from the system index.</p> </li> <li> <p> <code>DELETING</code> — The geofence is being deleted from the system index.</p> </li> </ul>" }, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the geofence was stored in a geofence collection in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code> </p>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the geofence was last updated in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code> </p>" }, "GeofenceProperties":{ "shape":"PropertyMap", "documentation":"<p>User defined properties of the geofence. A property is a key-value pair stored with the geofence and added to any geofence event triggered with that geofence.</p> <p>Format: <code>\"key\" : \"value\"</code> </p>" } }, "documentation":"<p>Contains a list of geofences stored in a given geofence collection.</p> <note> <p>The returned geometry will always match the geometry format used when the geofence was created.</p> </note>" }, "ListGeofenceResponseEntryList":{ "type":"list", "member":{"shape":"ListGeofenceResponseEntry"} }, "ListGeofencesRequest":{ "type":"structure", "required":["CollectionName"], "members":{ "CollectionName":{ "shape":"ResourceName", "documentation":"<p>The name of the geofence collection storing the list of geofences.</p>", "location":"uri", "locationName":"CollectionName" }, "NextToken":{ "shape":"LargeToken", "documentation":"<p>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. </p> <p>Default value: <code>null</code> </p>" }, "MaxResults":{ "shape":"ListGeofencesRequestMaxResultsInteger", "documentation":"<p>An optional limit for the number of geofences returned in a single call. </p> <p>Default value: <code>100</code> </p>" } } }, "ListGeofencesRequestMaxResultsInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ListGeofencesResponse":{ "type":"structure", "required":["Entries"], "members":{ "Entries":{ "shape":"ListGeofenceResponseEntryList", "documentation":"<p>Contains a list of geofences stored in the geofence collection.</p>" }, "NextToken":{ "shape":"LargeToken", "documentation":"<p>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. </p>" } } }, "ListKeysRequest":{ "type":"structure", "members":{ "MaxResults":{ "shape":"ListKeysRequestMaxResultsInteger", "documentation":"<p>An optional limit for the number of resources returned in a single call. </p> <p>Default value: <code>100</code> </p>" }, "NextToken":{ "shape":"Token", "documentation":"<p>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. </p> <p>Default value: <code>null</code> </p>" }, "Filter":{ "shape":"ApiKeyFilter", "documentation":"<p>Optionally filter the list to only <code>Active</code> or <code>Expired</code> API keys.</p>" } } }, "ListKeysRequestMaxResultsInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ListKeysResponse":{ "type":"structure", "required":["Entries"], "members":{ "Entries":{ "shape":"ListKeysResponseEntryList", "documentation":"<p>Contains API key resources in your Amazon Web Services account. Details include API key name, allowed referers and timestamp for when the API key will expire.</p>" }, "NextToken":{ "shape":"Token", "documentation":"<p>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. </p>" } } }, "ListKeysResponseEntry":{ "type":"structure", "required":[ "KeyName", "ExpireTime", "Restrictions", "CreateTime", "UpdateTime" ], "members":{ "KeyName":{ "shape":"ResourceName", "documentation":"<p>The name of the API key resource.</p>" }, "ExpireTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the API key resource will expire, in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>.</p>" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>The optional description for the API key resource.</p>" }, "Restrictions":{"shape":"ApiKeyRestrictions"}, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp of when the API key was created, in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>.</p>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp of when the API key was last updated, in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>.</p>" } }, "documentation":"<p>An API key resource listed in your Amazon Web Services account.</p>" }, "ListKeysResponseEntryList":{ "type":"list", "member":{"shape":"ListKeysResponseEntry"} }, "ListMapsRequest":{ "type":"structure", "members":{ "MaxResults":{ "shape":"ListMapsRequestMaxResultsInteger", "documentation":"<p>An optional limit for the number of resources returned in a single call. </p> <p>Default value: <code>100</code> </p>" }, "NextToken":{ "shape":"Token", "documentation":"<p>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.</p> <p>Default value: <code>null</code> </p>" } } }, "ListMapsRequestMaxResultsInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ListMapsResponse":{ "type":"structure", "required":["Entries"], "members":{ "Entries":{ "shape":"ListMapsResponseEntryList", "documentation":"<p>Contains a list of maps in your Amazon Web Services account</p>" }, "NextToken":{ "shape":"Token", "documentation":"<p>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. </p>" } } }, "ListMapsResponseEntry":{ "type":"structure", "required":[ "MapName", "Description", "DataSource", "CreateTime", "UpdateTime" ], "members":{ "MapName":{ "shape":"ResourceName", "documentation":"<p>The name of the associated map resource.</p>" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>The description for the map resource.</p>" }, "DataSource":{ "shape":"String", "documentation":"<p>Specifies the data provider for the associated map tiles.</p>" }, "PricingPlan":{ "shape":"PricingPlan", "documentation":"<p>No longer used. Always returns <code>RequestBasedUsage</code>.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. Always returns RequestBasedUsage.", "deprecatedSince":"2022-02-01" }, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the map resource was created in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>.</p>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the map resource was last updated in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>.</p>" } }, "documentation":"<p>Contains details of an existing map resource in your Amazon Web Services account.</p>" }, "ListMapsResponseEntryList":{ "type":"list", "member":{"shape":"ListMapsResponseEntry"} }, "ListPlaceIndexesRequest":{ "type":"structure", "members":{ "MaxResults":{ "shape":"ListPlaceIndexesRequestMaxResultsInteger", "documentation":"<p>An optional limit for the maximum number of results returned in a single call.</p> <p>Default value: <code>100</code> </p>" }, "NextToken":{ "shape":"Token", "documentation":"<p>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.</p> <p>Default value: <code>null</code> </p>" } } }, "ListPlaceIndexesRequestMaxResultsInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ListPlaceIndexesResponse":{ "type":"structure", "required":["Entries"], "members":{ "Entries":{ "shape":"ListPlaceIndexesResponseEntryList", "documentation":"<p>Lists the place index resources that exist in your Amazon Web Services account</p>" }, "NextToken":{ "shape":"Token", "documentation":"<p>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.</p>" } } }, "ListPlaceIndexesResponseEntry":{ "type":"structure", "required":[ "IndexName", "Description", "DataSource", "CreateTime", "UpdateTime" ], "members":{ "IndexName":{ "shape":"ResourceName", "documentation":"<p>The name of the place index resource.</p>" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>The optional description for the place index resource.</p>" }, "DataSource":{ "shape":"String", "documentation":"<p>The data provider of geospatial data. Values can be one of the following:</p> <ul> <li> <p> <code>Esri</code> </p> </li> <li> <p> <code>Grab</code> </p> </li> <li> <p> <code>Here</code> </p> </li> </ul> <p>For more information about data providers, see <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/what-is-data-provider.html\">Amazon Location Service data providers</a>.</p>" }, "PricingPlan":{ "shape":"PricingPlan", "documentation":"<p>No longer used. Always returns <code>RequestBasedUsage</code>.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. Always returns RequestBasedUsage.", "deprecatedSince":"2022-02-01" }, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the place index resource was created in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the place index resource was last updated in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" } }, "documentation":"<p>A place index resource listed in your Amazon Web Services account.</p>" }, "ListPlaceIndexesResponseEntryList":{ "type":"list", "member":{"shape":"ListPlaceIndexesResponseEntry"} }, "ListRouteCalculatorsRequest":{ "type":"structure", "members":{ "MaxResults":{ "shape":"ListRouteCalculatorsRequestMaxResultsInteger", "documentation":"<p>An optional maximum number of results returned in a single call.</p> <p>Default Value: <code>100</code> </p>" }, "NextToken":{ "shape":"Token", "documentation":"<p>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.</p> <p>Default Value: <code>null</code> </p>" } } }, "ListRouteCalculatorsRequestMaxResultsInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ListRouteCalculatorsResponse":{ "type":"structure", "required":["Entries"], "members":{ "Entries":{ "shape":"ListRouteCalculatorsResponseEntryList", "documentation":"<p>Lists the route calculator resources that exist in your Amazon Web Services account</p>" }, "NextToken":{ "shape":"Token", "documentation":"<p>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.</p>" } } }, "ListRouteCalculatorsResponseEntry":{ "type":"structure", "required":[ "CalculatorName", "Description", "DataSource", "CreateTime", "UpdateTime" ], "members":{ "CalculatorName":{ "shape":"ResourceName", "documentation":"<p>The name of the route calculator resource.</p>" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>The optional description of the route calculator resource.</p>" }, "DataSource":{ "shape":"String", "documentation":"<p>The data provider of traffic and road network data. Indicates one of the available providers:</p> <ul> <li> <p> <code>Esri</code> </p> </li> <li> <p> <code>Grab</code> </p> </li> <li> <p> <code>Here</code> </p> </li> </ul> <p>For more information about data providers, see <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/what-is-data-provider.html\">Amazon Location Service data providers</a>.</p>" }, "PricingPlan":{ "shape":"PricingPlan", "documentation":"<p>Always returns <code>RequestBasedUsage</code>.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. Always returns RequestBasedUsage.", "deprecatedSince":"2022-02-01" }, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp when the route calculator resource was created in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p> <ul> <li> <p>For example, <code>2020–07-2T12:15:20.000Z+01:00</code> </p> </li> </ul>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp when the route calculator resource was last updated in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p> <ul> <li> <p>For example, <code>2020–07-2T12:15:20.000Z+01:00</code> </p> </li> </ul>" } }, "documentation":"<p>A route calculator resource listed in your Amazon Web Services account.</p>" }, "ListRouteCalculatorsResponseEntryList":{ "type":"list", "member":{"shape":"ListRouteCalculatorsResponseEntry"} }, "ListTagsForResourceRequest":{ "type":"structure", "required":["ResourceArn"], "members":{ "ResourceArn":{ "shape":"Arn", "documentation":"<p>The Amazon Resource Name (ARN) of the resource whose tags you want to retrieve.</p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:resourcetype/ExampleResource</code> </p> </li> </ul>", "location":"uri", "locationName":"ResourceArn" } } }, "ListTagsForResourceResponse":{ "type":"structure", "members":{ "Tags":{ "shape":"TagMap", "documentation":"<p>Tags that have been applied to the specified resource. Tags are mapped from the tag key to the tag value: <code>\"TagKey\" : \"TagValue\"</code>.</p> <ul> <li> <p>Format example: <code>{\"tag1\" : \"value1\", \"tag2\" : \"value2\"} </code> </p> </li> </ul>" } } }, "ListTrackerConsumersRequest":{ "type":"structure", "required":["TrackerName"], "members":{ "TrackerName":{ "shape":"ResourceName", "documentation":"<p>The tracker resource whose associated geofence collections you want to list.</p>", "location":"uri", "locationName":"TrackerName" }, "MaxResults":{ "shape":"ListTrackerConsumersRequestMaxResultsInteger", "documentation":"<p>An optional limit for the number of resources returned in a single call. </p> <p>Default value: <code>100</code> </p>" }, "NextToken":{ "shape":"Token", "documentation":"<p>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. </p> <p>Default value: <code>null</code> </p>" } } }, "ListTrackerConsumersRequestMaxResultsInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ListTrackerConsumersResponse":{ "type":"structure", "required":["ConsumerArns"], "members":{ "ConsumerArns":{ "shape":"ArnList", "documentation":"<p>Contains the list of geofence collection ARNs associated to the tracker resource.</p>" }, "NextToken":{ "shape":"Token", "documentation":"<p>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. </p>" } } }, "ListTrackersRequest":{ "type":"structure", "members":{ "MaxResults":{ "shape":"ListTrackersRequestMaxResultsInteger", "documentation":"<p>An optional limit for the number of resources returned in a single call. </p> <p>Default value: <code>100</code> </p>" }, "NextToken":{ "shape":"Token", "documentation":"<p>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. </p> <p>Default value: <code>null</code> </p>" } } }, "ListTrackersRequestMaxResultsInteger":{ "type":"integer", "box":true, "max":100, "min":1 }, "ListTrackersResponse":{ "type":"structure", "required":["Entries"], "members":{ "Entries":{ "shape":"ListTrackersResponseEntryList", "documentation":"<p>Contains tracker resources in your Amazon Web Services account. Details include tracker name, description and timestamps for when the tracker was created and last updated.</p>" }, "NextToken":{ "shape":"Token", "documentation":"<p>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. </p>" } } }, "ListTrackersResponseEntry":{ "type":"structure", "required":[ "TrackerName", "Description", "CreateTime", "UpdateTime" ], "members":{ "TrackerName":{ "shape":"ResourceName", "documentation":"<p>The name of the tracker resource.</p>" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>The description for the tracker resource.</p>" }, "PricingPlan":{ "shape":"PricingPlan", "documentation":"<p>Always returns <code>RequestBasedUsage</code>.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. Always returns RequestBasedUsage.", "deprecatedSince":"2022-02-01" }, "PricingPlanDataSource":{ "shape":"String", "documentation":"<p>No longer used. Always returns an empty string.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. Unused.", "deprecatedSince":"2022-02-01" }, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the tracker resource was created in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp at which the device's position was determined. Uses <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" } }, "documentation":"<p>Contains the tracker resource details.</p>" }, "ListTrackersResponseEntryList":{ "type":"list", "member":{"shape":"ListTrackersResponseEntry"} }, "LteCellDetails":{ "type":"structure", "required":[ "CellId", "Mcc", "Mnc" ], "members":{ "CellId":{ "shape":"EutranCellId", "documentation":"<p>The E-UTRAN Cell Identifier (ECI).</p>" }, "Mcc":{ "shape":"LteCellDetailsMccInteger", "documentation":"<p>The Mobile Country Code (MCC).</p>" }, "Mnc":{ "shape":"LteCellDetailsMncInteger", "documentation":"<p>The Mobile Network Code (MNC)</p>" }, "LocalId":{ "shape":"LteLocalId", "documentation":"<p>The LTE local identification information (local ID).</p>" }, "NetworkMeasurements":{ "shape":"LteCellDetailsNetworkMeasurementsList", "documentation":"<p>The network measurements.</p>" }, "TimingAdvance":{ "shape":"LteCellDetailsTimingAdvanceInteger", "documentation":"<p>Timing Advance (TA).</p>" }, "NrCapable":{ "shape":"Boolean", "documentation":"<p>Indicates whether the LTE object is capable of supporting NR (new radio).</p>" }, "Rsrp":{ "shape":"Rsrp", "documentation":"<p>Signal power of the reference signal received, measured in decibel-milliwatts (dBm).</p>" }, "Rsrq":{ "shape":"Rsrq", "documentation":"<p>Signal quality of the reference Signal received, measured in decibels (dB).</p>" }, "Tac":{ "shape":"LteCellDetailsTacInteger", "documentation":"<p>LTE Tracking Area Code (TAC).</p>" } }, "documentation":"<p>Details about the Long-Term Evolution (LTE) network.</p>" }, "LteCellDetailsMccInteger":{ "type":"integer", "box":true, "max":999, "min":200 }, "LteCellDetailsMncInteger":{ "type":"integer", "box":true, "max":999, "min":0 }, "LteCellDetailsNetworkMeasurementsList":{ "type":"list", "member":{"shape":"LteNetworkMeasurements"}, "max":32, "min":1 }, "LteCellDetailsTacInteger":{ "type":"integer", "box":true, "max":65535, "min":0 }, "LteCellDetailsTimingAdvanceInteger":{ "type":"integer", "box":true, "max":1282, "min":0 }, "LteLocalId":{ "type":"structure", "required":[ "Earfcn", "Pci" ], "members":{ "Earfcn":{ "shape":"Earfcn", "documentation":"<p>E-UTRA (Evolved Universal Terrestrial Radio Access) absolute radio frequency channel number (EARFCN).</p>" }, "Pci":{ "shape":"Pci", "documentation":"<p>Physical Cell ID (PCI).</p>" } }, "documentation":"<p>LTE local identification information (local ID).</p>" }, "LteNetworkMeasurements":{ "type":"structure", "required":[ "Earfcn", "CellId", "Pci" ], "members":{ "Earfcn":{ "shape":"Earfcn", "documentation":"<p>E-UTRA (Evolved Universal Terrestrial Radio Access) absolute radio frequency channel number (EARFCN).</p>" }, "CellId":{ "shape":"EutranCellId", "documentation":"<p>E-UTRAN Cell Identifier (ECI).</p>" }, "Pci":{ "shape":"Pci", "documentation":"<p>Physical Cell ID (PCI).</p>" }, "Rsrp":{ "shape":"Rsrp", "documentation":"<p>Signal power of the reference signal received, measured in dBm (decibel-milliwatts).</p>" }, "Rsrq":{ "shape":"Rsrq", "documentation":"<p>Signal quality of the reference Signal received, measured in decibels (dB).</p>" } }, "documentation":"<p>LTE network measurements.</p>" }, "MapConfiguration":{ "type":"structure", "required":["Style"], "members":{ "Style":{ "shape":"MapStyle", "documentation":"<p>Specifies the map style selected from an available data provider.</p> <p>Valid <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/esri.html\">Esri map styles</a>:</p> <ul> <li> <p> <code>VectorEsriDarkGrayCanvas</code> – 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. </p> </li> <li> <p> <code>RasterEsriImagery</code> – 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. </p> </li> <li> <p> <code>VectorEsriLightGrayCanvas</code> – 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. </p> </li> <li> <p> <code>VectorEsriTopographic</code> – The Esri Light map style, which provides a detailed vector basemap with a classic Esri map style.</p> </li> <li> <p> <code>VectorEsriStreets</code> – The Esri Street 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.</p> </li> <li> <p> <code>VectorEsriNavigation</code> – The Esri 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.</p> </li> </ul> <p>Valid <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/HERE.html\">HERE Technologies map styles</a>:</p> <ul> <li> <p> <code>VectorHereContrast</code> – The HERE Contrast (Berlin) map style is a high contrast detailed base map of the world that blends 3D and 2D rendering.</p> <note> <p>The <code>VectorHereContrast</code> style has been renamed from <code>VectorHereBerlin</code>. <code>VectorHereBerlin</code> has been deprecated, but will continue to work in applications that use it.</p> </note> </li> <li> <p> <code>VectorHereExplore</code> – 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.</p> </li> <li> <p> <code>VectorHereExploreTruck</code> – 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.</p> </li> <li> <p> <code>RasterHereExploreSatellite</code> – A global map containing high resolution satellite imagery.</p> </li> <li> <p> <code>HybridHereExploreSatellite</code> – A global map displaying the road network, street names, and city labels over satellite imagery. This style will automatically retrieve both raster and vector tiles, and your charges will be based on total tiles retrieved.</p> <note> <p>Hybrid styles use both vector and raster tiles when rendering the map that you see. This means that more tiles are retrieved than when using either vector or raster tiles alone. Your charges will include all tiles retrieved.</p> </note> </li> </ul> <p>Valid <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/grab.html\">GrabMaps map styles</a>:</p> <ul> <li> <p> <code>VectorGrabStandardLight</code> – The Grab Standard Light map style provides a basemap with detailed land use coloring, area names, roads, landmarks, and points of interest covering Southeast Asia.</p> </li> <li> <p> <code>VectorGrabStandardDark</code> – The Grab Standard Dark map style provides a dark variation of the standard basemap covering Southeast Asia.</p> </li> </ul> <note> <p>Grab provides maps only for countries in Southeast Asia, and is only available in the Asia Pacific (Singapore) Region (<code>ap-southeast-1</code>). For more information, see <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/grab.html#grab-coverage-area\">GrabMaps countries and area covered</a>.</p> </note> <p>Valid <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/open-data.html\">Open Data map styles</a>:</p> <ul> <li> <p> <code>VectorOpenDataStandardLight</code> – The Open Data Standard Light map style provides a detailed basemap for the world suitable for website and mobile application use. The map includes highways major roads, minor roads, railways, water features, cities, parks, landmarks, building footprints, and administrative boundaries.</p> </li> <li> <p> <code>VectorOpenDataStandardDark</code> – Open Data Standard Dark is a dark-themed map style that provides a detailed basemap for the world suitable for website and mobile application use. The map includes highways major roads, minor roads, railways, water features, cities, parks, landmarks, building footprints, and administrative boundaries.</p> </li> <li> <p> <code>VectorOpenDataVisualizationLight</code> – The Open Data Visualization Light map style is a light-themed style with muted colors and fewer features that aids in understanding overlaid data.</p> </li> <li> <p> <code>VectorOpenDataVisualizationDark</code> – The Open Data Visualization Dark map style is a dark-themed style with muted colors and fewer features that aids in understanding overlaid data.</p> </li> </ul>" }, "PoliticalView":{ "shape":"CountryCode3", "documentation":"<p>Specifies the political view for the style. Leave unset to not use a political view, or, for styles that support specific political views, you can choose a view, such as <code>IND</code> for the Indian view.</p> <p>Default is unset.</p> <note> <p>Not all map resources or styles support political view styles. See <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/map-concepts.html#political-views\">Political views</a> for more information.</p> </note>" }, "CustomLayers":{ "shape":"CustomLayerList", "documentation":"<p>Specifies the custom layers for the style. Leave unset to not enable any custom layer, or, for styles that support custom layers, you can enable layer(s), such as POI layer for the VectorEsriNavigation style. Default is <code>unset</code>.</p> <note> <p>Not all map resources or styles support custom layers. See Custom Layers for more information.</p> </note>" } }, "documentation":"<p>Specifies the map tile style selected from an available provider.</p>" }, "MapConfigurationUpdate":{ "type":"structure", "members":{ "PoliticalView":{ "shape":"CountryCode3OrEmpty", "documentation":"<p>Specifies the political view for the style. Set to an empty string to not use a political view, or, for styles that support specific political views, you can choose a view, such as <code>IND</code> for the Indian view.</p> <note> <p>Not all map resources or styles support political view styles. See <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/map-concepts.html#political-views\">Political views</a> for more information.</p> </note>" }, "CustomLayers":{ "shape":"CustomLayerList", "documentation":"<p>Specifies the custom layers for the style. Leave unset to not enable any custom layer, or, for styles that support custom layers, you can enable layer(s), such as POI layer for the VectorEsriNavigation style. Default is <code>unset</code>.</p> <note> <p>Not all map resources or styles support custom layers. See Custom Layers for more information.</p> </note>" } }, "documentation":"<p>Specifies the political view for the style.</p>" }, "MapStyle":{ "type":"string", "max":100, "min":1, "pattern":"[-._\\w]+" }, "NearestDistance":{ "type":"double", "min":0 }, "OptimizationMode":{ "type":"string", "enum":[ "FastestRoute", "ShortestRoute" ] }, "Pci":{ "type":"integer", "max":503, "min":0 }, "Place":{ "type":"structure", "required":["Geometry"], "members":{ "Label":{ "shape":"SensitiveString", "documentation":"<p>The full name and address of the point of interest such as a city, region, or country. For example, <code>123 Any Street, Any Town, USA</code>.</p>" }, "Geometry":{"shape":"PlaceGeometry"}, "AddressNumber":{ "shape":"SensitiveString", "documentation":"<p>The numerical portion of an address, such as a building number. </p>" }, "Street":{ "shape":"SensitiveString", "documentation":"<p>The name for a street or a road to identify a location. For example, <code>Main Street</code>.</p>" }, "Neighborhood":{ "shape":"SensitiveString", "documentation":"<p>The name of a community district. For example, <code>Downtown</code>.</p>" }, "Municipality":{ "shape":"SensitiveString", "documentation":"<p>A name for a local area, such as a city or town name. For example, <code>Toronto</code>.</p>" }, "SubRegion":{ "shape":"SensitiveString", "documentation":"<p>A county, or an area that's part of a larger region. For example, <code>Metro Vancouver</code>.</p>" }, "Region":{ "shape":"SensitiveString", "documentation":"<p>A name for an area or geographical division, such as a province or state name. For example, <code>British Columbia</code>.</p>" }, "Country":{ "shape":"SensitiveString", "documentation":"<p>A country/region specified using <a href=\"https://www.iso.org/iso-3166-country-codes.html\">ISO 3166</a> 3-digit country/region code. For example, <code>CAN</code>.</p>" }, "PostalCode":{ "shape":"SensitiveString", "documentation":"<p>A group of numbers and letters in a country-specific format, which accompanies the address for the purpose of identifying a location. </p>" }, "Interpolated":{ "shape":"SensitiveBoolean", "documentation":"<p> <code>True</code> if the result is interpolated from other known places.</p> <p> <code>False</code> if the Place is a known place.</p> <p>Not returned when the partner does not provide the information.</p> <p>For example, returns <code>False</code> for an address location that is found in the partner data, but returns <code>True</code> if an address does not exist in the partner data and its location is calculated by interpolating between other known addresses. </p>" }, "TimeZone":{ "shape":"TimeZone", "documentation":"<p>The time zone in which the <code>Place</code> is located. Returned only when using HERE or Grab as the selected partner.</p>" }, "UnitType":{ "shape":"SensitiveString", "documentation":"<p>For addresses with a <code>UnitNumber</code>, the type of unit. For example, <code>Apartment</code>.</p> <note> <p>Returned only for a place index that uses Esri as a data provider.</p> </note>" }, "UnitNumber":{ "shape":"SensitiveString", "documentation":"<p>For addresses with multiple units, the unit identifier. Can include numbers and letters, for example <code>3B</code> or <code>Unit 123</code>.</p> <note> <p>Returned only for a place index that uses Esri or Grab as a data provider. Is not returned for <code>SearchPlaceIndexForPosition</code>.</p> </note>" }, "Categories":{ "shape":"PlaceCategoryList", "documentation":"<p>The Amazon Location categories that describe this Place.</p> <p>For more information about using categories, including a list of Amazon Location categories, see <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/category-filtering.html\">Categories and filtering</a>, in the <i>Amazon Location Service developer guide</i>.</p>" }, "SupplementalCategories":{ "shape":"PlaceSupplementalCategoryList", "documentation":"<p>Categories from the data provider that describe the Place that are not mapped to any Amazon Location categories.</p>" }, "SubMunicipality":{ "shape":"SensitiveString", "documentation":"<p>An area that's part of a larger municipality. For example, <code>Blissville </code> is a submunicipality in the Queen County in New York.</p> <note> <p>This property supported by Esri and OpenData. The Esri property is <code>district</code>, and the OpenData property is <code>borough</code>.</p> </note>" } }, "documentation":"<p>Contains details about addresses or points of interest that match the search criteria.</p> <p>Not all details are included with all responses. Some details may only be returned by specific data partners.</p>" }, "PlaceCategory":{ "type":"string", "max":35, "min":0, "sensitive":true }, "PlaceCategoryList":{ "type":"list", "member":{"shape":"PlaceCategory"}, "max":10, "min":1 }, "PlaceGeometry":{ "type":"structure", "members":{ "Point":{ "shape":"Position", "documentation":"<p>A single point geometry specifies a location for a Place using <a href=\"https://gisgeography.com/wgs84-world-geodetic-system/\">WGS 84</a> coordinates:</p> <ul> <li> <p> <i>x</i> — Specifies the x coordinate or longitude. </p> </li> <li> <p> <i>y</i> — Specifies the y coordinate or latitude. </p> </li> </ul>" } }, "documentation":"<p>Places uses a point geometry to specify a location or a Place.</p>" }, "PlaceId":{ "type":"string", "sensitive":true }, "PlaceIndexSearchResultLimit":{ "type":"integer", "box":true, "max":50, "min":1 }, "PlaceSupplementalCategory":{ "type":"string", "max":35, "min":0, "sensitive":true }, "PlaceSupplementalCategoryList":{ "type":"list", "member":{"shape":"PlaceSupplementalCategory"}, "max":10, "min":1 }, "Position":{ "type":"list", "member":{"shape":"Double"}, "max":2, "min":2, "sensitive":true }, "PositionFiltering":{ "type":"string", "enum":[ "TimeBased", "DistanceBased", "AccuracyBased" ] }, "PositionPropertyMap":{ "type":"map", "key":{"shape":"PositionPropertyMapKeyString"}, "value":{"shape":"PositionPropertyMapValueString"}, "max":4, "min":0, "sensitive":true }, "PositionPropertyMapKeyString":{ "type":"string", "max":20, "min":1 }, "PositionPropertyMapValueString":{ "type":"string", "max":150, "min":1 }, "PositionalAccuracy":{ "type":"structure", "required":["Horizontal"], "members":{ "Horizontal":{ "shape":"PositionalAccuracyHorizontalDouble", "documentation":"<p>Estimated maximum distance, in meters, between the measured position and the true position of a device, along the Earth's surface.</p>" } }, "documentation":"<p>Defines the level of certainty of the position.</p>" }, "PositionalAccuracyHorizontalDouble":{ "type":"double", "box":true, "max":10000000, "min":0, "sensitive":true }, "PricingPlan":{ "type":"string", "enum":[ "RequestBasedUsage", "MobileAssetTracking", "MobileAssetManagement" ] }, "PropertyMap":{ "type":"map", "key":{"shape":"PropertyMapKeyString"}, "value":{"shape":"PropertyMapValueString"}, "max":3, "min":0, "sensitive":true }, "PropertyMapKeyString":{ "type":"string", "max":20, "min":1 }, "PropertyMapValueString":{ "type":"string", "max":40, "min":1 }, "PutGeofenceRequest":{ "type":"structure", "required":[ "CollectionName", "GeofenceId", "Geometry" ], "members":{ "CollectionName":{ "shape":"ResourceName", "documentation":"<p>The geofence collection to store the geofence in.</p>", "location":"uri", "locationName":"CollectionName" }, "GeofenceId":{ "shape":"Id", "documentation":"<p>An identifier for the geofence. For example, <code>ExampleGeofence-1</code>.</p>", "location":"uri", "locationName":"GeofenceId" }, "Geometry":{ "shape":"GeofenceGeometry", "documentation":"<p>Contains the details to specify the position of the geofence. Can be a circle, a polygon, or a multipolygon. <code>Polygon</code> and <code>MultiPolygon</code> geometries can be defined using their respective parameters, or encoded in Geobuf format using the <code>Geobuf</code> parameter. Including multiple geometry types in the same request will return a validation error.</p> <note> <p>The geofence <code>Polygon</code> and <code>MultiPolygon</code> formats support a maximum of 1,000 total vertices. The <code>Geobuf</code> format supports a maximum of 100,000 vertices.</p> </note>" }, "GeofenceProperties":{ "shape":"PropertyMap", "documentation":"<p>Associates one of more properties with the geofence. A property is a key-value pair stored with the geofence and added to any geofence event triggered with that geofence.</p> <p>Format: <code>\"key\" : \"value\"</code> </p>" } } }, "PutGeofenceResponse":{ "type":"structure", "required":[ "GeofenceId", "CreateTime", "UpdateTime" ], "members":{ "GeofenceId":{ "shape":"Id", "documentation":"<p>The geofence identifier entered in the request.</p>" }, "CreateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the geofence was created in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code> </p>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the geofence was last updated in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code> </p>" } } }, "RefererPattern":{ "type":"string", "max":253, "min":0, "pattern":"([\\w!$&()*+,./:;=?@\\x{60}-]|%([\\dA-Fa-f]{2}|[\\dA-Fa-f]?\\*))+", "sensitive":true }, "ResourceDescription":{ "type":"string", "max":1000, "min":0 }, "ResourceName":{ "type":"string", "max":100, "min":1, "pattern":"[-._\\w]+" }, "ResourceNotFoundException":{ "type":"structure", "required":["Message"], "members":{ "Message":{ "shape":"String", "locationName":"message" } }, "documentation":"<p>The resource that you've entered was not found in your AWS account.</p>", "error":{ "httpStatusCode":404, "senderFault":true }, "exception":true }, "RouteMatrix":{ "type":"list", "member":{"shape":"RouteMatrixRow"} }, "RouteMatrixEntry":{ "type":"structure", "members":{ "Distance":{ "shape":"RouteMatrixEntryDistanceDouble", "documentation":"<p>The total distance of travel for the route.</p>" }, "DurationSeconds":{ "shape":"RouteMatrixEntryDurationSecondsDouble", "documentation":"<p>The expected duration of travel for the route.</p>" }, "Error":{ "shape":"RouteMatrixEntryError", "documentation":"<p>An error corresponding to the calculation of a route between the <code>DeparturePosition</code> and <code>DestinationPosition</code>.</p>" } }, "documentation":"<p>The result for the calculated route of one <code>DeparturePosition</code> <code>DestinationPosition</code> pair.</p>" }, "RouteMatrixEntryDistanceDouble":{ "type":"double", "box":true, "min":0, "sensitive":true }, "RouteMatrixEntryDurationSecondsDouble":{ "type":"double", "box":true, "min":0, "sensitive":true }, "RouteMatrixEntryError":{ "type":"structure", "required":["Code"], "members":{ "Code":{ "shape":"RouteMatrixErrorCode", "documentation":"<p>The type of error which occurred for the route calculation.</p>" }, "Message":{ "shape":"String", "documentation":"<p>A message about the error that occurred for the route calculation.</p>" } }, "documentation":"<p>An error corresponding to the calculation of a route between the <code>DeparturePosition</code> and <code>DestinationPosition</code>.</p> <p>The error code can be one of the following:</p> <ul> <li> <p> <code>RouteNotFound</code> - Unable to find a valid route with the given parameters.</p> </li> </ul> <ul> <li> <p> <code>RouteTooLong</code> - Route calculation went beyond the maximum size of a route and was terminated before completion.</p> </li> </ul> <ul> <li> <p> <code>PositionsNotFound</code> - One or more of the input positions were not found on the route network.</p> </li> </ul> <ul> <li> <p> <code>DestinationPositionNotFound</code> - The destination position was not found on the route network.</p> </li> </ul> <ul> <li> <p> <code>DeparturePositionNotFound</code> - The departure position was not found on the route network.</p> </li> </ul> <ul> <li> <p> <code>OtherValidationError</code> - The given inputs were not valid or a route was not found. More information is given in the error <code>Message</code> </p> </li> </ul>" }, "RouteMatrixErrorCode":{ "type":"string", "enum":[ "RouteNotFound", "RouteTooLong", "PositionsNotFound", "DestinationPositionNotFound", "DeparturePositionNotFound", "OtherValidationError" ] }, "RouteMatrixRow":{ "type":"list", "member":{"shape":"RouteMatrixEntry"} }, "Rsrp":{ "type":"integer", "box":true, "max":-44, "min":-140 }, "Rsrq":{ "type":"float", "box":true, "max":-3, "min":-19.5 }, "SearchForPositionResult":{ "type":"structure", "required":[ "Place", "Distance" ], "members":{ "Place":{ "shape":"Place", "documentation":"<p>Details about the search result, such as its address and position.</p>" }, "Distance":{ "shape":"SearchForPositionResultDistanceDouble", "documentation":"<p>The distance in meters of a great-circle arc between the query position and the result.</p> <note> <p>A great-circle arc is the shortest path on a sphere, in this case the Earth. This returns the shortest distance between two locations.</p> </note>" }, "PlaceId":{ "shape":"PlaceId", "documentation":"<p>The unique identifier of the place. You can use this with the <code>GetPlace</code> operation to find the place again later.</p> <note> <p>For <code>SearchPlaceIndexForPosition</code> operations, the <code>PlaceId</code> is returned only by place indexes that use HERE or Grab as a data provider.</p> </note>" } }, "documentation":"<p>Contains a search result from a position search query that is run on a place index resource.</p>" }, "SearchForPositionResultDistanceDouble":{ "type":"double", "box":true, "min":0, "sensitive":true }, "SearchForPositionResultList":{ "type":"list", "member":{"shape":"SearchForPositionResult"} }, "SearchForSuggestionsResult":{ "type":"structure", "required":["Text"], "members":{ "Text":{ "shape":"SensitiveString", "documentation":"<p>The text of the place suggestion, typically formatted as an address string.</p>" }, "PlaceId":{ "shape":"PlaceId", "documentation":"<p>The unique identifier of the Place. You can use this with the <code>GetPlace</code> operation to find the place again later, or to get full information for the Place.</p> <p>The <code>GetPlace</code> request must use the same <code>PlaceIndex</code> resource as the <code>SearchPlaceIndexForSuggestions</code> that generated the Place ID.</p> <note> <p>For <code>SearchPlaceIndexForSuggestions</code> operations, the <code>PlaceId</code> is returned by place indexes that use Esri, Grab, or HERE as data providers.</p> </note>" }, "Categories":{ "shape":"PlaceCategoryList", "documentation":"<p>The Amazon Location categories that describe the Place.</p> <p>For more information about using categories, including a list of Amazon Location categories, see <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/category-filtering.html\">Categories and filtering</a>, in the <i>Amazon Location Service developer guide</i>.</p>" }, "SupplementalCategories":{ "shape":"PlaceSupplementalCategoryList", "documentation":"<p>Categories from the data provider that describe the Place that are not mapped to any Amazon Location categories.</p>" } }, "documentation":"<p>Contains a place suggestion resulting from a place suggestion query that is run on a place index resource.</p>" }, "SearchForSuggestionsResultList":{ "type":"list", "member":{"shape":"SearchForSuggestionsResult"} }, "SearchForTextResult":{ "type":"structure", "required":["Place"], "members":{ "Place":{ "shape":"Place", "documentation":"<p>Details about the search result, such as its address and position.</p>" }, "Distance":{ "shape":"SearchForTextResultDistanceDouble", "documentation":"<p>The distance in meters of a great-circle arc between the bias position specified and the result. <code>Distance</code> will be returned only if a bias position was specified in the query.</p> <note> <p>A great-circle arc is the shortest path on a sphere, in this case the Earth. This returns the shortest distance between two locations.</p> </note>" }, "Relevance":{ "shape":"SearchForTextResultRelevanceDouble", "documentation":"<p>The relative confidence in the match for a result among the results returned. For example, if more fields for an address match (including house number, street, city, country/region, and postal code), the relevance score is closer to 1.</p> <p>Returned only when the partner selected is Esri or Grab.</p>" }, "PlaceId":{ "shape":"PlaceId", "documentation":"<p>The unique identifier of the place. You can use this with the <code>GetPlace</code> operation to find the place again later.</p> <note> <p>For <code>SearchPlaceIndexForText</code> operations, the <code>PlaceId</code> is returned only by place indexes that use HERE or Grab as a data provider.</p> </note>" } }, "documentation":"<p>Contains a search result from a text search query that is run on a place index resource.</p>" }, "SearchForTextResultDistanceDouble":{ "type":"double", "box":true, "min":0, "sensitive":true }, "SearchForTextResultList":{ "type":"list", "member":{"shape":"SearchForTextResult"} }, "SearchForTextResultRelevanceDouble":{ "type":"double", "box":true, "max":1, "min":0, "sensitive":true }, "SearchPlaceIndexForPositionRequest":{ "type":"structure", "required":[ "IndexName", "Position" ], "members":{ "IndexName":{ "shape":"ResourceName", "documentation":"<p>The name of the place index resource you want to use for the search.</p>", "location":"uri", "locationName":"IndexName" }, "Position":{ "shape":"Position", "documentation":"<p>Specifies the longitude and latitude of the position to query.</p> <p> 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.</p> <p>For example, <code>[-123.1174, 49.2847]</code> represents a position with longitude <code>-123.1174</code> and latitude <code>49.2847</code>.</p>" }, "MaxResults":{ "shape":"PlaceIndexSearchResultLimit", "documentation":"<p>An optional parameter. The maximum number of results returned per request.</p> <p>Default value: <code>50</code> </p>" }, "Language":{ "shape":"LanguageTag", "documentation":"<p>The preferred language used to return results. The value must be a valid <a href=\"https://tools.ietf.org/search/bcp47\">BCP 47</a> language tag, for example, <code>en</code> for English.</p> <p>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.</p> <p>For an example, we'll use the Greek language. You search for a location around Athens, Greece, with the <code>language</code> parameter set to <code>en</code>. The <code>city</code> in the results will most likely be returned as <code>Athens</code>.</p> <p>If you set the <code>language</code> parameter to <code>el</code>, for Greek, then the <code>city</code> in the results will more likely be returned as <code>Αθήνα</code>.</p> <p>If the data provider does not have a value for Greek, the result will be in a language that the provider does support.</p>" }, "Key":{ "shape":"ApiKey", "documentation":"<p>The optional <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/using-apikeys.html\">API key</a> to authorize the request.</p>", "location":"querystring", "locationName":"key" } } }, "SearchPlaceIndexForPositionResponse":{ "type":"structure", "required":[ "Summary", "Results" ], "members":{ "Summary":{ "shape":"SearchPlaceIndexForPositionSummary", "documentation":"<p>Contains a summary of the request. Echoes the input values for <code>Position</code>, <code>Language</code>, <code>MaxResults</code>, and the <code>DataSource</code> of the place index. </p>" }, "Results":{ "shape":"SearchForPositionResultList", "documentation":"<p>Returns a list of Places closest to the specified position. Each result contains additional information about the Places returned.</p>" } } }, "SearchPlaceIndexForPositionSummary":{ "type":"structure", "required":[ "Position", "DataSource" ], "members":{ "Position":{ "shape":"Position", "documentation":"<p>The position specified in the request.</p>" }, "MaxResults":{ "shape":"PlaceIndexSearchResultLimit", "documentation":"<p>Contains the optional result count limit that is specified in the request.</p> <p>Default value: <code>50</code> </p>" }, "DataSource":{ "shape":"String", "documentation":"<p>The geospatial data provider attached to the place index resource specified in the request. Values can be one of the following:</p> <ul> <li> <p>Esri</p> </li> <li> <p>Grab</p> </li> <li> <p>Here</p> </li> </ul> <p>For more information about data providers, see <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/what-is-data-provider.html\">Amazon Location Service data providers</a>.</p>" }, "Language":{ "shape":"LanguageTag", "documentation":"<p>The preferred language used to return results. Matches the language in the request. The value is a valid <a href=\"https://tools.ietf.org/search/bcp47\">BCP 47</a> language tag, for example, <code>en</code> for English.</p>" } }, "documentation":"<p>A summary of the request sent by using <code>SearchPlaceIndexForPosition</code>.</p>" }, "SearchPlaceIndexForSuggestionsRequest":{ "type":"structure", "required":[ "IndexName", "Text" ], "members":{ "IndexName":{ "shape":"ResourceName", "documentation":"<p>The name of the place index resource you want to use for the search.</p>", "location":"uri", "locationName":"IndexName" }, "Text":{ "shape":"SearchPlaceIndexForSuggestionsRequestTextString", "documentation":"<p>The free-form partial text to use to generate place suggestions. For example, <code>eiffel tow</code>.</p>" }, "BiasPosition":{ "shape":"Position", "documentation":"<p>An optional parameter that indicates a preference for place suggestions that are closer to a specified position.</p> <p> If provided, 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.</p> <p>For example, <code>[-123.1174, 49.2847]</code> represents the position with longitude <code>-123.1174</code> and latitude <code>49.2847</code>.</p> <note> <p> <code>BiasPosition</code> and <code>FilterBBox</code> are mutually exclusive. Specifying both options results in an error. </p> </note>" }, "FilterBBox":{ "shape":"BoundingBox", "documentation":"<p>An optional parameter that limits the search results by returning only suggestions within a specified bounding box.</p> <p> If provided, this parameter must contain a total of four consecutive numbers in two pairs. The first pair of numbers represents the X and Y coordinates (longitude and latitude, respectively) of the southwest corner of the bounding box; the second pair of numbers represents the X and Y coordinates (longitude and latitude, respectively) of the northeast corner of the bounding box.</p> <p>For example, <code>[-12.7935, -37.4835, -12.0684, -36.9542]</code> represents a bounding box where the southwest corner has longitude <code>-12.7935</code> and latitude <code>-37.4835</code>, and the northeast corner has longitude <code>-12.0684</code> and latitude <code>-36.9542</code>.</p> <note> <p> <code>FilterBBox</code> and <code>BiasPosition</code> are mutually exclusive. Specifying both options results in an error. </p> </note>" }, "FilterCountries":{ "shape":"CountryCodeList", "documentation":"<p>An optional parameter that limits the search results by returning only suggestions within the provided list of countries.</p> <ul> <li> <p>Use the <a href=\"https://www.iso.org/iso-3166-country-codes.html\">ISO 3166</a> 3-digit country code. For example, Australia uses three upper-case characters: <code>AUS</code>.</p> </li> </ul>" }, "MaxResults":{ "shape":"SearchPlaceIndexForSuggestionsRequestMaxResultsInteger", "documentation":"<p>An optional parameter. The maximum number of results returned per request. </p> <p>The default: <code>5</code> </p>" }, "Language":{ "shape":"LanguageTag", "documentation":"<p>The preferred language used to return results. The value must be a valid <a href=\"https://tools.ietf.org/search/bcp47\">BCP 47</a> language tag, for example, <code>en</code> for English.</p> <p>This setting affects the languages used in the results. If no language is specified, or not supported for a particular result, the partner automatically chooses a language for the result.</p> <p>For an example, we'll use the Greek language. You search for <code>Athens, Gr</code> to get suggestions with the <code>language</code> parameter set to <code>en</code>. The results found will most likely be returned as <code>Athens, Greece</code>.</p> <p>If you set the <code>language</code> parameter to <code>el</code>, for Greek, then the result found will more likely be returned as <code>Αθήνα, Ελλάδα</code>.</p> <p>If the data provider does not have a value for Greek, the result will be in a language that the provider does support.</p>" }, "FilterCategories":{ "shape":"FilterPlaceCategoryList", "documentation":"<p>A list of one or more Amazon Location categories to filter the returned places. If you include more than one category, the results will include results that match <i>any</i> of the categories listed.</p> <p>For more information about using categories, including a list of Amazon Location categories, see <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/category-filtering.html\">Categories and filtering</a>, in the <i>Amazon Location Service developer guide</i>.</p>" }, "Key":{ "shape":"ApiKey", "documentation":"<p>The optional <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/using-apikeys.html\">API key</a> to authorize the request.</p>", "location":"querystring", "locationName":"key" } } }, "SearchPlaceIndexForSuggestionsRequestMaxResultsInteger":{ "type":"integer", "box":true, "max":15, "min":1 }, "SearchPlaceIndexForSuggestionsRequestTextString":{ "type":"string", "max":200, "min":1, "sensitive":true }, "SearchPlaceIndexForSuggestionsResponse":{ "type":"structure", "required":[ "Summary", "Results" ], "members":{ "Summary":{ "shape":"SearchPlaceIndexForSuggestionsSummary", "documentation":"<p>Contains a summary of the request. Echoes the input values for <code>BiasPosition</code>, <code>FilterBBox</code>, <code>FilterCountries</code>, <code>Language</code>, <code>MaxResults</code>, and <code>Text</code>. Also includes the <code>DataSource</code> of the place index. </p>" }, "Results":{ "shape":"SearchForSuggestionsResultList", "documentation":"<p>A list of place suggestions that best match the search text.</p>" } } }, "SearchPlaceIndexForSuggestionsSummary":{ "type":"structure", "required":[ "Text", "DataSource" ], "members":{ "Text":{ "shape":"SensitiveString", "documentation":"<p>The free-form partial text input specified in the request.</p>" }, "BiasPosition":{ "shape":"Position", "documentation":"<p>Contains the coordinates for the optional bias position specified in the request.</p> <p>This parameter contains a pair of numbers. The first number represents the X coordinate, or longitude; the second number represents the Y coordinate, or latitude.</p> <p>For example, <code>[-123.1174, 49.2847]</code> represents the position with longitude <code>-123.1174</code> and latitude <code>49.2847</code>.</p>" }, "FilterBBox":{ "shape":"BoundingBox", "documentation":"<p>Contains the coordinates for the optional bounding box specified in the request.</p>" }, "FilterCountries":{ "shape":"CountryCodeList", "documentation":"<p>Contains the optional country filter specified in the request.</p>" }, "MaxResults":{ "shape":"Integer", "documentation":"<p>Contains the optional result count limit specified in the request.</p>" }, "DataSource":{ "shape":"String", "documentation":"<p>The geospatial data provider attached to the place index resource specified in the request. Values can be one of the following:</p> <ul> <li> <p>Esri</p> </li> <li> <p>Grab</p> </li> <li> <p>Here</p> </li> </ul> <p>For more information about data providers, see <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/what-is-data-provider.html\">Amazon Location Service data providers</a>.</p>" }, "Language":{ "shape":"LanguageTag", "documentation":"<p>The preferred language used to return results. Matches the language in the request. The value is a valid <a href=\"https://tools.ietf.org/search/bcp47\">BCP 47</a> language tag, for example, <code>en</code> for English.</p>" }, "FilterCategories":{ "shape":"FilterPlaceCategoryList", "documentation":"<p>The optional category filter specified in the request.</p>" } }, "documentation":"<p>A summary of the request sent by using <code>SearchPlaceIndexForSuggestions</code>.</p>" }, "SearchPlaceIndexForTextRequest":{ "type":"structure", "required":[ "IndexName", "Text" ], "members":{ "IndexName":{ "shape":"ResourceName", "documentation":"<p>The name of the place index resource you want to use for the search.</p>", "location":"uri", "locationName":"IndexName" }, "Text":{ "shape":"SearchPlaceIndexForTextRequestTextString", "documentation":"<p>The address, name, city, or region to be used in the search in free-form text format. For example, <code>123 Any Street</code>.</p>" }, "BiasPosition":{ "shape":"Position", "documentation":"<p>An optional parameter that indicates a preference for places that are closer to a specified position.</p> <p> If provided, 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.</p> <p>For example, <code>[-123.1174, 49.2847]</code> represents the position with longitude <code>-123.1174</code> and latitude <code>49.2847</code>.</p> <note> <p> <code>BiasPosition</code> and <code>FilterBBox</code> are mutually exclusive. Specifying both options results in an error. </p> </note>" }, "FilterBBox":{ "shape":"BoundingBox", "documentation":"<p>An optional parameter that limits the search results by returning only places that are within the provided bounding box.</p> <p> If provided, this parameter must contain a total of four consecutive numbers in two pairs. The first pair of numbers represents the X and Y coordinates (longitude and latitude, respectively) of the southwest corner of the bounding box; the second pair of numbers represents the X and Y coordinates (longitude and latitude, respectively) of the northeast corner of the bounding box.</p> <p>For example, <code>[-12.7935, -37.4835, -12.0684, -36.9542]</code> represents a bounding box where the southwest corner has longitude <code>-12.7935</code> and latitude <code>-37.4835</code>, and the northeast corner has longitude <code>-12.0684</code> and latitude <code>-36.9542</code>.</p> <note> <p> <code>FilterBBox</code> and <code>BiasPosition</code> are mutually exclusive. Specifying both options results in an error. </p> </note>" }, "FilterCountries":{ "shape":"CountryCodeList", "documentation":"<p>An optional parameter that limits the search results by returning only places that are in a specified list of countries.</p> <ul> <li> <p>Valid values include <a href=\"https://www.iso.org/iso-3166-country-codes.html\">ISO 3166</a> 3-digit country codes. For example, Australia uses three upper-case characters: <code>AUS</code>.</p> </li> </ul>" }, "MaxResults":{ "shape":"PlaceIndexSearchResultLimit", "documentation":"<p>An optional parameter. The maximum number of results returned per request. </p> <p>The default: <code>50</code> </p>" }, "Language":{ "shape":"LanguageTag", "documentation":"<p>The preferred language used to return results. The value must be a valid <a href=\"https://tools.ietf.org/search/bcp47\">BCP 47</a> language tag, for example, <code>en</code> for English.</p> <p>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.</p> <p>For an example, we'll use the Greek language. You search for <code>Athens, Greece</code>, with the <code>language</code> parameter set to <code>en</code>. The result found will most likely be returned as <code>Athens</code>.</p> <p>If you set the <code>language</code> parameter to <code>el</code>, for Greek, then the result found will more likely be returned as <code>Αθήνα</code>.</p> <p>If the data provider does not have a value for Greek, the result will be in a language that the provider does support.</p>" }, "FilterCategories":{ "shape":"FilterPlaceCategoryList", "documentation":"<p>A list of one or more Amazon Location categories to filter the returned places. If you include more than one category, the results will include results that match <i>any</i> of the categories listed.</p> <p>For more information about using categories, including a list of Amazon Location categories, see <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/category-filtering.html\">Categories and filtering</a>, in the <i>Amazon Location Service developer guide</i>.</p>" }, "Key":{ "shape":"ApiKey", "documentation":"<p>The optional <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/using-apikeys.html\">API key</a> to authorize the request.</p>", "location":"querystring", "locationName":"key" } } }, "SearchPlaceIndexForTextRequestTextString":{ "type":"string", "max":200, "min":1, "sensitive":true }, "SearchPlaceIndexForTextResponse":{ "type":"structure", "required":[ "Summary", "Results" ], "members":{ "Summary":{ "shape":"SearchPlaceIndexForTextSummary", "documentation":"<p>Contains a summary of the request. Echoes the input values for <code>BiasPosition</code>, <code>FilterBBox</code>, <code>FilterCountries</code>, <code>Language</code>, <code>MaxResults</code>, and <code>Text</code>. Also includes the <code>DataSource</code> of the place index and the bounding box, <code>ResultBBox</code>, which surrounds the search results. </p>" }, "Results":{ "shape":"SearchForTextResultList", "documentation":"<p>A list of Places matching the input text. Each result contains additional information about the specific point of interest. </p> <p>Not all response properties are included with all responses. Some properties may only be returned by specific data partners.</p>" } } }, "SearchPlaceIndexForTextSummary":{ "type":"structure", "required":[ "Text", "DataSource" ], "members":{ "Text":{ "shape":"SensitiveString", "documentation":"<p>The search text specified in the request.</p>" }, "BiasPosition":{ "shape":"Position", "documentation":"<p>Contains the coordinates for the optional bias position specified in the request.</p> <p>This parameter contains a pair of numbers. The first number represents the X coordinate, or longitude; the second number represents the Y coordinate, or latitude.</p> <p>For example, <code>[-123.1174, 49.2847]</code> represents the position with longitude <code>-123.1174</code> and latitude <code>49.2847</code>.</p>" }, "FilterBBox":{ "shape":"BoundingBox", "documentation":"<p>Contains the coordinates for the optional bounding box specified in the request.</p>" }, "FilterCountries":{ "shape":"CountryCodeList", "documentation":"<p>Contains the optional country filter specified in the request.</p>" }, "MaxResults":{ "shape":"PlaceIndexSearchResultLimit", "documentation":"<p>Contains the optional result count limit specified in the request.</p>" }, "ResultBBox":{ "shape":"BoundingBox", "documentation":"<p>The bounding box that fully contains all search results.</p> <note> <p>If you specified the optional <code>FilterBBox</code> parameter in the request, <code>ResultBBox</code> is contained within <code>FilterBBox</code>.</p> </note>" }, "DataSource":{ "shape":"String", "documentation":"<p>The geospatial data provider attached to the place index resource specified in the request. Values can be one of the following:</p> <ul> <li> <p>Esri</p> </li> <li> <p>Grab</p> </li> <li> <p>Here</p> </li> </ul> <p>For more information about data providers, see <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/what-is-data-provider.html\">Amazon Location Service data providers</a>.</p>" }, "Language":{ "shape":"LanguageTag", "documentation":"<p>The preferred language used to return results. Matches the language in the request. The value is a valid <a href=\"https://tools.ietf.org/search/bcp47\">BCP 47</a> language tag, for example, <code>en</code> for English.</p>" }, "FilterCategories":{ "shape":"FilterPlaceCategoryList", "documentation":"<p>The optional category filter specified in the request.</p>" } }, "documentation":"<p>A summary of the request sent by using <code>SearchPlaceIndexForText</code>.</p>" }, "SensitiveBoolean":{ "type":"boolean", "box":true, "sensitive":true }, "SensitiveDouble":{ "type":"double", "box":true, "sensitive":true }, "SensitiveInteger":{ "type":"integer", "box":true, "sensitive":true }, "SensitiveString":{ "type":"string", "sensitive":true }, "ServiceQuotaExceededException":{ "type":"structure", "required":["Message"], "members":{ "Message":{ "shape":"String", "documentation":"<p>A message with the reason for the service quota exceeded exception error.</p>", "locationName":"message" } }, "documentation":"<p>The operation was denied because the request would exceed the maximum <a href=\"https://docs.aws.amazon.com/location/previous/developerguide/location-quotas.html\">quota</a> set for Amazon Location Service.</p>", "error":{ "httpStatusCode":402, "senderFault":true }, "exception":true }, "Sha1CertificateFingerprint":{ "type":"string", "max":59, "min":59, "pattern":"([A-Fa-f0-9]{2}:){19}[A-Fa-f0-9]{2}" }, "SpeedUnit":{ "type":"string", "enum":[ "KilometersPerHour", "MilesPerHour" ] }, "Status":{ "type":"string", "enum":[ "Active", "Expired" ] }, "Step":{ "type":"structure", "required":[ "StartPosition", "EndPosition", "Distance", "DurationSeconds" ], "members":{ "StartPosition":{ "shape":"Position", "documentation":"<p>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.</p>" }, "EndPosition":{ "shape":"Position", "documentation":"<p>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.</p>" }, "Distance":{ "shape":"StepDistanceDouble", "documentation":"<p>The travel distance between the step's <code>StartPosition</code> and <code>EndPosition</code>.</p>" }, "DurationSeconds":{ "shape":"StepDurationSecondsDouble", "documentation":"<p>The estimated travel time, in seconds, from the step's <code>StartPosition</code> to the <code>EndPosition</code>. . The travel mode and departure time that you specify in the request determines the calculated time.</p>" }, "GeometryOffset":{ "shape":"StepGeometryOffsetInteger", "documentation":"<p>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 <code>0</code>. </p> <p>Included in the response for queries that set <code>IncludeLegGeometry</code> to <code>True</code>. </p>" } }, "documentation":"<p> Represents an element of a leg within a route. A step contains instructions for how to move to the next step in the leg. </p>" }, "StepDistanceDouble":{ "type":"double", "box":true, "min":0, "sensitive":true }, "StepDurationSecondsDouble":{ "type":"double", "box":true, "min":0, "sensitive":true }, "StepGeometryOffsetInteger":{ "type":"integer", "box":true, "min":0 }, "StepList":{ "type":"list", "member":{"shape":"Step"} }, "String":{"type":"string"}, "TagKey":{ "type":"string", "max":128, "min":1, "pattern":"([\\p{L}\\p{Z}\\p{N}_.,:/=+\\-@]*)" }, "TagKeys":{ "type":"list", "member":{"shape":"String"}, "max":50, "min":1 }, "TagMap":{ "type":"map", "key":{"shape":"TagKey"}, "value":{"shape":"TagValue"}, "max":50, "min":0 }, "TagResourceRequest":{ "type":"structure", "required":[ "ResourceArn", "Tags" ], "members":{ "ResourceArn":{ "shape":"Arn", "documentation":"<p>The Amazon Resource Name (ARN) of the resource whose tags you want to update.</p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:resourcetype/ExampleResource</code> </p> </li> </ul>", "location":"uri", "locationName":"ResourceArn" }, "Tags":{ "shape":"TagMap", "documentation":"<p>Applies one or more tags to specific resource. A tag is a key-value pair that helps you manage, identify, search, and filter your resources.</p> <p>Format: <code>\"key\" : \"value\"</code> </p> <p>Restrictions:</p> <ul> <li> <p>Maximum 50 tags per resource.</p> </li> <li> <p>Each tag key must be unique and must have exactly one associated value.</p> </li> <li> <p>Maximum key length: 128 Unicode characters in UTF-8.</p> </li> <li> <p>Maximum value length: 256 Unicode characters in UTF-8.</p> </li> <li> <p>Can use alphanumeric characters (A–Z, a–z, 0–9), and the following characters: + - = . _ : / @</p> </li> <li> <p>Cannot use \"aws:\" as a prefix for a key.</p> </li> </ul>" } } }, "TagResourceResponse":{ "type":"structure", "members":{} }, "TagValue":{ "type":"string", "max":256, "min":0, "pattern":"([\\p{L}\\p{Z}\\p{N}_.,:/=+\\-@]*)" }, "ThrottlingException":{ "type":"structure", "required":["Message"], "members":{ "Message":{ "shape":"String", "locationName":"message" } }, "documentation":"<p>The request was denied because of request throttling.</p>", "error":{ "httpStatusCode":429, "senderFault":true }, "exception":true, "retryable":{"throttling":false} }, "TimeZone":{ "type":"structure", "required":["Name"], "members":{ "Name":{ "shape":"SensitiveString", "documentation":"<p>The name of the time zone, following the <a href=\"https://www.iana.org/time-zones\"> IANA time zone standard</a>. For example, <code>America/Los_Angeles</code>.</p>" }, "Offset":{ "shape":"SensitiveInteger", "documentation":"<p>The time zone's offset, in seconds, from UTC.</p>" } }, "documentation":"<p>Information about a time zone. Includes the name of the time zone and the offset from UTC in seconds.</p>" }, "Timestamp":{ "type":"timestamp", "sensitive":true, "timestampFormat":"iso8601" }, "Token":{ "type":"string", "max":2000, "min":1 }, "TrackingFilterGeometry":{ "type":"structure", "members":{ "Polygon":{ "shape":"LinearRings", "documentation":"<p>The set of arrays which define the polygon. A polygon can have between 4 and 1000 vertices.</p>" } }, "documentation":"<p>The geomerty used to filter device positions.</p>" }, "TravelMode":{ "type":"string", "enum":[ "Car", "Truck", "Walking", "Bicycle", "Motorcycle" ] }, "TruckDimensions":{ "type":"structure", "members":{ "Length":{ "shape":"TruckDimensionsLengthDouble", "documentation":"<p>The length of the truck.</p> <ul> <li> <p>For example, <code>15.5</code>.</p> </li> </ul> <note> <p> For routes calculated with a HERE resource, this value must be between 0 and 300 meters. </p> </note>" }, "Height":{ "shape":"TruckDimensionsHeightDouble", "documentation":"<p>The height of the truck.</p> <ul> <li> <p>For example, <code>4.5</code>.</p> </li> </ul> <note> <p> For routes calculated with a HERE resource, this value must be between 0 and 50 meters. </p> </note>" }, "Width":{ "shape":"TruckDimensionsWidthDouble", "documentation":"<p>The width of the truck.</p> <ul> <li> <p>For example, <code>4.5</code>.</p> </li> </ul> <note> <p> For routes calculated with a HERE resource, this value must be between 0 and 50 meters. </p> </note>" }, "Unit":{ "shape":"DimensionUnit", "documentation":"<p> Specifies the unit of measurement for the truck dimensions.</p> <p>Default Value: <code>Meters</code> </p>" } }, "documentation":"<p>Contains details about the truck dimensions in the unit of measurement that you specify. Used to filter out roads that can't support or allow the specified dimensions for requests that specify <code>TravelMode</code> as <code>Truck</code>.</p>" }, "TruckDimensionsHeightDouble":{ "type":"double", "box":true, "min":0, "sensitive":true }, "TruckDimensionsLengthDouble":{ "type":"double", "box":true, "min":0, "sensitive":true }, "TruckDimensionsWidthDouble":{ "type":"double", "box":true, "min":0, "sensitive":true }, "TruckWeight":{ "type":"structure", "members":{ "Total":{ "shape":"TruckWeightTotalDouble", "documentation":"<p>The total weight of the truck. </p> <ul> <li> <p>For example, <code>3500</code>.</p> </li> </ul>" }, "Unit":{ "shape":"VehicleWeightUnit", "documentation":"<p>The unit of measurement to use for the truck weight.</p> <p>Default Value: <code>Kilograms</code> </p>" } }, "documentation":"<p>Contains details about the truck's weight specifications. Used to avoid roads that can't support or allow the total weight for requests that specify <code>TravelMode</code> as <code>Truck</code>.</p>" }, "TruckWeightTotalDouble":{ "type":"double", "box":true, "min":0, "sensitive":true }, "UntagResourceRequest":{ "type":"structure", "required":[ "ResourceArn", "TagKeys" ], "members":{ "ResourceArn":{ "shape":"Arn", "documentation":"<p>The Amazon Resource Name (ARN) of the resource from which you want to remove tags.</p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:resourcetype/ExampleResource</code> </p> </li> </ul>", "location":"uri", "locationName":"ResourceArn" }, "TagKeys":{ "shape":"TagKeys", "documentation":"<p>The list of tag keys to remove from the specified resource.</p>", "location":"querystring", "locationName":"tagKeys" } } }, "UntagResourceResponse":{ "type":"structure", "members":{} }, "UpdateGeofenceCollectionRequest":{ "type":"structure", "required":["CollectionName"], "members":{ "CollectionName":{ "shape":"ResourceName", "documentation":"<p>The name of the geofence collection to update.</p>", "location":"uri", "locationName":"CollectionName" }, "PricingPlan":{ "shape":"PricingPlan", "documentation":"<p>No longer used. If included, the only allowed value is <code>RequestBasedUsage</code>.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. If included, the only allowed value is RequestBasedUsage.", "deprecatedSince":"2022-02-01" }, "PricingPlanDataSource":{ "shape":"String", "documentation":"<p>This parameter is no longer used.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. No longer allowed.", "deprecatedSince":"2022-02-01" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>Updates the description for the geofence collection.</p>" } } }, "UpdateGeofenceCollectionResponse":{ "type":"structure", "required":[ "CollectionName", "CollectionArn", "UpdateTime" ], "members":{ "CollectionName":{ "shape":"ResourceName", "documentation":"<p>The name of the updated geofence collection.</p>" }, "CollectionArn":{ "shape":"Arn", "documentation":"<p>The Amazon Resource Name (ARN) of the updated geofence collection. Used to specify a resource across Amazon Web Services.</p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:geofence-collection/ExampleGeofenceCollection</code> </p> </li> </ul>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The time when the geofence collection was last updated in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\">ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code> </p>" } } }, "UpdateKeyRequest":{ "type":"structure", "required":["KeyName"], "members":{ "KeyName":{ "shape":"ResourceName", "documentation":"<p>The name of the API key resource to update.</p>", "location":"uri", "locationName":"KeyName" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>Updates the description for the API key resource.</p>" }, "ExpireTime":{ "shape":"Timestamp", "documentation":"<p>Updates the timestamp for when the API key resource will expire in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" }, "NoExpiry":{ "shape":"Boolean", "documentation":"<p>Whether the API key should expire. Set to <code>true</code> to set the API key to have no expiration time.</p>" }, "ForceUpdate":{ "shape":"Boolean", "documentation":"<p>The boolean flag to be included for updating <code>ExpireTime</code> or <code>Restrictions</code> details.</p> <p>Must be set to <code>true</code> to update an API key resource that has been used in the past 7 days.</p> <p> <code>False</code> if force update is not preferred</p> <p>Default value: <code>False</code> </p>" }, "Restrictions":{ "shape":"ApiKeyRestrictions", "documentation":"<p>Updates the API key restrictions for the API key resource.</p>" } } }, "UpdateKeyResponse":{ "type":"structure", "required":[ "KeyArn", "KeyName", "UpdateTime" ], "members":{ "KeyArn":{ "shape":"Arn", "documentation":"<p>The Amazon Resource Name (ARN) for the API key resource. Used when you need to specify a resource across all Amazon Web Services.</p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:key/ExampleKey</code> </p> </li> </ul>" }, "KeyName":{ "shape":"ResourceName", "documentation":"<p>The name of the API key resource.</p>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the API key resource was last updated in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" } } }, "UpdateMapRequest":{ "type":"structure", "required":["MapName"], "members":{ "MapName":{ "shape":"ResourceName", "documentation":"<p>The name of the map resource to update.</p>", "location":"uri", "locationName":"MapName" }, "PricingPlan":{ "shape":"PricingPlan", "documentation":"<p>No longer used. If included, the only allowed value is <code>RequestBasedUsage</code>.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. If included, the only allowed value is RequestBasedUsage.", "deprecatedSince":"2022-02-01" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>Updates the description for the map resource.</p>" }, "ConfigurationUpdate":{ "shape":"MapConfigurationUpdate", "documentation":"<p>Updates the parts of the map configuration that can be updated, including the political view.</p>" } } }, "UpdateMapResponse":{ "type":"structure", "required":[ "MapName", "MapArn", "UpdateTime" ], "members":{ "MapName":{ "shape":"ResourceName", "documentation":"<p>The name of the updated map resource.</p>" }, "MapArn":{ "shape":"GeoArn", "documentation":"<p>The Amazon Resource Name (ARN) of the updated map resource. Used to specify a resource across AWS.</p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:map/ExampleMap</code> </p> </li> </ul>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the map resource was last updated in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" } } }, "UpdatePlaceIndexRequest":{ "type":"structure", "required":["IndexName"], "members":{ "IndexName":{ "shape":"ResourceName", "documentation":"<p>The name of the place index resource to update.</p>", "location":"uri", "locationName":"IndexName" }, "PricingPlan":{ "shape":"PricingPlan", "documentation":"<p>No longer used. If included, the only allowed value is <code>RequestBasedUsage</code>.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. If included, the only allowed value is RequestBasedUsage.", "deprecatedSince":"2022-02-01" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>Updates the description for the place index resource.</p>" }, "DataSourceConfiguration":{ "shape":"DataSourceConfiguration", "documentation":"<p>Updates the data storage option for the place index resource.</p>" } } }, "UpdatePlaceIndexResponse":{ "type":"structure", "required":[ "IndexName", "IndexArn", "UpdateTime" ], "members":{ "IndexName":{ "shape":"ResourceName", "documentation":"<p>The name of the updated place index resource.</p>" }, "IndexArn":{ "shape":"GeoArn", "documentation":"<p>The Amazon Resource Name (ARN) of the upated place index resource. Used to specify a resource across Amazon Web Services.</p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:place- index/ExamplePlaceIndex</code> </p> </li> </ul>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the place index resource was last updated in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" } } }, "UpdateRouteCalculatorRequest":{ "type":"structure", "required":["CalculatorName"], "members":{ "CalculatorName":{ "shape":"ResourceName", "documentation":"<p>The name of the route calculator resource to update.</p>", "location":"uri", "locationName":"CalculatorName" }, "PricingPlan":{ "shape":"PricingPlan", "documentation":"<p>No longer used. If included, the only allowed value is <code>RequestBasedUsage</code>.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. If included, the only allowed value is RequestBasedUsage.", "deprecatedSince":"2022-02-01" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>Updates the description for the route calculator resource.</p>" } } }, "UpdateRouteCalculatorResponse":{ "type":"structure", "required":[ "CalculatorName", "CalculatorArn", "UpdateTime" ], "members":{ "CalculatorName":{ "shape":"ResourceName", "documentation":"<p>The name of the updated route calculator resource.</p>" }, "CalculatorArn":{ "shape":"GeoArn", "documentation":"<p>The Amazon Resource Name (ARN) of the updated route calculator resource. Used to specify a resource across AWS.</p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:route- calculator/ExampleCalculator</code> </p> </li> </ul>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the route calculator was last updated in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" } } }, "UpdateTrackerRequest":{ "type":"structure", "required":["TrackerName"], "members":{ "TrackerName":{ "shape":"ResourceName", "documentation":"<p>The name of the tracker resource to update.</p>", "location":"uri", "locationName":"TrackerName" }, "PricingPlan":{ "shape":"PricingPlan", "documentation":"<p>No longer used. If included, the only allowed value is <code>RequestBasedUsage</code>.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. If included, the only allowed value is RequestBasedUsage.", "deprecatedSince":"2022-02-01" }, "PricingPlanDataSource":{ "shape":"String", "documentation":"<p>This parameter is no longer used.</p>", "deprecated":true, "deprecatedMessage":"Deprecated. No longer allowed.", "deprecatedSince":"2022-02-01" }, "Description":{ "shape":"ResourceDescription", "documentation":"<p>Updates the description for the tracker resource.</p>" }, "PositionFiltering":{ "shape":"PositionFiltering", "documentation":"<p>Updates the position filtering for the tracker resource.</p> <p>Valid values:</p> <ul> <li> <p> <code>TimeBased</code> - 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. </p> </li> <li> <p> <code>DistanceBased</code> - If the device has moved less than 30 m (98.4 ft), location updates are ignored. Location updates within this distance 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. </p> </li> <li> <p> <code>AccuracyBased</code> - 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 helps educe the effects of GPS noise when displaying device trajectories on a map, and can help control costs by reducing the number of geofence evaluations. </p> </li> </ul>" }, "EventBridgeEnabled":{ "shape":"Boolean", "documentation":"<p>Whether to enable position <code>UPDATE</code> events from this tracker to be sent to EventBridge.</p> <note> <p>You do not need enable this feature to get <code>ENTER</code> and <code>EXIT</code> events for geofences with this tracker. Those events are always sent to EventBridge.</p> </note>" }, "KmsKeyEnableGeospatialQueries":{ "shape":"Boolean", "documentation":"<p>Enables <code>GeospatialQueries</code> for a tracker that uses a <a href=\"https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html\">Amazon Web Services KMS customer managed key</a>.</p> <p>This parameter is only used if you are using a KMS customer managed key.</p>" } } }, "UpdateTrackerResponse":{ "type":"structure", "required":[ "TrackerName", "TrackerArn", "UpdateTime" ], "members":{ "TrackerName":{ "shape":"ResourceName", "documentation":"<p>The name of the updated tracker resource.</p>" }, "TrackerArn":{ "shape":"Arn", "documentation":"<p>The Amazon Resource Name (ARN) of the updated tracker resource. Used to specify a resource across AWS.</p> <ul> <li> <p>Format example: <code>arn:aws:geo:region:account-id:tracker/ExampleTracker</code> </p> </li> </ul>" }, "UpdateTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the tracker resource was last updated in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601</a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" } } }, "Uuid":{ "type":"string", "pattern":"[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}" }, "ValidationException":{ "type":"structure", "required":[ "Message", "Reason", "FieldList" ], "members":{ "Message":{ "shape":"String", "locationName":"message" }, "Reason":{ "shape":"ValidationExceptionReason", "documentation":"<p>A message with the reason for the validation exception error.</p>", "locationName":"reason" }, "FieldList":{ "shape":"ValidationExceptionFieldList", "documentation":"<p>The field where the invalid entry was detected.</p>", "locationName":"fieldList" } }, "documentation":"<p>The input failed to meet the constraints specified by the AWS service. </p>", "error":{ "httpStatusCode":400, "senderFault":true }, "exception":true }, "ValidationExceptionField":{ "type":"structure", "required":[ "Name", "Message" ], "members":{ "Name":{ "shape":"String", "documentation":"<p>The field name where the invalid entry was detected.</p>", "locationName":"name" }, "Message":{ "shape":"String", "documentation":"<p>A message with the reason for the validation exception error.</p>", "locationName":"message" } }, "documentation":"<p>The input failed to meet the constraints specified by the AWS service in a specified field. </p>" }, "ValidationExceptionFieldList":{ "type":"list", "member":{"shape":"ValidationExceptionField"} }, "ValidationExceptionReason":{ "type":"string", "enum":[ "UnknownOperation", "Missing", "CannotParse", "FieldValidationFailed", "Other", "UnknownField" ] }, "VehicleWeightUnit":{ "type":"string", "enum":[ "Kilograms", "Pounds" ] }, "VerifyDevicePositionRequest":{ "type":"structure", "required":[ "TrackerName", "DeviceState" ], "members":{ "TrackerName":{ "shape":"ResourceName", "documentation":"<p>The name of the tracker resource to be associated with verification request.</p>", "location":"uri", "locationName":"TrackerName" }, "DeviceState":{ "shape":"DeviceState", "documentation":"<p>The device's state, including position, IP address, cell signals and Wi-Fi access points.</p>" }, "DistanceUnit":{ "shape":"DistanceUnit", "documentation":"<p>The distance unit for the verification request.</p> <p>Default Value: <code>Kilometers</code> </p>" } } }, "VerifyDevicePositionResponse":{ "type":"structure", "required":[ "InferredState", "DeviceId", "SampleTime", "ReceivedTime", "DistanceUnit" ], "members":{ "InferredState":{ "shape":"InferredState", "documentation":"<p>The inferred state of the device, given the provided position, IP address, cellular signals, and Wi-Fi- access points.</p>" }, "DeviceId":{ "shape":"Id", "documentation":"<p>The device identifier.</p>" }, "SampleTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp at which the device's position was determined. Uses <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601 </a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" }, "ReceivedTime":{ "shape":"Timestamp", "documentation":"<p>The timestamp for when the tracker resource received the device position in <a href=\"https://www.iso.org/iso-8601-date-and-time-format.html\"> ISO 8601 </a> format: <code>YYYY-MM-DDThh:mm:ss.sssZ</code>. </p>" }, "DistanceUnit":{ "shape":"DistanceUnit", "documentation":"<p>The distance unit for the verification response.</p>" } } }, "WiFiAccessPoint":{ "type":"structure", "required":[ "MacAddress", "Rss" ], "members":{ "MacAddress":{ "shape":"WiFiAccessPointMacAddressString", "documentation":"<p>Medium access control address (Mac).</p>" }, "Rss":{ "shape":"WiFiAccessPointRssInteger", "documentation":"<p>Received signal strength (dBm) of the WLAN measurement data.</p>" } }, "documentation":"<p>Wi-Fi access point.</p>" }, "WiFiAccessPointList":{ "type":"list", "member":{"shape":"WiFiAccessPoint"} }, "WiFiAccessPointMacAddressString":{ "type":"string", "max":17, "min":12, "pattern":"([0-9A-Fa-f]{2}[:-]){5}([0-9A-Fa-f]{2})" }, "WiFiAccessPointRssInteger":{ "type":"integer", "box":true, "max":0, "min":-128 } }, "documentation":"<p>\"Suite of geospatial services including Maps, Places, Routes, Tracking, and Geofencing\"</p>" }
© 2026 UnknownSec