timezone_location_get 函數返回的數據格式解析與處理方法

gitbox 2025-05-28

在PHP 中， timezone_location_get()是一個非常實用的函數，用於獲取指定時區的地理位置信息。它常用於需要根據時區數據進行地理定位或者展示時區相關信息的場景。本文將詳細解析timezone_location_get()函數的返回數據格式，並探討如何高效處理這些數據。

一、 timezone_location_get()函數簡介

timezone_location_get()函數接受一個DateTimeZone對像作為參數，返回該時區對應的地理位置信息數組。具體用法如下：

 $timezone = new DateTimeZone('Asia/Shanghai');
$location = timezone_location_get($timezone);
print_r($location);

二、返回數據格式詳解

該函數返回的是一個關聯數組，結構類似於：

 Array
(
    [country_code] => CN
    [latitude] => 31.22222
    [longitude] => 121.45806
    [comments] => Shanghai
)

country_code ：國家的ISO 3166-1 alpha-2 兩字母代碼。
latitude ：該時區中心點的緯度，浮點數，單位為度。
longitude ：該時區中心點的經度，浮點數，單位為度。
comments ：對該時區的簡短描述，通常是主要城市名。

三、如何高效處理這些數據

在實際應用中，往往需要對這些數據進行進一步的處理，比如：

轉換坐標格式（度分秒與十進制度之間轉換）
根據經緯度計算距離
結合國家代碼查詢國家名稱或標誌

1. 坐標格式轉換示例

function decimalToDMS($decimal) {
    $degrees = floor($decimal);
    $minutes = floor(($decimal - $degrees) * 60);
    $seconds = round((($decimal - $degrees) * 60 - $minutes) * 60, 2);
    return "{$degrees}°{$minutes}'{$seconds}\"";
}

$latDMS = decimalToDMS($location['latitude']);
$lngDMS = decimalToDMS($location['longitude']);
echo "Latitude: $latDMS, Longitude: $lngDMS";

2. 計算兩點間距離示例（哈弗辛公式）

 function haversineDistance($lat1, $lng1, $lat2, $lng2) {
    $earthRadius = 6371; // 地球半徑，單位為公里
    $dLat = deg2rad($lat2 - $lat1);
    $dLng = deg2rad($lng2 - $lng1);

    $a = sin($dLat / 2) * sin($dLat / 2) +
         cos(deg2rad($lat1)) * cos(deg2rad($lat2)) *
         sin($dLng / 2) * sin($dLng / 2);
    $c = 2 * atan2(sqrt($a), sqrt(1 - $a));
    return $earthRadius * $c;
}

// 示例：計算上海與北京之間的距離
$beijing = ['latitude' => 39.9042, 'longitude' => 116.4074];
$distance = haversineDistance($location['latitude'], $location['longitude'], $beijing['latitude'], $beijing['longitude']);
echo "上海與北京的距離約為 {$distance} 公里";

3. 結合國家代碼獲取國家信息

可以通過一個簡易數組或第三方庫將country_code轉換為完整國家名：

 $countryNames = [
    'CN' => '中國',
    'US' => '美國',
    'JP' => '日本',
    // 可根據需求擴展
];

$country = $countryNames[$location['country_code']] ?? '未知國家';
echo "時區所在國家：$country";

四、總結

timezone_location_get()函數提供的地理信息簡單直觀，適合快速獲取時區對應的地理坐標及國家代碼。結合簡單的坐標轉換及地理計算，可以滿足多種地理信息展示和處理需求。

 <?php
$timezone = new DateTimeZone('Asia/Shanghai');
$location = timezone_location_get($timezone);

function decimalToDMS($decimal) {
    $degrees = floor($decimal);
    $minutes = floor(($decimal - $degrees) * 60);
    $seconds = round((($decimal - $degrees) * 60 - $minutes) * 60, 2);
    return "{$degrees}°{$minutes}'{$seconds}\"";
}

$latDMS = decimalToDMS($location['latitude']);
$lngDMS = decimalToDMS($location['longitude']);

echo "時區地理信息:\n";
echo "國家代碼: " . $location['country_code'] . "\n";
echo "緯度: $latDMS\n";
echo "經度: $lngDMS\n";
echo "備註: " . $location['comments'] . "\n";

// 示例：計算與另一地點的距離
function haversineDistance($lat1, $lng1, $lat2, $lng2) {
    $earthRadius = 6371;
    $dLat = deg2rad($lat2 - $lat1);
    $dLng = deg2rad($lng2 - $lng1);
    $a = sin($dLat/2) * sin($dLat/2) +
        cos(deg2rad($lat1)) * cos(deg2rad($lat2)) *
        sin($dLng/2) * sin($dLng/2);
    $c = 2 * atan2(sqrt($a), sqrt(1-$a));
    return $earthRadius * $c;
}

$beijing = ['latitude' => 39.9042, 'longitude' => 116.4074];
$distance = haversineDistance($location['latitude'], $location['longitude'], $beijing['latitude'], $beijing['longitude']);
echo "上海與北京的距離約為 {$distance} 公里\n";

timezone_location_get