README

Craft CMS 的 Google Maps 插件

几分钟内创建地图。由 Google Maps API 提供支持。

地址字段 • 动态 & 静态地图 • 附近搜索 • 基于 IP 的地理位置

包含易于使用的地址字段

当管理 Craft 数据时，每个位置都可以设置一个方便的地址字段...

创建灵活的动态 & 静态地图

添加标记，使用信息窗口，设置地图样式，更改标记图标，应用 KML 层，等等...

通用 API

该插件具有强大的通用 API，在 JavaScript、Twig 和 PHP 中几乎完全相同！

搜索最近的位置

找到最近的位置，并按距离从近到远排序...

简单的基于 IP 的访客地理位置

根据访客设备的 IP 地址定位访客...

如何安装插件

通过插件商店安装

查看通过插件商店安装的完整说明...

通过控制台命令安装

要通过控制台安装 Google Maps 插件，请按照以下步骤操作

打开您的终端并转到您的 Craft 项目

cd /path/to/project

然后告诉 Composer 加载插件

composer require doublesecretagency/craft-googlemaps

然后告诉 Craft 安装插件

./craft plugin/install google-maps

或者，您也可以访问 设置 > 插件 页面以完成安装。如果通过控制面板安装，安装完成后会自动重定向到配置插件。

安装完成后，您需要添加 Google API 密钥...

简单的代码示例

这些示例仅仅触及了可能性的表面！

要获取完整详情，请查看官方插件文档...

添加动态地图

{# Get the entries #}
{% set entries = craft.entries.section('locations').all() %}

{# Place them on a dynamic map #}
{{ googleMaps.map(entries).tag() }}

完整的动态地图文档在这里...

添加静态地图

{# Get the entries #}
{% set entries = craft.entries.section('locations').all() %}

{# Place them on a static map #}
{{ googleMaps.img(entries).tag() }}

或直接使用 src 属性...

{# Get only the image URL of a static map #}
{% set src = googleMaps.img(entries).src() %}

{# Display the image tag manually #}
<img src="{{ src }}">

完整的静态地图文档在这里...

执行邻近搜索

{# Set the geocoding lookup target #}
{% set target = '123 Main St' %}

{# Get a set of entries, sorted by closest to target #}
{% set entries = craft.entries.myAddressField(target).orderBy('distance').all() %}

完整的邻近搜索文档在这里...

执行地址地理编码查找

{# Set the geocoding lookup target #}
{% set target = '123 Main St' %}

{# Get a set of geocoding results #}
{% set results = googleMaps.lookup(target).all() %}

完整的地理编码文档在这里...

定位访客

{# Get location data based on each visitor's IP address #}
{% set visitor = googleMaps.visitor %}

完整的地理位置文档在这里...

进一步阅读

如果您还没有，请翻阅完整的插件文档。上面的示例只是冰山一角，还有更多可能性！

如果您还有任何剩余的问题，欢迎通过我们（首选 Discord）联系我们。

代表Double Secret Agency，感谢您查看我们的插件！ 🍺

doublesecretagency / craft-googlemaps

维护者

详细信息