list_geofences

list_geofences(**kwargs)

Lists geofences stored in a given geofence collection.

See also: AWS API Documentation

Request Syntax

response = client.list_geofences(
    CollectionName='string',
    MaxResults=123,
    NextToken='string'
)
Parameters
  • CollectionName (string) --

    [REQUIRED]

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

  • MaxResults (integer) --

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

    Default value: 100

  • NextToken (string) --

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

    Default value: null

Return type

dict

Returns

Response Syntax

{
    'Entries': [
        {
            'CreateTime': datetime(2015, 1, 1),
            'GeofenceId': 'string',
            'Geometry': {
                'Circle': {
                    'Center': [
                        123.0,
                    ],
                    'Radius': 123.0
                },
                'Polygon': [
                    [
                        [
                            123.0,
                        ],
                    ],
                ]
            },
            'Status': 'string',
            'UpdateTime': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Entries (list) --

      Contains a list of geofences stored in the geofence collection.

      • (dict) --

        Contains a list of geofences stored in a given geofence collection.

        • CreateTime (datetime) --

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

        • GeofenceId (string) --

          The geofence identifier.

        • Geometry (dict) --

          Contains the geofence geometry details describing a polygon or a circle.

          • Circle (dict) --

            A circle on the earth, as defined by a center point and a radius.

            • Center (list) --

              A single point geometry, specifying the center of the circle, using WGS 84 coordinates, in the form [longitude, latitude] .

              • (float) --
            • Radius (float) --

              The radius of the circle in meters. Must be greater than zero and no larger than 100,000 (100 kilometers).

          • Polygon (list) --

            A polygon is a list of linear rings which are each made up of a list of vertices.

            Each vertex is a 2-dimensional point of the form: [longitude, latitude] . This is represented as an array of doubles of length 2 (so [double, double] ).

            An array of 4 or more vertices, where the first and last vertex are the same (to form a closed boundary), is called a linear ring. The linear ring vertices must be listed in counter-clockwise order around the ring’s interior. The linear ring is represented as an array of vertices, or an array of arrays of doubles ( [[double, double], ...] ).

            A geofence consists of a single linear ring. To allow for future expansion, the Polygon parameter takes an array of linear rings, which is represented as an array of arrays of arrays of doubles ( [[[double, double], ...], ...] ).

            A linear ring for use in geofences can consist of between 4 and 1,000 vertices.

            • (list) --
              • (list) --
                • (float) --
        • Status (string) --

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

          • ACTIVE — The geofence has been indexed by the system.
          • PENDING — The geofence is being processed by the system.
          • FAILED — The geofence failed to be indexed by the system.
          • DELETED — The geofence has been deleted from the system index.
          • DELETING — The geofence is being deleted from the system index.
        • UpdateTime (datetime) --

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

    • NextToken (string) --

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

Exceptions

  • LocationService.Client.exceptions.InternalServerException
  • LocationService.Client.exceptions.ResourceNotFoundException
  • LocationService.Client.exceptions.AccessDeniedException
  • LocationService.Client.exceptions.ValidationException
  • LocationService.Client.exceptions.ThrottlingException