jezzdk/statamic-google-maps

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

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

This package is auto-updated.

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


README

Statamic 4.0+ Latest Version on Packagist

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

安装

使用 Composer 安装。

composer require jezzdk/statamic-google-maps

发布资产

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

添加环境变量,因为此库在底层使用 Google Maps 显示地图。

GOOGLE_MAPS_API_KEY=""

最后,在页眉中插入此标记,以便在前端加载 Google 地图 JavaScript

{{ map_script }}

免责声明 如果您想创建 Google 地图 API 密钥,则需要 Google 的计费账户。如果您向 Google 提问,有很多关于如何设置它的指南。

使用方法

此插件提供 Google 地图字段类型。您可以在蓝图中使用它,使用户能够动态地将地图插入到您的网站上。

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

地图标签

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

{{ map lat="12.1234" lng="52.1234" }}

这将插入一个以给定坐标为中心的地图,缩放级别为 16,并使用路线图类型。地图标签支持以下属性

Google 地图字段(专业功能)

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

该字段有一些设置

  • 初始地图类型 - 选择地图加载到控制面板时应选择的地图类型
  • 初始缩放级别 - 选择地图加载到控制面板时的缩放级别
  • 启用地图类型选择器 - 允许用户选择地图类型
  • 启用标记创建 - 用户可以在地图上创建和删除标记
  • 启用地理编码器 - 这将在地图上方添加一个搜索字段,使用户能够搜索地址(必须启用 Google Cloud Console 中的地理编码器 API 以使其工作!)

当使用标记时,脚本将在 /public/assets/marker.png 寻找一个图标。如果存在,则使用它,否则将使用默认的 Google 地图图钉。

样式(专业功能)

可以使用 JSON 数组中的样式来设置地图。您可以在 https://mapstyle.withgoogle.com/(使用旧向导)或 https://snazzymaps.com/ 免费生成样式 JSON。

字段类型有一个按钮,可以揭示一个文本区域,可以在其中插入样式 JSON,地图标签也有一个 style 属性用于相同的目的。