PHPでtimezone_location_get関数を使用して、現在のタイムゾーンの地理的位置情報を正確に取得する方法は？

gitbox 2025-07-17

PHP開発では、現在のタイムゾーンに基づいて地理的位置情報を取得する必要があることがよくあります。 PHPは、 TimeZone_Location_Get関数を提供して、タイムゾーンオブジェクトからタイムゾーンに関連する地理的位置情報を取得します。この機能は、現在のタイムゾーンの地理的位置を正確に見つけるのに役立つだけでなく、一部のタイムゾーンベースのアプリケーション（ログ、ユーザーポジショニングなど）の貴重なデータを提供します。

timezone_location_get関数の紹介

TimeZone_Location_Getは、PHPの組み込み関数であり、TimeZoneオブジェクト（ TimeZone_openまたはnew DatetimeZone（）によって作成されたタイムゾーンに関する位置情報を取得します。返された結果には、タイムゾーンの2つの主要なプロパティが含まれています：国コード（ISO 3166-1アルファ-2）と都市名。

関数プロトタイプ

<span><span><span class="hljs-title function_ invoke__">timezone_location_get</span></span><span>(DateTimeZone </span><span><span class="hljs-variable">$timezone</span></span><span>): </span><span><span class="hljs-keyword">array</span></span><span>|</span><span><span class="hljs-literal">false</span></span><span>
</span></span>

パラメーター：
- $ TIMEZONE ：必須。ジオロケーション情報を取得するためのタイムゾーンを表す有効なDateTimeZoneオブジェクト。
返品値：
- 成功した場合は、2つのフィールドを含むジオロケーション情報を含む連想配列を返します。
  - Country_code ：タイムゾーンに対応する国コード（米国など、米国、 CNは中国を意味します）。
  - 緯度：タイムゾーンの緯度。
  - 経度：タイムゾーンの経度。
- 買収が失敗した場合、 falseを返します。

timezone_location_get関数の使用方法

以下は、 TimeZone_Location_Get関数を使用して現在のタイムゾーンの地理的位置情報を取得する方法を示す簡単な例です。

例1：現在のタイムゾーンの地理情報を取得する

<span><span><span class="hljs-meta">&lt;?php</span></span><span>
</span><span><span class="hljs-comment">// 現在のタイムゾーンを取得します</span></span><span>
</span><span><span class="hljs-variable">$timezone</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title class_">DateTimeZone</span></span><span>(</span><span><span class="hljs-title function_ invoke__">date_default_timezone_get</span></span><span>());

</span><span><span class="hljs-comment">// タイムゾーンの地理的位置情報を取得します</span></span><span>
</span><span><span class="hljs-variable">$location</span></span><span> = </span><span><span class="hljs-title function_ invoke__">timezone_location_get</span></span><span>(</span><span><span class="hljs-variable">$timezone</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$location</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"国コード： "</span></span><span> . </span><span><span class="hljs-variable">$location</span></span><span>[</span><span><span class="hljs-string">'country_code'</span></span><span>] . </span><span><span class="hljs-string">"\n"</span></span><span>;
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"市： "</span></span><span> . </span><span><span class="hljs-variable">$location</span></span><span>[</span><span><span class="hljs-string">'city'</span></span><span>] . </span><span><span class="hljs-string">"\n"</span></span><span>;
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"緯度： "</span></span><span> . </span><span><span class="hljs-variable">$location</span></span><span>[</span><span><span class="hljs-string">'latitude'</span></span><span>] . </span><span><span class="hljs-string">"\n"</span></span><span>;
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"経度： "</span></span><span> . </span><span><span class="hljs-variable">$location</span></span><span>[</span><span><span class="hljs-string">'longitude'</span></span><span>] . </span><span><span class="hljs-string">"\n"</span></span><span>;
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"无法タイムゾーンの地理的位置情報を取得します。\n"</span></span><span>;
}
</span><span><span class="hljs-meta">?&gt;</span></span><span>
</span></span>

出力の例

現在のタイムゾーンがアジア/上海であると仮定すると、出力は次のとおりです。

 <span><span>国コード： CN
市： Shanghai
緯度： 31.2304
経度： 121.4737
</span></span>

注意すべきこと

タイムゾーンの選択： TimeZone_Location_Getによって返される地理的位置情報は、タイムゾーンに関連しています。したがって、タイムゾーンの設定（ date_default_timezone_setまたはnew DateTimeZone（）を介して）は、得られた結果に直接影響します。タイムゾーンが正しく設定されていることを確認してください。そうしないと、目的の位置情報が取得されない場合があります。
地理的情報の正確性：返された位置情報は、タイムゾーンの中央エリアに基づいており、タイムゾーンを使用してすべての都市を完全に反映していない場合があります。たとえば、ヨーロッパ/パリのタイムゾーンの位置情報は、パリの緯度と経度に戻りますが、そのタイムゾーンにあるすべての都市の正確な位置を表していない場合があります。
エラー処理：場合によっては、 timezone_location_getがfalseを返す場合があります。したがって、この関数を使用するときは、必ずエラー処理を実行してください。

要約します

TimeZone_Location_Get関数は、PHP開発者がタイムゾーンに基づいて正確な地理配置情報を取得するのに役立つシンプルで効果的なツールです。この関数を使用することにより、タイムゾーンに関連する地理的データをより適切に処理し、よりインテリジェントで正確な機能をアプリケーションに提供できます。ただし、使用する場合は、タイムゾーンの設定と可能なエラー範囲の精度に注意を払う必要があります。

timezone_location_get