code init

Author: zds-s

.gitignore

@@ -0,0 +1,4 @@
+vendor
+index.php
+.idea
+composer.lock

README.md

@@ -0,0 +1,50 @@
+# 腾讯地图webservices的php封装
+## 安装
+
+---
+```shell
+composer require death_satan/tencent-map-api -vvv
+```
+---
+
+## 使用
+
+---
+```php
+$key = '';//腾讯地图key
+$app = new \DeathSatan\TencentMapApi\Application($key);
+
+//地址转经纬度
+$data=$app->api()->addressResolution('北京市');
+var_dump($data);
+/**
+* echo 
+ * 
+    ["adcode"]=>
+    string(6) "110114"
+  }
+  ["address_components"]=>
+  array(5) {
+    ["province"]=>
+    string(9) "北京市"
+    ["city"]=>
+    string(9) "北京市"
+    ["district"]=>
+    string(9) "昌平区"
+    ["street"]=>
+    string(0) ""
+    ["street_number"]=>
+    string(0) ""
+  }
+  ["similarity"]=>
+  float(0.8)
+  ["deviation"]=>
+  int(1000)
+  ["reliability"]=>
+  int(1)
+  ["level"]=>
+  int(2)
+}
+ */
+```
+---

composer.json

@@ -0,0 +1,22 @@
+{
+    "name": "death_satan/tencent-map-api",
+    "description": "tencent map services api,based on GuzzleHttp",
+    "type": "library",
+    "require": {
+        "guzzlehttp/guzzle": "7.4.x-dev",
+        "ext-json": "*"
+    },
+    "license": "MIT",
+    "autoload": {
+        "psr-4": {
+            "DeathSatan\\TencentMapApi\\": "src/"
+        }
+    },
+    "authors": [
+        {
+            "name": "ShuSRun",
+            "email": "[email protected]"
+        }
+    ],
+    "minimum-stability": "dev"
+}

src/Application.php

@@ -0,0 +1,72 @@
+<?php
+
+namespace DeathSatan\TencentMapApi;
+
+use DeathSatan\TencentMapApi\Exception\FailException;
+use GuzzleHttp\Client;
+
+/**
+ * 管理中心
+ */
+class Application
+{
+    /**
+     * 当前版本
+     */
+    public const VERSION = '1.0';
+
+    /**
+     * guzzleHttp客户端
+     * @var Client
+     */
+    protected $client;
+
+    protected $key;
+
+    /**
+     * 默认配置
+     * @var array
+     */
+    protected $default_config = [
+        //基础域名
+        'base_uri'=>'https://apis.map.qq.com/ws/',
+        //是否进行ssl验证
+        'verify'=>false,
+        //请求超时的秒数
+        'timeout'=>5.0,
+    ];
+
+    /**
+     * @param string|null $key api请求所需要的key
+     * @param array $config guzzleHttp Client客户端配置,传空使用默认配置
+     * @throws FailException
+     */
+    public function __construct(?string $key=null,array $config=[])
+    {
+        if (empty($key)){
+            throw new FailException('Configuration item key required');
+        }
+        $this->key = $key;
+        $config = array_merge($this->default_config,$config);
+        $this->client = new Client($config);
+    }
+
+    /**
+     * @return Client
+     */
+    public function getClient(): Client
+    {
+        return $this->client;
+    }
+
+    /**
+     * 获取api请求类
+     * @return Server
+     */
+    public function api()
+    {
+        return new Server(
+            (new Request($this->key,$this->client))
+        );
+    }
+}

src/Exception/FailException.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace DeathSatan\TencentMapApi\Exception;
+
+/**
+ * 基础错误信息异常
+ */
+class FailException extends \Exception
+{
+
+}

src/Exception/ServerException.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace DeathSatan\TencentMapApi\Exception;
+
+/**
+ * 服务端异常
+ */
+class ServerException extends \Exception
+{
+
+}

src/Request.php

@@ -0,0 +1,69 @@
+<?php
+
+namespace DeathSatan\TencentMapApi;
+
+use DeathSatan\TencentMapApi\Exception\ServerException;
+use GuzzleHttp\Client;
+use GuzzleHttp\Exception\GuzzleException;
+
+/**
+ * api操作类
+ */
+final class Request
+{
+    /**
+     * @var string
+     */
+    protected $key;
+
+    /**
+     * @var Client
+     */
+    protected $client;
+
+    protected $response;
+
+    public function __construct($key,Client $client)
+    {
+        $this->key = $key;
+        $this->client = $client;
+    }
+
+    /**
+     * 发送get请求
+     * @throws GuzzleException
+     */
+    public function get($url, $data=[]): Response
+    {
+        return $this->beforeResponse(
+            $this->client->request('get',$url,[
+                'query'=>array_merge($data,[
+                    'key'=>$this->key
+                ])
+            ])
+        );
+    }
+
+    /**
+     * 请求后前置处理response
+     * @param \GuzzleHttp\Psr7\Response $response
+     * @return Response
+     */
+    protected function beforeResponse(\GuzzleHttp\Psr7\Response $response): Response
+    {
+        $this->response = new Response($response);
+        if ($this->response['status']!==0){
+            throw new ServerException($this->response['message']);
+        }
+        return $this->response();
+    }
+
+    /**
+     * 获取相应
+     * @return Response
+     */
+    private function response(): Response
+    {
+        return $this->response;
+    }
+}

src/Response.php

@@ -0,0 +1,62 @@
+<?php
+
+namespace DeathSatan\TencentMapApi;
+
+use JetBrains\PhpStorm\Internal\LanguageLevelTypeAware;
+use JetBrains\PhpStorm\Internal\TentativeType;
+
+/**
+ * 响应类
+ */
+class Response implements \ArrayAccess
+{
+    /**
+     * @var \GuzzleHttp\Psr7\Response
+     */
+    protected $response;
+
+    /**
+     * @var array
+     */
+    protected $data;
+
+    public function __construct(\GuzzleHttp\Psr7\Response $response)
+    {
+        $this->response = $response;
+        $this->data = json_decode($this->rawData(),JSON_UNESCAPED_UNICODE);
+    }
+
+    protected function rawData()
+    {
+        return (string)$this->response->getBody();
+    }
+
+    /**
+     * 获取数组
+     * @return array
+     */
+    public function toArray():array
+    {
+        return $this->data['result'];
+    }
+
+    public function offsetExists($offset)
+    {
+        return empty($this->data[$offset]);
+    }
+
+    public function offsetGet($offset)
+    {
+        return $this->data[$offset];
+    }
+
+    public function offsetSet($offset, $value)
+    {
+        $this->data[$offset]=$value;
+    }
+
+    public function offsetUnset($offset)
+    {
+        unset($this->data[$offset]);
+    }
+}