pixelastronauts/statamic-autocomplete-address-field

Statamic 地址字段插件,集成 Google Maps 自动完成功能

dev-main 2024-06-18 07:54 UTC

This package is auto-updated.

Last update: 2024-09-18 08:24:14 UTC


README

Statamic 自动完成地址字段是 Statamic CMS 的一款强大插件,集成了简单易用且高效的地址输入字段,包含 Google Maps 自动完成功能。此工具简化了在 CMS 中直接输入和存储详细地址数据的过程。

主要功能

  • Google Maps 自动完成:增强文本输入字段,利用 Google Maps 实现地址自动完成功能。
  • 全面数据存储:自动存储详细地址信息和地理坐标。例如,数据结构包括
    • street_number:例如,"42A"
    • route:例如,"Prinsestraat"
    • locality:例如,"Den Haag"
    • administrative_area_level_1:例如,"Zuid-Holland"
    • country:例如,"Nederland"
    • postal_code:例如,"2513 CE"
    • formatted_address:例如,"Prinsestraat 42A, 2513 CE Den Haag, Nederland"
    • 坐标:
      • 纬度: 52.0787948
      • 经度: 4.305637
  • 可配置选项:允许在字段集设置中进行特定国家的配置。

安装

要安装 Statamic 地址字段,您可以使用 Statamic 控制面板或命令行界面

  • 通过控制面板:在 Statamic 控制面板中导航到 工具 > 插件,搜索 "Address Field",然后点击 安装
  • 通过命令行:
    composer require pixelastronauts/address-field

用法

要使用地址字段插件

  1. API 密钥设置:确保将 'GOOGLE_PLACES_API_KEY' 添加到项目的 .env 文件,并正确限制。
  2. 字段配置:根据需要,在字段集配置文件中配置所需的国家和其他设置。
  3. 集成:将地址字段添加到 Statamic 中相关的模板或蓝图内,它将自动包含 Google Maps 自动完成功能。

此插件极大地简化了地址输入并提高了数据准确性。