Link Search Menu Expand Document Documentation Menu
文档

使用自托管地图服务器

OpenSearch Dashboards 的自托管地图服务器允许用户在气隙环境中访问默认地图服务。OpenSearch 兼容的地图 URL 包含地图清单、地图切片和矢量数据。

以下部分提供了使用 OpenSearch Dashboards 设置和使用自托管地图服务器的步骤。

您可以通过 OpenSearch 官方 Docker Hub 仓库访问 maps-server 镜像。

拉取 Docker 镜像

打开您的终端并运行以下命令

docker pull opensearchproject/opensearch-maps-server:1.0.0

设置服务器

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

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

创建 Docker 卷以保存切片集

docker volume create tiles-data

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

  • 缩放级别 8 (https://maps.opensearch.org/offline/planet-osm-default-z0-z8.tar.gz)
  • 缩放级别 10 (https://maps.opensearch.org/offline/planet-osm-default-z0-z10.tar.gz)

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

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/ \
    opensearch/opensearch-maps-server \
    import

选项 2：生成栅格切片集

要生成栅格切片集，请使用栅格切片生成管道，然后使用切片集的绝对路径来创建卷以启动服务器。

启动服务器

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

docker run \
    -v tiles-data:/usr/src/app/public/tiles/data/ \
    -e HOST_URL='https://' \
    -p 8080:8080 \
    opensearch/opensearch-maps-server \
    run

或者，如果您生成了栅格切片集，请使用该切片集运行服务器

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

要访问切片集，请在主机上的浏览器中打开 URL，或使用 curl 命令 curl https://:8080/manifest.json。

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

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

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

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

选项 1：配置 opensearch_dashboards.yml

在 opensearch_dashboards.yml 中配置清单 URL

map.opensearchManifestServiceUrl: "https://:8080/manifest.json"

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

  1. 在 OpenSearch Dashboards 控制台上，选择 Dashboards Management > Advanced Settings。
  2. 在 Default WMS properties 下找到 visualization:tileMap:WMSdefaults。
  3. 将 "enabled": false 更改为 "enabled": true 并添加有效地图服务器的 URL。

许可证

切片是根据 Natural Earth 矢量地图数据的使用条款以及 OpenStreetMap 的版权和许可生成的。

剩余 350 字符

有问题？。

想贡献？或。