opensearchproject/opensearch-maps-server

OpenSearch Maps Server Docker镜像文档

快速参考

维护者：https://github.com/opensearch-project
需要帮助？ 在我们的https://forum.opensearch.org/%E6%8F%90%E9%97%AE%E5%92%8C%E8%AE%A8%E8%AE%BA
需要提交问题？ 使用我们的https://github.com/opensearch-project/opensearch-build/issues%E6%8A%A5%E5%91%8A%E5%9C%B0%E5%9B%BE%E6%9C%8D%E5%8A%A1%E5%99%A8%E6%9E%84%E5%BB%BA%E6%88%96Docker%E9%95%9C%E5%83%8F%E7%9A%84%E9%97%AE%E9%A2%98

什么是OpenSearch Maps Server？

OpenSearch Dashboards的自托管地图服务器允许用户在隔离环境中访问默认地图服务。与OpenSearch兼容的地图URL包括包含地图瓦片和矢量的地图清单、地图瓦片以及地图矢量。

如何拉取此镜像？

您可以像拉取其他任何镜像一样拉取OpenSearch Maps Server Docker镜像：

bash
docker pull docker.xuanyuan.run/opensearch/opensearch-maps-server

查看DockerHub获取https://hub.docker.com/r/opensearchproject/opensearch-maps-server/tags%E3%80%82

如何使用此镜像？

设置服务器

在运行服务器之前，必须设置地图瓦片。您有两种设置选项：使用OpenSearch提供的地图服务瓦片集，或生成光栅瓦片集。

选项1：使用OpenSearch提供的地图服务瓦片集

创建一个Docker卷来存储瓦片集：

bash
docker volume create tiles-data

从OpenSearch地图服务下载瓦片集。根据所需的缩放级别，有两个全球瓦片集可用：

• 缩放级别8（https://maps.opensearch.org/offline/planet-osm-default-z0-z8.tar.gz%EF%BC%89
• 缩放级别10（https://maps.opensearch.org/offline/planet-osm-default-z0-z10.tar.gz%EF%BC%89

注意：缩放级别10的全球瓦片集（压缩后2 GB/未压缩6.8 GB）大约是缩放级别8瓦片集（压缩后225 MB/未压缩519 MB）的10倍大。

bash
docker run \
    -e DOWNLOAD_TILES=https://maps.opensearch.org/offline/planet-osm-default-z0-z8.tar.gz \
    -v tiles-data:/usr/src/app/public/tiles/data/ \
    docker.xuanyuan.run/opensearch/opensearch-maps-server \
    import

选项2：生成光栅瓦片集

要生成光栅瓦片集，请使用https://github.com/opensearch-project/maps/tree/main/tiles-generation/cdk%EF%BC%8C%E7%84%B6%E5%90%8E%E4%BD%BF%E7%94%A8%E7%93%A6%E7%89%87%E9%9B%86%E7%9A%84%E7%BB%9D%E5%AF%B9%E8%B7%AF%E5%BE%84%E5%88%9B%E5%BB%BA%E5%8D%B7%E4%BB%A5%E5%90%AF%E5%8A%A8%E6%9C%8D%E5%8A%A1%E5%99%A8%E3%80%82

启动服务器

使用以下命令通过Docker卷tiles-data启动服务器。以下命令是使用主机URL "localhost"和端口"8080"的示例：

bash
docker run \
    -v tiles-data:/usr/src/app/public/tiles/data/ \
    -e HOST_URL='http://localhost' \
    -p 8080:8080 \
    docker.xuanyuan.run/opensearch/opensearch-maps-server \
    run

或者，如果您生成了光栅瓦片集，使用该瓦片集运行服务器：

bash
docker run \
    -v /absolute/path/to/tiles/:/usr/src/app/dist/public/tiles/data/ \
    -p 8080:8080 \
    docker.xuanyuan.run/opensearch/opensearch-maps-server \
    run

要访问瓦片集，请在主机的浏览器中打开URL或使用curl命令，例如curl http://localhost:8080/manifest.json。

通过在主机的浏览器中打开以下每个链接或使用curl命令（例如curl http://localhost:8080/manifest.json）确认服务器正在运行：

• 地图清单URL：http://localhost:8080/manifest.json
• 地图瓦片URL：http://localhost:8080/tiles/data/{z}/{x}/{y}.png
• 地图瓦片演示URL：http://localhost:8080/

与OpenSearch Dashboards配合使用自托管地图服务器

您可以通过向opensearch_dashboards.yml添加参数或在OpenSearch Dashboards中配置默认WMS属性来将自托管地图服务器与OpenSearch Dashboards配合使用。

选项1：配置opensearch_dashboards.yml

在opensearch_dashboards.yml中配置清单URL：

yaml
map.opensearchManifestServiceUrl: "http://localhost:8080/manifest.json"

选项2：在OpenSearch Dashboards中配置默认WMS属性

1. 在OpenSearch Dashboards控制台，选择堆栈管理 > 高级设置。
2. 在默认WMS属性下找到visualization:tileMap:WMSdefaults。
3. 将"enabled": false更改为"enabled": true并添加有效的地图服务器URL。

相关链接

• 配置WMS地图服务器
• 区域地图可视化

OpenSearch Maps Server的许可证

OpenSearch Maps Server根据http://www.apache.org/licenses/LICENSE-2.0.html%E8%8E%B7%E5%BE%97%E8%AE%B8%E5%8F%AF%E3%80%82%E7%93%A6%E7%89%87%E6%A0%B9%E6%8D%AENatural Earth矢量地图数据使用条款和https://www.openstreetmap.org/copyright%E7%94%9F%E6%88%90%E3%80%82

如何贡献？

OpenSearch现在和将来都将100%基于Apache 2.0许可证开源。随着项目的发展，我们希望您能加入我们并做出贡献。我们希望让您轻松入门并减少摩擦——无需冗长的贡献者许可协议——这样您就可以专注于编写优秀的代码。查看https://opensearch.org/%E7%BD%91%E7%AB%99%E4%BA%86%E8%A7%A3%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%E3%80%82