> **Experimental**
>
> `@aws-cdk/aws-location-alpha` is an [**experimental**](https://docs.aws.amazon.com/cdk/api/stability.html) (alpha) package: its API may change in any release, without a major version bump.
# TrackerProps

Properties for a tracker.

Used as props by: [Tracker](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-location-alpha.Tracker.html)

- Stability: [Experimental](https://docs.aws.amazon.com/cdk/api/stability.html)
- Source: [`lib/tracker.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0/packages/@aws-cdk/aws-location-alpha/lib/tracker.ts#L35)

## Example

TypeScript:

```ts
declare const role: iam.Role;

const tracker = new location.Tracker(this, 'Tracker', {
  trackerName: 'MyTracker',
});

tracker.grantRead(role);
```

Python:

```python
# role: iam.Role

tracker = location.Tracker(self, "Tracker",
    tracker_name="MyTracker"
)

tracker.grant_read(role)
```

Java:

```java
Role role;

Tracker tracker = Tracker.Builder.create(this, "Tracker")
        .trackerName("MyTracker")
        .build();

tracker.grantRead(role);
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.AWS.Location.Alpha
Role role;

var tracker = new Tracker(this, "Tracker", new TrackerProps {
    TrackerName = "MyTracker"
});

tracker.GrantRead(role);
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awscdklocationalpha/v2
var role Role

tracker := location.NewTracker(this, jsii.String("Tracker"), &TrackerProps{
	TrackerName: jsii.String("MyTracker"),
})

tracker.GrantRead(role)
```

## Properties

- `description`: string — A description for the tracker.

  **Default:** no description

- `eventBridgeEnabled`: boolean = false — Send filtered device position updates to default EventBridge bus.

- `geofenceCollections`: [IGeofenceCollection](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-location-alpha.IGeofenceCollection.html)[] — An optional list of geofence collections to associate with the tracker resource.

  **Default:** no geofence collections are associated

- `kmsKey`: [IKeyRef](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.interfaces.aws_kms.IKeyRef.html) — The customer managed key to encrypt data.

  **Default:** Use an AWS managed key

  If you set customer managed key, the Bounding Polygon Queries feature will be disabled by default.
  You can choose to opt-in to the Bounding Polygon Queries feature by setting the kmsKeyEnableGeospatialQueries parameter to true.

- `kmsKeyEnableGeospatialQueries`: boolean = false — Whether to opt-in to the Bounding Polygon Queries feature with customer managed key.

- `positionFiltering`: [PositionFiltering](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-location-alpha.PositionFiltering.html) = PositionFiltering.TIME_BASED — The position filtering for the tracker resource.

- `trackerName`: string — A name for the tracker.

  **Default:** A name is automatically generated

  Must be between 1 and 100 characters and contain only alphanumeric characters,
  hyphens, periods and underscores.
