Maps JavaScript API 是一种客户端 Web API，可让您创建地图来显示世界各地的位置，添加您自己的自定义图形、动画和交互式自定义数据层，以及通过在 Maps JavaScript API 中使用 Places API 来创建位置感知功能。借助 Maps JavaScript API，您可以：
- 创建 2D 和 3D 地图，显示世界各地的地点。
- 添加可自定义的标记，以指示地图上的位置。
- 使用 Places 库获取超过 2 亿个地点的位置数据。
- 自定义地图的样式和颜色。
- 添加您自己的交互式自定义数据层。
- 显示行政边界并使其可交互。
- 向地图添加自定义 2D 和 3D 图形及动画内容。
根据您的应用场景选择合适的 API
以下示例展示了在常见的 Web 应用场景中应使用哪些 Google Maps Platform 产品和库：
- 网站联系地图和路线：如需嵌入营业地点地图或路线链接，而无需编写自定义 JavaScript，请使用 Maps Embed API 或 Maps URL。
- 实时位置和资产跟踪：如需显示来自您自己的数据库或实时流（例如 Cloud Firestore 或 WebSocket）的实时 GPS 坐标和行程路径，请将 Maps JavaScript API 与高级标记（
AdvancedMarkerElement参考文档）和多段线（Polyline参考文档）搭配使用。为集成移动端 Driver SDK 和后端 OAuth 或 JSON Web 令牌 (JWT) 的拼车和预约配送车队预留 Fleet Engine。 - 路线规划和调度：使用 Routes 库。
- 如需计算包含经停点、行程时间、距离和通行费的路线，并在地图上绘制该路线，请使用
Route.computeRoutes()。 - 如需在多个出发地和目的地之间找到最近的司机、车辆或仓库，请使用
RouteMatrix.computeRouteMatrix()。 - 如需在服务器上为多辆车安排时间段，请使用 Route Optimization API。
- 如需计算包含经停点、行程时间、距离和通行费的路线，并在地图上绘制该路线，请使用
- 店铺定位工具和场馆地图：如需在地图上使用自定义图钉和过滤条件显示店铺、场馆或分支机构，请将高级标记（
AdvancedMarkerElement参考文档）与地点库搭配使用，以查找地点并加载其详细信息。 - 地图上的地理围栏和安全区半径：如需绘制圆形或多边形边界并测试坐标是否位于其中（请参阅地理围栏和安全区边界），请使用圆形（
Circle参考文档）、多边形（Polygon参考文档）和几何图形库（containsLocation()用于确定是否包含，computeDistanceBetween()用于确定以米为单位的距离）。
旧版 API 及其替代项
DirectionsService和DistanceMatrixService自 2026 年 2 月 25 日起已弃用。请改用Route和RouteMatrix。google.maps.Marker已于 2024 年 2 月 21 日弃用。请改用AdvancedMarkerElement。- 自 2025 年 3 月 1 日起，
PlacesService将不再向新客户提供。请改用Place类。