aboutsummaryrefslogtreecommitdiff
path: root/files/ja/web/api/positionoptions/index.html
blob: 27cf8dbb9b334e492750e6a40254608b4386a1c4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
---
title: PositionOptions
slug: Web/API/PositionOptions
tags:
  - API
  - Geolocation API
  - Interface
  - PositionOptions
  - Reference
  - Secure context
translation_of: Web/API/PositionOptions
---
<div>
<div>{{securecontext_header}}{{APIRef("Geolocation API")}}</div>
</div>

<p><strong><code>PositionOptions</code></strong> インターフェイスは {{domxref("Geolocation.getCurrentPosition()")}}{{domxref("Geolocation.watchPosition()")}} に渡すオプションプロパティを含んだオブジェクトを表します。</p>

<h2 id="Properties" name="Properties">プロパティ</h2>

<p><em><code>PositionOptions</code> インターフェイスが継承するプロパティはありません。</em></p>

<dl>
 <dt>{{domxref("PositionOptions.enableHighAccuracy")}} {{securecontext_inline}}</dt>
 <dd>アプリケーションが可能な限り高精度の結果を求めることを表す {{domxref("Boolean")}} 型の値です。このプロパティに <code>true</code> を指定すると、デバイスが高精度な位置情報を提供できる場合に、それを利用することができます。これによって測位結果の取得に時間がかかったり、 (GPS チップを搭載したモバイル端末などで) 電力消費が増える可能性があります。逆に <code>false</code> を指定することで、短時間で結果を返したり消費電力を節約したりといった選択をデバイスに任せることができます。デフォルトは <code>false</code> です。</dd>
 <dt>{{domxref("PositionOptions.timeout")}} {{securecontext_inline}}</dt>
 <dd>位置情報の取得にかかる時間の上限 (ミリ秒) を表す、 <code>long</code> 型の正の値です。デフォルトは <code><a href="/ja/docs/JavaScript/Reference/Global_Objects/Infinity">Infinity</a></code> で、位置情報が得られるまで <code>getCurrentPosition()</code> が待ち続けることを意味します。</dd>
 <dt>{{domxref("PositionOptions.maximumAge")}} {{securecontext_inline}}</dt>
 <dd>キャッシュ済みの位置情報の有効期限 (ミリ秒) を表す、 <code>long</code> 型の正の値です。これに <code>0</code> を指定すると、デバイスはキャッシュ済みの位置情報を返すことができず、常に最新の位置情報を取得しようとします。<code><a href="/ja/docs/JavaScript/Reference/Global_Objects/Infinity">Infinity</a></code> を指定した場合、デバイスは常にキャッシュから位置情報を返します。デフォルトは 0 です。</dd>
</dl>

<h2 id="Methods" name="Methods">メソッド</h2>

<p><code>PositionOptions</code> インターフェイスが実装・継承するメソッドはありません。</p>

<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', '#positionoptions', 'PositionOptions')}}</td>
   <td>{{Spec2('Geolocation')}}</td>
   <td>最初の定義</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザ実装状況</h2>

<p>{{CompatibilityTable}}</p>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>機能</th>
   <th>Chrome</th>
   <th>Edge</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>基本サポート</td>
   <td>5</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatGeckoDesktop("1.9.1")}}</td>
   <td>9</td>
   <td>10.60<br>
    Removed in 15.0<br>
    Reintroduced in 16.0</td>
   <td>5</td>
  </tr>
  <tr>
   <td>Secure context-only</td>
   <td>47</td>
   <td>{{CompatUnknown()}}</td>
   <td>{{CompatGeckoDesktop("55")}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>機能</th>
   <th>Android</th>
   <th>Chrome for Android</th>
   <th>Edge</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>基本サポート</td>
   <td>{{CompatUnknown()}}</td>
   <td>{{CompatUnknown()}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatGeckoMobile("4")}}</td>
   <td>{{CompatUnknown()}}</td>
   <td>10.60</td>
   <td>{{CompatUnknown()}}</td>
  </tr>
  <tr>
   <td>Secure context-only</td>
   <td>{{CompatNo}}</td>
   <td>47</td>
   <td>{{CompatUnknown()}}</td>
   <td>{{CompatGeckoDesktop("55")}}</td>
   <td>{{CompatNo}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
  </tr>
 </tbody>
</table>
</div>

<h2 id="See_also" name="See_also">関連情報</h2>

<ul>
 <li><a href="/ja/docs/WebAPI/Using_geolocation">Geolocation の利用</a></li>
 <li>{{domxref("Geolocation")}} インターフェイス</li>
</ul>