地图SDK

2.1.1 2018-12-24 06:45 UTC

This package is auto-updated.

Last update: 2024-09-24 21:12:05 UTC


README

用于获取地理编码和地理围栏的地图SDK。

安装

$ composer require rainsens/map -vvv

配置

在使用前,您必须从高德地图获取API密钥。

用法

use Rainsens\Map\Map;
$key = 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
$map = new Map($key);

一次性获取一个地理编码

$map->GeoCode->get('北京市朝阳区阜通东大街6号', '北京');
$map->GeoCode->get('北京市朝阳区阜通东大街6号', '北京', 'json');
$map->GeoCode->get('北京市朝阳区阜通东大街6号', '北京', 'xml');

一次性获取多个地理编码

$cities = [
    '北京市朝阳区阜通东大街6号',
    '北京市通州区运河东大街6号',
];

$map->GeoCode->get($cities, '北京');

示例

"status": "1",
"info": "OK",
"infocode": "10000",
"count": "1",
"geocodes": [
    {
        "formatted_address": "北京市朝阳区阜通东大街|6号",
        "country": "中国",
        "province": "北京市",
        "citycode": "010",
        "city": "北京市",
        "district": "朝阳区",
        "township": [],
        "neighborhood": {
            "name": [],
            "type": []
        },
        "building": {
            "name": [],
            "type": []
        },
        "adcode": "110105",
        "street": "阜通东大街",
        "number": "6号",
        "location": "116.483038,39.990633",
        "level": "门牌号"
    }
]
<response>
    <status>1</status>
    <info>OK</info>
    <infocode>10000</infocode>
    <count>1</count>
    <geocodes type="list">
        <geocode>
            <formatted_address>北京市朝阳区阜通东大街|6号</formatted_address>
            <country>中国</country>
            <province>北京市</province>
            <citycode>010</citycode>
            <city>北京市</city>
            <district>朝阳区</district>
            <township></township>
            <neighborhood>
                <name></name>
                <type></type>
            </neighborhood>
            <building>
                <name></name>
                <type></type>
            </building>
            <adcode>110105</adcode>
            <street>阜通东大街</street>
            <number>6号</number>
            <location>116.483038,39.990633</location>
            <level>门牌号</level>
        </geocode>
    </geocodes>
</response>

关于地理围栏

有关参数的详细信息,请参阅高德地图

$map->geoFence()->create([...]);
$map->geoFence()->search([...]);
$map->geoFence()->update([...]);
$map->geoFence()->enable(string $gid, bool $status = true);
$map->geoFence()->delete(string $gid);
$map->geoFence()->monitor([...]);

在Laravel中使用

使用相同的方式安装,并将API密钥放在config/services.php

    .
    .
    .
     'map' => [
        'key' => env('MAP_API_KEY'),
    ],

然后配置.env中的MAP_API_KEY

MAP_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Map::geoCode->get('北京市朝阳区阜通东大街6号', '北京');
Map::geoFence()->create([...]);
Map::geoFence()->search([...]);
Map::geoFence()->update([...]);
Map::geoFence()->enable(string $gid, bool $status = true);
Map::geoFence()->delete(string $gid);
Map::geoFence()->monitor([...]);

有关上述参数的详细信息,请参阅高德地图

参考

高德地图

贡献

您可以通过以下三种方式之一进行贡献

  1. 使用问题跟踪器提交错误报告。
  2. 问题跟踪器上回答问题或修复错误。
  3. 贡献新功能或更新wiki。

代码贡献过程并不非常正式。您只需确保遵循PSR-0、PSR-1和PSR-2编码规范。任何新的代码贡献都必须附带适用的单元测试。

许可证

MIT