;
```
This will instantiate a [`Map`](https://maplibre.org/maplibre-gl-js-docs/api/map/), exchange the provided Amazon Cognito Identity Pool ID for AWS credentials, load the style associated with the `explore.map` Map resource, and render it to the `` identified as `map`, centered on Vancouver, British Columbia:
```javascript
const map = await AmazonLocation.createMap({
identityPoolId: "us-east-1:54f2ba88-9390-498d-aaa5-0d97fb7ca3bd",
}, {
container: "map",
center: [-123.1187, 49.2819], // initial map centerpoint
zoom: 10, // initial map zoom
style: "explore.map",
}
);
```
For a fully worked example, see [`maplibre-gl-js/index.html`](https://github.com/aws-samples/amazon-location-samples/blob/main/maplibre-gl-js/index.html).
### `createRequestTransformer`
```typescript
function createRequestTransformer(config: {
credentials?: Credentials;
identityPoolId?: string;
region?: string;
}): Promise;
```
This will initialize a `transformRequest` function suitable for providing to [`Map`](https://maplibre.org/maplibre-gl-js-docs/api/map/)'s `transformRequest` property that will intercept requests made by MapLibre GL JS to AWS and sign them using [Signature Version 4](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html):
```javascript
import { createRequestTransformer } from "amazon-location-helpers";
const transformRequest = await createRequestTransformer({
identityPoolId: "us-east-1:54f2ba88-9390-498d-aaa5-0d97fb7ca3bd",
});
```
This can then be used with [`react-map-gl`](https://visgl.github.io/react-map-gl/):
```javascript
// React equivalent to the above example
```
For a fully worked example, see [`maplibre-gl-js-react/src/index.tsx`](https://github.com/aws-samples/amazon-location-samples/blob/main/maplibre-gl-js-react/src/index.tsx).
### `getCredentialsForIdentityPool`
```typescript
function getCredentialsForIdentityPool(
identity: string
): Promise;
```
This will exchange an Amazon Cognito Identity Pool ID for temporary AWS credentials. For example:
```javascript
const credentials = await AmazonLocation.getCredentialsForIdentityPool("us-east-1:54f2ba88-9390-498d-aaa5-0d97fb7ca3bd");
// use credentials with other AWS services
```
## Security
See [CONTRIBUTING](https://github.com/aws-samples/amazon-location-samples/blog/main/CONTRIBUTING.md#security-issue-notifications) for more information.
## License
This library is licensed under the MIT-0 License. See the LICENSE file.