README

提供使用 Silverstripe 框架在 PHP 中进行地理编码的安全且简单的包装器。

功能

• 安全检测和防止超出每日请求限制。这应该有助于避免在达到每日限制后您的 IP 被谷歌屏蔽。

• 缓存请求以防止不必要的 API 调用。

致谢和作者

• Damian Mooyman - https://github.com/tractorcow/silverstripe-geocoding

要求

• SilverStripe 3 或更高版本
• PHP 5.3

安装说明

将所有文件解压到您的 Silverstripe 根目录下的 'geocoding' 文件夹中，或使用 composer 进行安装

composer require "tractorcow/silverstripe-geocoding": "3.0.*@dev"

用法

// Instance is explicitly created here, but it's better to have this as an injected dependency
$address = '123 Fake Street, Fakuranga, New Fakeland';
$service = Injector::inst()->get('GeocodingService');
$result = $service->geocode($address);

if($result['Success']) {
	$latitude = $result['Latitude'];
	$longitude = $result['Longitude'];
	echo "Found address at $latitude,$longitude";
} else {
	user_error("Could not geocode address: ".$result['Message'], E_USER_ERROR);
}

需要更多帮助？

给我发消息或邮件至 damian.mooyman@gmail.com，或者，好吧，看看代码吧！

许可

版权（c）2013，Damian Mooyman。保留所有权利。

所有权利保留。

在不违反以下条件的情况下，允许以源代码和二进制形式重新分发和使用，无论是否修改：

• 源代码重新分发必须保留上述版权声明、本许可证条款和以下免责声明。
• 以二进制形式重新分发必须在不修改的情况下复制上述版权声明、本许可证条款和以下免责声明，包括但不限于在随分发提供的文档或其他材料中。
• 未经事先书面许可，不得使用 Damian Mooyman 的姓名认可或推广源自本软件的产品。

本软件由版权所有者和贡献者“按原样”提供，不提供任何明示或暗示的保证，包括但不限于适销性和针对特定目的的适用性的暗示保证。在任何情况下，无论由于何种原因或理论上的责任，均不承担任何直接、间接、偶然、特殊、示范性或后果性的损害赔偿（包括但不限于替代商品或服务的采购；使用、数据或利润的损失；或业务中断），即使已被告知本软件存在此类损害的可能性。