README

构建状态

简介

现代、面向对象，用于使用Google的Places API的客户端，需要PHP v7.1+。支持任何PSR-7（HTTP消息接口）和PSR-17（HTTP工厂）实现（并且是必需的）。支持通过任何PSR-16（简单缓存）实现进行缓存，也支持任何HTTPlug客户端/适配器。

安装

composer require gplacesphp/api-client

用法

此示例使用php-http/guzzle6-adapter作为PSR-18实现，使用zendframework/zend-diactoros作为PSR-7/PSR-17实现。支持任何其他PSR-7/PSR-17/PSR-18实现。如果您还没有安装它们，您将需要运行

composer require \
    guzzlehttp/guzzle \
    php-http/guzzle6-adapter \
    zendframework/zend-diactoros

请记住将<YOUR_API_KEY>替换为您自己的密钥。

更多用法示例在examples目录中。

地点详情

基本示例

<?php

require_once __DIR__ . '/vendor/autoload.php';

$apiKey = '<YOUR_API_KEY>';
$guzzle = new \GuzzleHttp\Client();
$httpClient = new \Http\Adapter\Guzzle6\Client($guzzle);
$requestFactory = new \Zend\Diactoros\RequestFactory();

$client = \GPlacesPhp\ApiClient\Client::create(
    $apiKey,
    $httpClient,
    $requestFactory
);

$placeDetails = $client->placeDetails('ChIJAZ-GmmbMHkcR_NPqiCq-8HI'); // Warsaw

var_dump($placeDetails);

查找地点

基本示例

<?php

require_once __DIR__ . '/vendor/autoload.php';

$apiKey = '<YOUR_API_KEY>';
$guzzle = new \GuzzleHttp\Client();
$httpClient = new \Http\Adapter\Guzzle6\Client($guzzle);
$requestFactory = new \Zend\Diactoros\RequestFactory();

$client = \GPlacesPhp\ApiClient\Client::create(
    $apiKey,
    $httpClient,
    $requestFactory
);

$findPlace = $client->findPlace('Warszawa, Polska'); // Warsaw

var_dump($findPlace);

待办事项

在稳定版v1发布之前要完成的事情

• 地点详情
• 缓存地点详情
• 地点搜索
  • 查找地点
  • 附近搜索
  • 文本搜索
• 缓存地点搜索
  • 查找地点
  • 附近搜索
  • 文本搜索
• 地点照片
• 缓存地点照片
• 使用PSR-18代替HTTPlug

许可证

此软件包是免费软件，根据MIT许可证的条款分发。