jezzdk / statamic-mapbox
此包最新版本(v2.1.0)没有可用的许可证信息。
v2.1.0
2024-01-18 21:45 UTC
README
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
属性用于相同的目的。