利用php cURL來獲取騰訊地圖的相關資料

【前言】

在開發過程中，經常會用到地圖、定位、城市列表等相關的資料，這時候我們就需要呼叫騰訊地圖相應的介面來獲取這些資料。今天就說一下如何利用php的cURL函式來獲取這些資料。採用三個簡單的例子來說明：
1、獲取中國省市、城市列表
2、根據經緯度獲取該地點的相關資訊
3、根據詳細位置獲取該地點的經緯度

【php cURL】

cURL是一個利用URL語法規定來傳輸檔案和資料的工具，支援很多工具和協議。PHP 支援 Daniel Stenberg 建立的 libcurl 庫，能夠連線通訊各種伺服器、使用各種協議。libcurl 目前支援的協議有 http、https、ftp、gopher、telnet、dict、file、ldap。 libcurl 同時支援 HTTPS 證書、HTTP POST、HTTP PUT、 FTP 上傳(也能通過 PHP 的 FTP 擴充套件完成)、HTTP 基於表單的上傳、代理、cookies、使用者名稱+密碼的認證。

使用php cURL函式的基本思想：
1、先使用curl_init()初始化cURL會話，
2、接著通過curl_setopt()設定需要的全部選項
3、使用curl_exec()來執行會話
4、當執行完會話後使用curl_close()關閉會話。

簡單例子：

<?php
    $ch = curl_init("http://www.example.com/");
    curl_setopt($ch, CURLOPT_HEADER, 0);
    curl_exec($ch);
    curl_close($ch);
?>

【騰訊地圖API】

騰訊地圖Webservice API是基於HTTP協議的資料介面，開發者可以使用任何客戶端、伺服器和開發語言，按照騰訊地圖Webservice API規範，按需構建HTTP請求，並獲取結果資料。
前提：獲取騰訊地圖的相應資料之前，需要先去騰訊地圖API申請一個開發者金鑰。

具體資訊可以參考騰訊地圖API：騰訊地圖API

【程式碼實現（例子）】

1、獲取中國省市、城市列表：
*注：以下程式碼中出現的一些引數（例如result、name），需要參考騰訊地圖API呼叫相應介面之後的響應結果。

<?php
    //初始化cURL會話
    $ch = curl_init();
    //設定需要的選項
    curl_setopt($ch, CURLOPT_URL, "http://apis.map.qq.com/ws/district/v1/list?key=金鑰");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1
 
);  //將curl_exec()獲取的資訊以字串返回，而不是直接輸出
    $data = curl_exec($ch);
    $map = json_decode($data);
    $arr = $map->result;
    //輸出中國省市列表
    for ($i = 0; $i < 34; $i++) { 
        echo $arr[0][$i]->name." ";
    }
    echo "<br/><br/>";
    //輸出中國城市列表
    for ($i = 0; $i < 493; $i++) {
        echo $arr[1][$i]->name." ";
    }
    //echo json_encode($res, JSON_UNESCAPED_UNICODE);
    curl_close($ch);
?>

2、根據經緯度獲取該地點的相關資訊：

<?php
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, "http://apis.map.qq.com/ws/geocoder/v1/?location=39.984154,116.307490&key=金鑰");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    $data = curl_exec($ch);

    $map = json_decode($data);
    $res = $map->result;
    echo $res->address."<br/>";
    $ad_info = $res->ad_info;
    echo $ad_info->nation."<br/>";
    echo $ad_info->province."<br/>";
    echo $ad_info->district."<br/>";
?>

3、根據詳細位置獲取該地點的經緯度：

<?php
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, "http://apis.map.qq.com/ws/geocoder/v1/?address=湖南省張家界市永定區天門山鎮&key=金鑰");
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
    $data = curl_exec($ch);
    $map = json_decode($data);
    $location = $map->result->location;
    echo "經度:".$location->lng."<br/>";
    echo "緯度:".$location->lat."<br/>";
?>

*注：如何任何錯誤或者疑問歡迎指出