GoogleMapsGeocoder 使用与技术文档

1. 安装指南

使用 Composer 安装

推荐使用 Composer 进行安装，Composer 是一个 PHP 的依赖管理工具。只需将 jstayton/google-maps-geocoder 添加到您的项目 composer.json 文件中：

{
    "require": {
        "jstayton/google-maps-geocoder": "*"
    }
}

更多详细内容可以在 Packagist 上找到。

手动安装

1. 将 src/GoogleMapsGeocoder.php 文件复制到您的代码库中，可以放置在 vendor 目录下。
2. 将 GoogleMapsGeocoder 类添加到您的自动加载器中或直接 require 这个文件。

2. 项目使用说明

以下示例使用 Monk Development 的地址：

$address = "2707 Congress St., San Diego, CA 92110";

有两种方法可以设置 GoogleMapsGeocoder 对象的地址。一种是将地址传递给构造函数：

$Geocoder = new GoogleMapsGeocoder($address);

另一种是在创建对象后设置地址：

$Geocoder = new GoogleMapsGeocoder();
$Geocoder->setAddress($address);

默认情况下，format 设置为 json，sensor 设置为 false。这些值可以在构造函数中或创建对象后更改。有关可更改的完整 API 参数列表，请参阅文档。

设置所有参数后，最后一步是向 Google Maps Geocoding API 发送请求：

$response = $Geocoder->geocode();

geocode 方法会将响应转换为 JSON 关联数组（默认）或 SimpleXMLElement 对象，具体取决于指定的 format。有关通过 HTTPS 发送请求或防止转换（而是返回原始纯文本响应）的详细信息，请参阅 geocode 文档。

3. 项目API使用文档

GoogleMapsGeocoder 类提供了以下API方法：

• geocode: 用于向 Google Maps Geocoding API 发送请求并获取响应。
• setAddress: 用于设置要编码的地址。
• setFormat: 用于设置响应格式。
• setSensor: 用于设置是否为传感器。

更多方法和详细信息，请参考官方文档。

4. 项目安装方式

请遵循上述的安装指南进行项目的安装。推荐使用 Composer 进行安装，以便更好地管理项目依赖。