diff options
author | Masahiro FUJIMOTO <mfujimot@gmail.com> | 2022-02-03 01:30:02 +0900 |
---|---|---|
committer | Masahiro FUJIMOTO <mfujimot@gmail.com> | 2022-02-10 22:12:14 +0900 |
commit | b9941d9eedfe157f53d4d3a7265b83f1fbc785f2 (patch) | |
tree | ab99a58736ecad24fe2b12bebe74dcfe786bf7ca /files | |
parent | bb64b32a18916aeece12ffe137abec893095a299 (diff) | |
download | translated-content-b9941d9eedfe157f53d4d3a7265b83f1fbc785f2.tar.gz translated-content-b9941d9eedfe157f53d4d3a7265b83f1fbc785f2.tar.bz2 translated-content-b9941d9eedfe157f53d4d3a7265b83f1fbc785f2.zip |
2022/01/20 時点の英語版に同期
Diffstat (limited to 'files')
-rw-r--r-- | files/ja/web/api/geolocation/getcurrentposition/index.md | 99 |
1 files changed, 41 insertions, 58 deletions
diff --git a/files/ja/web/api/geolocation/getcurrentposition/index.md b/files/ja/web/api/geolocation/getcurrentposition/index.md index dd24b126d3..158accd2cf 100644 --- a/files/ja/web/api/geolocation/getcurrentposition/index.md +++ b/files/ja/web/api/geolocation/getcurrentposition/index.md @@ -4,43 +4,43 @@ slug: Web/API/Geolocation/getCurrentPosition tags: - API - Geolocation - - Geolocation API - - Method - - Reference - - Secure context - - getCurrentPosition + - 位置情報 API - メソッド + - リファレンス + - 安全なコンテキスト + - getCurrentPosition +browser-compat: api.Geolocation.getCurrentPosition translation_of: Web/API/Geolocation/getCurrentPosition --- -<p>{{securecontext_header}}{{ APIRef("Geolocation API") }}</p> +{{securecontext_header}}{{ APIRef("Geolocation API") }} -<p><span class="seoSummary"><strong><code>Geolocation.getCurrentPosition()</code></strong> メソッドは、デバイスの現在位置を取得するために使われます。</span></p> +**`Geolocation.getCurrentPosition()`** メソッドは、端末の現在位置を取得するために使われます。 -<h2 id="Syntax" name="Syntax">構文</h2> +## 構文 -<pre class="syntaxbox notranslate">navigator.geolocation.getCurrentPosition(<var>success</var>[, <var>error</var>[, [<var>options</var>]])</pre> +```js +navigator.geolocation.getCurrentPosition(success, error, [options]) +``` -<h3 id="Parameters" name="Parameters">引数</h3> +### 引数 -<dl> - <dt><code><var>success</var></code></dt> - <dd>コールバック関数で、 {{domxref("GeolocationPosition")}} オブジェクトを唯一の入力引数として受け取るものです。</dd> - <dt><code><var>error</var></code> {{optional_inline}}</dt> - <dd>任意のコールバック関数で、 {{domxref("GeolocationPositionError")}} オブジェクトを唯一の入力引数として受け取るものです。</dd> - <dt><code><var>options</var></code> {{optional_inline}}</dt> - <dd>任意の {{domxref("PositionOptions")}} オブジェクトです。<br> - オプションには以下のものがあります。 - <ul> - <li><code>maximumAge</code>: 整数 (ミリ秒) | infinity - キャッシュされた位置の最大寿命です。</li> - <li><code>timeout</code>: 整数 (ミリ秒) - エラーコールバックが呼び出されるまでの時間で、 0 の場合は呼び出されません。</li> - <li><code>enableHighAccuracy</code>: false | true</li> - </ul> - </dd> -</dl> +- `success` + - : コールバック関数で、 {{domxref("GeolocationPosition")}} オブジェクトを唯一の入力引数として受け取ります。 +- `error` {{optional_inline}} + - : オプションのコールバック関数で、 {{domxref("GeolocationPositionError")}} オブジェクトを唯一の入力引数として受け取ります。 +- `options` {{optional_inline}} + - : オプションのオブジェクトで、以下の引数を含みます。 + - `maximumAge` + - : 正の `long` 値で、キャッシュされた位置を返すことが可能な最大時間をミリ秒単位で表します。 `0` に設定した場合、端末はキャッシュされた位置を使用できず、実際の現在位置を取得する必要があることを意味します。 [`Infinity`](/ja/docs/Web/JavaScript/Reference/Global_Objects/Infinity) に設定した場合、端末はキャッシュされた位置をその古さに関係なく返さなければなりません。既定値は 0 です。 + - `timeout` + - : 正の `long` 値で、端末が位置を返すために掛けることができる最大時間をミリ秒単位で表します。既定値は [`Infinity`](/ja/docs/Web/JavaScript/Reference/Global_Objects/Infinity) で、 `getCurrentPosition()` は位置を取得できるまで返さないという意味です。 + - `enableHighAccuracy` + - : 論理値で、アプリケーションが可能な限り正確な結果を受け取ることを望んでいることを示します。もし `true` で、端末がより正確な位置を提供できる場合は、そのようにします。この場合、応答時間が遅くなったり、消費電力が増加したりすることに注意してください(たとえば、モバイル端末の GPS チップを使用する場合など)。一方、 `false` の場合、端末はより速く反応したり、より少ない電力を使用することで、リソースを節約することができます。既定値は `false` です。 -<h2 id="Examples" name="Examples">例</h2> +## 例 -<pre class="brush: js notranslate">var options = { +```js +var options = { enableHighAccuracy: true, timeout: 5000, maximumAge: 0 @@ -60,34 +60,17 @@ function error(err) { } navigator.geolocation.getCurrentPosition(success, error, options); -</pre> - -<h2 id="Specifications" name="Specifications">仕様書</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">仕様書</th> - <th scope="col">状態</th> - <th scope="col">備考</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('Geolocation')}}</td> - <td>{{Spec2('Geolocation')}}</td> - <td>初回定義</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> - -<p>{{Compat("api.Geolocation.getCurrentPosition")}}</p> - -<h2 id="See_also" name="See_also">関連情報</h2> - -<ul> - <li><a href="/ja/docs/Web/API/Geolocation_API/Using_the_Geolocation_API">Geolocation の使用</a></li> - <li>{{domxref("Navigator.geolocation")}}</li> -</ul> +``` + +## 仕様書 + +{{Specifications}} + +## ブラウザーの互換性 + +{{Compat}} + +## 関連情報 + +- [位置情報 API の使用](/ja/docs/Web/API/Geolocation_API/Using_the_Geolocation_API) +- {{domxref("Navigator.geolocation")}} |