# @aws/amazon-location-for-maplibre-gl-geocoder 中文文档
规范地址：https://npmcn.com/package/%40aws/amazon-location-for-maplibre-gl-geocoder/
版本：2\.0\.8
npm 元数据更新时间：2026-06-22T20:38:44.509Z
中文译文更新时间：2026-11-07T14:35:17.198Z
软件包许可：未声明
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40aws/amazon-location-for-maplibre-gl-geocoder
原文对照：https://npmcn.com/package/%40aws/amazon-location-for-maplibre-gl-geocoder/?lang=original
项目主页：https://github.com/aws-geospatial/amazon-location-for-maplibre-gl-geocoder#readme
源码仓库：https://github.com/aws-geospatial/amazon-location-for-maplibre-gl-geocoder
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：1.4 MB，23 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2024-04-29T20:11:39.697Z
- 最新版本发布：2026-06-22T15:33:50.129Z
- 近 30 天下载量：17705（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：15（近 12 个月 3 个）
## 中文简介
支持 Amazon 位置服务整合的 Maplibre 插件
## 安装
```sh
npm install @aws/amazon-location-for-maplibre-gl-geocoder
```
也可以使用：`pnpm add @aws/amazon-location-for-maplibre-gl-geocoder`、`yarn add @aws/amazon-location-for-maplibre-gl-geocoder`、`bun add @aws/amazon-location-for-maplibre-gl-geocoder`
## README
# 地图地图
[](https://www.npmjs.com/package/@aws/amazon-location-for-maplibre-gl-geocoder) [](https://github.com/aws-geospatial/amazon-location-for-maplibre-gl-geocoder/actions/workflows/build.yml)
此库用于简化使用过程 [亚马逊定位服务](https://aws.amazon.com/location/) 与 [映射- gl- 地理编码器](https://github.com/maplibre/maplibre-gl-geocoder) 在JavaScript应用程序中.
## 安装
从国家防范机制安装此库供模块使用:
```console
npm install @aws/amazon-location-for-maplibre-gl-geocoder
```
您也可以导入 HTML 和 CSS 文件供浏览器直接使用.
```html
```
## 使用量
### 模块的用法 - 独立的地盘 SDK
此示例使用 [JavaScript V3 的 AWS SDK 软件](https://github.com/aws/aws-sdk-js-v3) 获得一个 GeoPlacesClient 供图书馆使用,以及 [认证帮助](https://github.com/aws-geospatial/amazon-location-utilities-auth-helper-js) 用于认证 GeoPlacesClient。 它为地理编码器提供了所有API.
```javascript
// Import MapLibre GL JS
import maplibregl from "maplibre-gl";
// Import from the AWS JavaScript SDK V3
import { GeoPlacesClient } from "@aws-sdk/client-geo-places";
// Import the utility functions
import { withAPIKey } from "@aws/amazon-location-utilities-auth-helper";
// Import the AmazonLocationMaplibreGeocoder
import {
buildAmazonLocationMaplibreGeocoder,
AmazonLocationMaplibreGeocoder,
} from "@aws/amazon-location-for-maplibre-gl-geocoder";
const apiKey = "";
const mapName = "Standard";
const region = ""; // region containing Amazon Location API Key
// Create an authentication helper instance using an API key and region
const authHelper = await withAPIKey(apiKey, region);
const client = new GeoPlacesClient(authHelper.getClientConfig());
// Render the map
const map = new maplibregl.Map({
container: "map",
center: [-123.115898, 49.295868],
zoom: 10,
style: `https://maps.geo.${region}.amazonaws.com/v2/styles/${mapStyle}/descriptor?key=${apiKey}`,
});
// Gets an instance of the AmazonLocationMaplibreGeocoder Object.
const amazonLocationMaplibreGeocoder = buildAmazonLocationMaplibreGeocoder(client, { enableAll: true });
// Now we can add the Geocoder to the map.
map.addControl(amazonLocationMaplibreGeocoder.getPlacesGeocoder());
```
### 使用浏览器 - 独立的 GeoPlaces SDK
客户和公用事业职能可在 `amazonLocationClient` 全球.
> 其中一些例子使用"亚马逊地平板电脑". 亚马逊GeoPlacesClient基于 [JavaScript V3 的 AWS SDK 软件](https://github.com/aws/aws-sdk-js-v3) ,并允许通过 HTML 文件引用的脚本给 Amazon Location 打电话.
这个例子使用"亚马逊GeoPlacesClient"来提出使用API密钥认证的请求.
```html
```
```javascript
const apiKey = "";
const mapStyle = "Standard";
const region = ""; // region containing Amazon Location API key
// Create an authentication helper instance using an API key and region
const authHelper = await amazonLocationClient.withAPIKey(apiKey, region);
const client = new amazonLocationClient.GeoPlacesClient(authHelper.getClientConfig());
// Render the map
const map = new maplibregl.Map({
container: "map",
center: [-123.115898, 49.295868],
zoom: 10,
style: `https://maps.geo.${region}.amazonaws.com/v2/styles/${mapStyle}/descriptor?key=${apiKey}`,
});
// Initialize the AmazonLocationMaplibreGeocoder object
const amazonLocationMaplibreGeocoderObject = amazonLocationMaplibreGeocoder.buildAmazonLocationMaplibreGeocoder(
client,
{ enableAll: true },
);
// Use the AmazonLocationWithMaplibreGeocoder object to add a geocoder to the map.
map.addControl(amazonLocationMaplibreGeocoderObject.getPlacesGeocoder());
```
### 模块的使用 -- -- 合并位置
此示例使用 [JavaScript V3 的 AWS SDK 软件](https://github.com/aws/aws-sdk-js-v3) 获取一个地址地址地址向图书馆提供,以及 [认证帮助](https://github.com/aws-geospatial/amazon-location-utilities-auth-helper-js) 用于认证位置中心。 它可以让所有API用于地理编码器.
使用合并的 LaceClient API 需要您在选项变量中提供 PlacesIndex(您在 AWS 账户中的位置资源名称) .
```javascript
// Import MapLibre GL JS
import maplibregl from "maplibre-gl";
// Import from the AWS JavaScript SDK V3
import { LocationClient } from "@aws-sdk/client-location";
// Import the utility functions
import { withAPIKey } from "@aws/amazon-location-utilities-auth-helper";
// Import the AmazonLocationMaplibreGeocoder
import {
buildAmazonLocationMaplibreGeocoder,
AmazonLocationMaplibreGeocoder,
} from "@aws/amazon-location-for-maplibre-gl-geocoder";
const identityPoolId = "";
const mapName = "