門店

創建門店

用 POI 接口新建門店時所使用的圖片 url 必須為微信自己域名的 url，因此需要先用上傳圖片接口上傳圖片并獲取 url，再創建門店。上傳的圖片限制文件大小限制 1MB,支持 JPG 格式，圖片接口請參考：臨時素材

$officialAccount->poi->create($baseInfo);

array $baseInfo。為門店的基本信息數組

使用示例：

<?php

$info = array(
    "sid"             => "33788392",
    "business_name"   => "麥當勞",
    "branch_name"     => "藝苑路店",
    "province"        => "廣東省",
    "city"            => "廣州市",
    "district"        => "海珠區",
    "address"         => "藝苑路 11 號",
    "telephone"       => "020-12345678",
    "categories"      => array("美食,快餐小吃"),
    "offset_type"     => 1,
    "longitude"       => 115.32375,
    "latitude"        => 25.097486,
    "photo_list"      => array(
        array("photo_url" => "https://XXX.com"),
        array("photo_url" => "https://XXX.com"),
    ),
    "recommend"       => "麥辣雞腿堡套餐,麥樂雞,全家桶",
    "special"         => "免費 wifi,外賣服務",
    "introduction"    => "麥當勞是全球大型跨國連鎖餐廳,1940 年創立于美國,在世界上大約擁有 3  萬間分店。主要售賣漢堡包,以及薯條、炸雞、汽水、冰品、沙拉、水果等 快餐食品",
    "open_time"       => "8:00-20:00",
    "avg_price"       => 35,
);

$result = $officialAccount->poi->create($info); // true or exception

注意：新創建的門店在審核通過后,會以事件形式推送給商戶填寫的回調 URL

獲取指定門店信息

$officialAccount->poi->get($poiId);

int $poiId。為門店ID

使用示例：

<?php

$info = $officialAccount->poi->get(271262077);

獲取門店列表

// begin: 0, limit: 10
$officialAccount->poi->list($begin, $limit);

int $begin 就是查詢起點，MySQL 里的 offset；
int $limit 查詢條數，同 MySQL 里的 limit；

兩參數均可選。

使用示例：

<?php

// 取 2 條記錄
$pois = $officialAccount->poi->list(0, 2);

// 獲取結果：
/*
[
    {
        "sid": "100",
        "poi_id": "271864249",
        "business_name": "麥當勞",
        "branch_name": "藝苑路店",
        "address": "藝苑路 11 號",
        "available_state": 3
    },
    {
        "sid": "101",
        "business_name": "麥當勞",
        "branch_name": "赤崗路店",
        "address": "赤崗路 102 號",
        "available_state": 4
    }
]
*/

修改門店信息

商戶可以通過該接口，修改門店的服務信息，包括：圖片列表、營業時間、推薦、特色服務、簡介、人均價格、電話 7 個字段。目前基礎字段包括(名稱、坐標、地址等不可修改)。

$officialAccount->poi->update($poiId, $baseInfo);

int $poiId。為門店 ID
array $baseInfo。需要更新的部分數據，若有填寫內容則為覆蓋更新，若無內容則視為不修改，維持原有內容。photo_list 字段為全列表覆蓋，若需要增加圖片，需將之前圖片同樣放入 list 中，在其后增加新增圖片。如：已有 A、B、C 三張圖片，又要增加 D、E 兩張圖，則需要調用該接口，在 photo_list 中傳入 A、B、C、D、E 五張圖片的鏈接。

使用示例：

<?php

$data = array(
    "telephone" => "020-12345678",
    "recommend" => "麥辣雞腿堡套餐,麥樂雞,全家桶",
    // ...
);

// true or exception
$res = $officialAccount->poi->update(271262077, $data);

刪除門店

$officialAccount->poi->delete($poiId);

使用示例：

// true or exception
$officialAccount->poi->delete(271262077);

easyswoole - 基于swoole扩展实现的一款高性能php框架

門店

創建門店

獲取指定門店信息

獲取門店列表

修改門店信息

刪除門店