jezzdk/statamic-mapbox

此包最新版本(v2.1.0)没有可用的许可证信息。

v2.1.0 2024-01-18 21:45 UTC

This package is auto-updated.

Last update: 2024-09-18 23:22:47 UTC


README

Statamic 4.0+ Latest Version on Packagist

Statamic V4 的 Mapbox 插件,用于在网站上创建和显示 Mapbox 地图。

安装

使用 Composer 需求它。

composer require jezzdk/statamic-mapbox

发布配置文件

php artisan vendor:publish --provider="Jezzdk\StatamicMapbox\ServiceProvider"

添加一个环境变量,因为这个库在底层使用 Mapbox 来显示地图。

MAPBOX_API_KEY=""

最后,在头部插入此标签以在前端加载 Mapbox JavaScript

{{ mapbox_script }}

免责声明 如果您想创建 API 密钥,则需要 Mapbox 账户。

使用方法

此插件提供 Mapbox 字段(专业功能)。您可以在蓝图中使用它,这将使用户能够动态地将地图插入到您的网站上。

还有可以直接在 Antlers 模板中使用的标签。以下将解释这两种用法。

Mapbox 标签

插入地图的最简单方法是插入具有经纬度的标签

<div style="width: 500px; height: 400px">
    {{ mapbox lng="12.1234" lat="52.1234" zoom="8" marker="true" showControls="true" }}
</div>

这将插入一个以给定坐标为中心的地图并显示标记。Mapbox 标签支持以下属性

Mapbox 字段(专业功能)

只需在创建蓝图时选择字段类型。当用户在地图上移动、更改缩放级别或更改地图类型时,设置将被保存,输出将显示在控制面板中选择的相同视图。

该字段有一些设置

  • 初始地图类型 - 选择地图加载到控制面板时应选择的地图类型
  • 初始缩放级别 - 选择地图加载到控制面板时的缩放级别
  • 启用地图类型选择器 - 允许用户选择地图类型
  • 启用标记创建 - 用户可以在地图上创建和删除标记
  • 启用地理编码器 - 这在地图上添加一个搜索字段,使用户能够搜索例如地址

当使用标记时,脚本将在 /public/assets/marker.png 处查找图标。如果存在,它将使用它,否则它将使用默认的 Mapbox 图钉。

样式(专业功能)

可以使用特定的 Mapbox 样式 URL 来样式化地图。您可以在 https://studio.mapbox.com/ 上免费生成样式并获取 URL。

该字段有一个输入字段,可以插入样式 URL,当地图类型设置为 custom 时。Mapbox 标签有一个 style 属性用于相同的目的。