initial commit

4 files changed, 366 insertions, 0 deletions

diff --git a/files/ja/web/api/geolocation/clearwatch/index.html b/files/ja/web/api/geolocation/clearwatch/index.html
new file mode 100644
index 0000000000..6c4790a719
--- /dev/null
+++ b/files/ja/web/api/geolocation/clearwatch/index.html
@@ -0,0 +1,97 @@
+---
+title: Geolocation.clearWatch()
+slug: Web/API/Geolocation/clearWatch
+tags:
+  - API
+  - Geolocation
+  - Geolocation API
+  - Method
+  - Reference
+  - Secure context
+  - clearWatch
+  - メソッド
+  - リファレンス
+  - 位置情報
+  - 位置情報 API
+  - 安全なコンテキスト
+translation_of: Web/API/Geolocation/clearWatch
+---
+<p>{{securecontext_header}}{{ APIref("Geolocation API") }}</p>
+
+<p><strong><code>Geolocation.clearWatch()</code></strong>メソッドは、以前 {{domxref("Geolocation.watchPosition()")}} によって登録された位置情報/エラーの監視ハンドラーを解除するために使用します。</p>
+
+<h2 id="Syntax" name="Syntax">構文</h2>
+
+<pre class="syntaxbox notranslate">navigator.geolocation.clearWatch(<var>id</var>);</pre>
+
+<h3 id="Parameters" name="Parameters">引数</h3>
+
+<dl>
+ <dt><code><var>id</var></code></dt>
+ <dd>解除したいハンドラーの登録時に {{domxref("Geolocation.watchPosition()")}} メソッドから返された ID 番号です。</dd>
+</dl>
+
+<h2 id="Example" name="Example">例</h2>
+
+<pre class="brush: js notranslate">var id, target, option;
+
+function success(pos) {
+  var crd = pos.coords;
+
+  if (target.latitude === crd.latitude &amp;&amp; target.longitude === crd.longitude) {
+    console.log('Congratulation, you reach the target');
+    navigator.geolocation.clearWatch(id);
+  }
+};
+
+function error(err) {
+  console.warn('ERROR(' + err.code + '): ' + err.message);
+};
+
+target = {
+  latitude : 0,
+  longitude: 0,
+}
+
+options = {
+  enableHighAccuracy: false,
+  timeout: 5000,
+  maximumAge: 0
+};
+
+id = navigator.geolocation.watchPosition(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>
+
+<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div>
+
+<p>{{Compat("api.Geolocation.clearWatch")}}</p>
+
+<h2 id="See_also" name="See_also">関連情報</h2>
+
+<ul>
+ <li><a href="/ja/docs/WebAPI/Using_geolocation" title="/ja/docs/WebAPI/Using_geolocation">位置情報の使用</a></li>
+ <li>{{domxref("Geolocation")}}</li>
+ <li>{{domxref("Geolocation.watchPosition()")}}</li>
+ <li>{{domxref("Geolocation.getCurrentPosition()")}}</li>
+</ul>
diff --git a/files/ja/web/api/geolocation/getcurrentposition/index.html b/files/ja/web/api/geolocation/getcurrentposition/index.html
new file mode 100644
index 0000000000..f99f1cef81
--- /dev/null
+++ b/files/ja/web/api/geolocation/getcurrentposition/index.html
@@ -0,0 +1,95 @@
+---
+title: Geolocation.getCurrentPosition()
+slug: Web/API/Geolocation/getCurrentPosition
+tags:
+  - API
+  - Geolocation
+  - Geolocation API
+  - Method
+  - Reference
+  - Secure context
+  - getCurrentPosition
+  - メソッド
+translation_of: Web/API/Geolocation/getCurrentPosition
+---
+<p>{{securecontext_header}}{{ APIRef("Geolocation API") }}</p>
+
+<p><span class="seoSummary"><strong><code>Geolocation.getCurrentPosition()</code></strong> メソッドは、デバイスの現在位置を取得するために使われます。</span></p>
+
+<h2 id="Syntax" name="Syntax">構文</h2>
+
+<pre class="syntaxbox notranslate">navigator.geolocation.getCurrentPosition(<var>success</var>[, <var>error</var>[, [<var>options</var>]])</pre>
+
+<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>
+
+<h2 id="Examples" name="Examples">例</h2>
+
+<pre class="brush: js notranslate">var options = {
+  enableHighAccuracy: true,
+  timeout: 5000,
+  maximumAge: 0
+};
+
+function success(pos) {
+  var crd = pos.coords;
+
+  console.log('Your current position is:');
+  console.log(`Latitude : ${crd.latitude}`);
+  console.log(`Longitude: ${crd.longitude}`);
+  console.log(`More or less ${crd.accuracy} meters.`);
+}
+
+function error(err) {
+  console.warn(`ERROR(${err.code}): ${err.message}`);
+}
+
+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>
+
+<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div>
+
+<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>
diff --git a/files/ja/web/api/geolocation/index.html b/files/ja/web/api/geolocation/index.html
new file mode 100644
index 0000000000..53163a84ee
--- /dev/null
+++ b/files/ja/web/api/geolocation/index.html
@@ -0,0 +1,75 @@
+---
+title: Geolocation
+slug: Web/API/Geolocation
+tags:
+  - API
+  - Advanced
+  - Geolocation
+  - Geolocation API
+  - Interface
+  - Reference
+  - Secure context
+  - インターフェイス
+  - リファレンス
+  - 位置情報
+  - 位置情報 API
+  - 安全なコンテキスト
+translation_of: Web/API/Geolocation
+---
+<div>{{securecontext_header}}{{APIRef("Geolocation API")}}</div>
+
+<p><code><strong>Geolocation</strong></code> インターフェイスはデバイスの位置を取得する機能を提供します。これにより、ウェブサイトやアプリがユーザーの現在の位置に応じた結果を提供できるようになります。</p>
+
+<p>このインターフェイスを持つオブジェクトは、 {{domxref("Navigator")}} オブジェクトの {{domxref("navigator.geolocation")}} プロパティを使って得ることができます。</p>
+
+<div class="note">
+<p><strong>注:</strong> セキュリティ上の理由により、ウェブページが位置情報にアクセスしようとする時、ユーザーにアクセス許可が求められます。その方法やポリシーはブラウザーによって異なることに注意してください。</p>
+</div>
+
+<h2 id="Properties" name="Properties">プロパティ</h2>
+
+<p><em><code>Geolocation</code> インターフェイスが実装・継承するプロパティはありません。</em></p>
+
+<h2 id="Methods" name="Methods">メソッド</h2>
+
+<p><code>Geolocation</code> インターフェイスが継承するプロパティはありません。</p>
+
+<dl>
+ <dt>{{domxref("Geolocation.getCurrentPosition()")}} {{securecontext_inline}}</dt>
+ <dd>デバイスの現在位置を特定し、結果データを {{domxref("GeolocationPosition")}} オブジェクトで返します。</dd>
+ <dt>{{domxref("Geolocation.watchPosition()")}} {{securecontext_inline}}</dt>
+ <dd>デバイスの位置が変化する度に呼び出されるコールバック関数を登録し、それを識別する <code>long</code> 型の値を返します。</dd>
+ <dt>{{domxref("Geolocation.clearWatch()")}} {{securecontext_inline}}</dt>
+ <dd><code>watchPosition()</code> によって以前に登録されたハンドラーを解除します。</dd>
+</dl>
+
+<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', '#geolocation_interface')}}</td>
+   <td>{{Spec2('Geolocation')}}</td>
+   <td>初回定義。</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
+
+<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div>
+
+<p>{{Compat("api.Geolocation")}}</p>
+
+<h2 id="See_also" name="See_also">関連情報</h2>
+
+<ul>
+ <li><a href="/ja/docs/Web/API/Geolocation_API/Using_the_Geolocation_API">位置情報の使用</a></li>
+</ul>
diff --git a/files/ja/web/api/geolocation/watchposition/index.html b/files/ja/web/api/geolocation/watchposition/index.html
new file mode 100644
index 0000000000..908f8b061d
--- /dev/null
+++ b/files/ja/web/api/geolocation/watchposition/index.html
@@ -0,0 +1,99 @@
+---
+title: Geolocation.watchPosition()
+slug: Web/API/Geolocation/watchPosition
+tags:
+  - API
+  - Geolocation
+  - Geolocation API
+  - Method
+  - Reference
+  - Secure context
+translation_of: Web/API/Geolocation/watchPosition
+---
+<p>{{securecontext_header}}{{ APIref("Geolocation API") }}</p>
+
+<p><span class="seoSummary">{{domxref("Geolocation")}} の <strong><code>watchPosition()</code></strong> メソッドは、端末の位置が変化するたびに自動的に呼び出されるハンドラー関数を登録するために用いられます。</span>また必要に応じてエラー処理コールバック関数を指定することができます。</p>
+
+<h2 id="Syntax" name="Syntax">構文</h2>
+
+<pre class="syntaxbox notranslate">navigator.geolocation.watchPosition(<var>success</var>[, <var>error</var>[, <var>options</var>]])</pre>
+
+<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")}} オブジェクトで、位置を監視する構成オプションを提供します。</dd>
+</dl>
+
+<h3 id="Return_value" name="Return_value">返値</h3>
+
+<p>登録されたハンドラーを識別する ID を返します。この ID を {{domxref("Geolocation.clearWatch()")}} メソッドに渡してハンドラーの登録を解除することができます。</p>
+
+<h2 id="Examples" name="Examples">例</h2>
+
+<pre class="brush: js notranslate">var id, target, options;
+
+function success(pos) {
+  var crd = pos.coords;
+
+  if (target.latitude === crd.latitude &amp;&amp; target.longitude === crd.longitude) {
+    console.log('Congratulations, you reached the target');
+    navigator.geolocation.clearWatch(id);
+  }
+}
+
+function error(err) {
+  console.warn('ERROR(' + err.code + '): ' + err.message);
+}
+
+target = {
+  latitude : 0,
+  longitude: 0
+};
+
+options = {
+  enableHighAccuracy: false,
+  timeout: 5000,
+  maximumAge: 0
+};
+
+id = navigator.geolocation.watchPosition(success, error, options);
+</pre>
+
+<h2 id="Speicfications" name="Speicfications">仕様書</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', '#dom-geolocation-watchposition', 'watchPosition()')}}</td>
+   <td>{{Spec2('Geolocation')}}</td>
+   <td>初回定義</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
+
+<p class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</p>
+
+<p>{{Compat("api.Geolocation.watchPosition")}}</p>
+
+<h2 id="See_also" name="See_also">関連情報</h2>
+
+<ul>
+ <li><a href="/en-US/docs/Web/API/Geolocation_API/Using">Geolocation API の使用</a></li>
+ <li>所属するインターフェイス {{domxref("Geolocation")}} と、アクセス方法である {{domxref("NavigatorGeolocation.geolocation")}}。</li>
+ <li>逆の操作: {{domxref("Geolocation.clearWatch()")}}</li>
+ <li>類似のメソッド: {{domxref("Geolocation.getCurrentPosition()")}}</li>
+</ul>