From bb64b32a18916aeece12ffe137abec893095a299 Mon Sep 17 00:00:00 2001 From: Masahiro FUJIMOTO Date: Thu, 3 Feb 2022 01:17:08 +0900 Subject: 2021/10/11 時点の英語版に同期 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../ja/web/api/geolocation/watchposition/index.md | 98 ++++++++++------------ 1 file changed, 43 insertions(+), 55 deletions(-) (limited to 'files/ja/web/api') diff --git a/files/ja/web/api/geolocation/watchposition/index.md b/files/ja/web/api/geolocation/watchposition/index.md index cb7f4b91a4..83f37ebf15 100644 --- a/files/ja/web/api/geolocation/watchposition/index.md +++ b/files/ja/web/api/geolocation/watchposition/index.md @@ -4,43 +4,48 @@ slug: Web/API/Geolocation/watchPosition tags: - API - Geolocation - - Geolocation API - - Method - - Reference - - Secure context + - 位置情報 API + - メソッド + - リファレンス + - 安全なコンテキスト +browser-compat: api.Geolocation.watchPosition translation_of: Web/API/Geolocation/watchPosition --- -

{{securecontext_header}}{{ APIref("Geolocation API") }}

+{{securecontext_header}}{{ APIref("Geolocation API") }} -

{{domxref("Geolocation")}} の watchPosition() メソッドは、端末の位置が変化するたびに自動的に呼び出されるハンドラー関数を登録するために用いられます。また必要に応じてエラー処理コールバック関数を指定することができます。

+{{domxref("Geolocation")}} の **`watchPosition()`** メソッドは、端末の位置が変化するたびに自動的に呼び出されるハンドラー関数を登録するために用いられます。また必要に応じてエラー処理コールバック関数を指定することができます。 -

構文

+## 構文 -
navigator.geolocation.watchPosition(success[, error[, options]])
+```js +navigator.geolocation.watchPosition(success) +navigator.geolocation.watchPosition(success, error) +navigator.geolocation.watchPosition(success, error, options) +``` -

引数

+### 引数 -
-
success
-
コールバック関数で、 {{domxref("GeolocationPosition")}} オブジェクトを入力引数として受け取るものです。
-
error {{optional_inline}}
-
任意のコールバック関数で、 {{domxref("GeolocationPositionError")}} オブジェクトを入力引数として受け取るものです。
-
options {{optional_inline}}
-
任意の {{domxref("PositionOptions")}} オブジェクトで、位置を監視する構成オプションを提供します。
-
+- `success` + - : コールバック関数で、 {{domxref("GeolocationPosition")}} オブジェクトを入力引数として受け取るものです。 +- `error` {{optional_inline}} + - : 任意のコールバック関数で、 {{domxref("GeolocationPositionError")}} オブジェクトを入力引数として受け取るものです。 +- `options` {{optional_inline}} + - : 任意のオブジェクトで、位置を監視する構成オプションを提供します。 + 利用可能なオプションについての詳細は {{domxref("Geolocation.getCurrentPosition()")}} を参照してください。 -

返値

+### 返値 -

登録されたハンドラーを識別する ID を返します。この ID を {{domxref("Geolocation.clearWatch()")}} メソッドに渡してハンドラーの登録を解除することができます。

+登録されたハンドラーを識別する ID を返します。この ID を {{domxref("Geolocation.clearWatch()")}} メソッドに渡してハンドラーの登録を解除することができます。 -

例

+## 例 -
var id, target, options;
+```js
+var id, target, options;
 
 function success(pos) {
   var crd = pos.coords;
 
-  if (target.latitude === crd.latitude && target.longitude === crd.longitude) {
+  if (target.latitude === crd.latitude && target.longitude === crd.longitude) {
     console.log('Congratulations, you reached the target');
     navigator.geolocation.clearWatch(id);
   }
@@ -62,36 +67,19 @@ options = {
 };
 
 id = navigator.geolocation.watchPosition(success, error, options);
-
- -

仕様書

- - - - - - - - - - - - - - - - -
仕様書状態備考
{{SpecName('Geolocation', '#dom-geolocation-watchposition', 'watchPosition()')}}{{Spec2('Geolocation')}}初回定義
- -

ブラウザーの互換性

- -

{{Compat("api.Geolocation.watchPosition")}}

- -

関連情報

- - +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [Geolocation API の使用](/ja/docs/Web/API/Geolocation_API/Using_the_Geolocation_API) +- 所属するインターフェイス {{domxref("Geolocation")}} と、アクセス方法である {{domxref("Navigator.geolocation")}}。 +- 反対の操作: {{domxref("Geolocation.clearWatch()")}} +- 類似のメソッド: {{domxref("Geolocation.getCurrentPosition()")}} -- cgit v1.2.3-54-g00ecf