--- title: 位置情報 API slug: Web/API/Geolocation_API tags: - Geolocation API - Guide - Intermediate - Overview - ガイド - 位置情報 - 概要 translation_of: Web/API/Geolocation_API ---
位置情報 API を使用すると、ユーザーが望む場合には、自分の位置情報をウェブアプリケーションに提供することができます。プライバシー上の理由から、ユーザーは位置情報を報告する許可を求められます。
Geolocation オブジェクトを使用する WebExtension では、マニフェストに "geolocation"
パーミッションを追加しなければなりません。ユーザーのオペレーティングシステムは、最初に要求されたときに位置情報へのアクセスを許可するようにユーザーに促します。
ウェブアプリでユーザーの位置情報を取得したいと思うことはよくあります。例えば、ユーザーの位置を地図上にプロットしたり、ユーザーの位置に関連するパーソナライズされた情報を表示したりすることができます。
位置情報 APIは {{domxref("Navigator.geolocation", "navigator.geolocation")}} への呼び出しを介してアクセスします。これにより、ブラウザーはユーザーに自分の位置情報にアクセスする許可を要求します。ユーザーが許可すると、ブラウザーは端末上で利用可能な最良の機能を使用してこの情報にアクセスします (GPS など)。
開発者は、いくつかの異なる方法でこの位置情報にアクセスできるようになりました。
どちらの場合も、メソッド呼び出しには最大3つの引数を取ります。
位置情報の使用に関するさらなる情報は、位置情報 API の使用を参照してください。
GeolocationPosition
インスタンスは、 {{domxref("Geolocation")}} に含まれるメソッドのいずれかの呼び出しが成功した場合に、成功コールバックの内部で返され、タイムスタンプと {{domxref("GeolocationCoordinates")}} オブジェクトのインスタンスが含まれます。GeolocationCoordinates
のインスタンスには、緯度、経度、その他の重要な関連情報が含まれています。GeolocationPositionError
は、 {{domxref("Geolocation")}} に含まれるメソッドのいずれかの呼び出しに失敗した場合、エラーコールバック内で返され、エラーコードとメッセージが含まれています。{{page("/ja/docs/Web/API/Geolocation_API/Using_the_Geolocation_API","Examples")}}
仕様書 | 状態 | 備考 |
---|---|---|
{{SpecName("Geolocation")}} | {{Spec2("Geolocation")}} |
{{Compat("api.Geolocation")}}
WiFi ベースの測位は Google が提供することが多いため、中国ではバニラの位置情報 API が利用できない場合があります。 Baidu, Autonavi, Tencent などの地域ののサードパーティプロバイダを使用することができます。これらのサービスは、ユーザーの IP アドレスおよび/またはローカルアプリを使用して、より高度な位置情報を提供します。