aboutsummaryrefslogtreecommitdiff
path: root/files/zh-tw/web/api/positionoptions/index.html
blob: fc27485e653d4bbac47c77d09f46d605416242a4 (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
---
title: PositionOptions
slug: Web/API/PositionOptions
translation_of: Web/API/PositionOptions
---
<div>{{APIRef("Geolocation API")}}</div>

<p><strong><code>PositionOptions</code></strong> 是一個當作 {{domxref("Geolocation.getCurrentPosition()")}} 以及 {{domxref("Geolocation.watchPosition()")}} 參數的物件,此物件含有幾種可以設定的屬性。</p>

<h2 id="屬性">屬性</h2>

<p><em><code>PositionOptions</code> </em>介面沒有繼承任何屬性</p>

<dl>
 <dt>{{domxref("PositionOptions.enableHighAccuracy")}}</dt>
 <dd>是一個 {{domxref("Boolean")}} 的值。此值指出方法是否需要回傳最佳的結果。如果值為真且該裝置具備提供精準位置的能力,則方法會回傳最佳結果。必須注意的是最佳結果會導致較長的回應時間或者需要更多的電力耗損 (舉例來說擁有GPS晶片的手機)。相反來說,如果值為偽,<code>機器會因為回應時間較短以及消耗較少的電力達到資源節省</code>。預設值:偽。</dd>
 <dt>{{domxref("PositionOptions.timeout")}}</dt>
 <dd>這是一個正值,它代表機器能夠等待方法回傳位置的最長時間(單位是毫秒)。預設值是 <code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Infinity">Infinity</a></code>,代表 <code>getCurrentPosition()</code> 此方法在沒有可用的位置前不會有任何回覆。</dd>
 <dt>{{domxref("PositionOptions.maximumAge")}}</dt>
 <dd>這是一個正值,它代表可以接受暫存位置的最長時限(單位是毫秒)。如果設定為 0,代表機器必須回傳實際的當前位置而不能使用暫存位置。如果設定為 <code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Infinity">Infinity</a></code>,機器必定會回傳暫存位置而不考慮他的時限。預設值:0。</dd>
</dl>

<h2 id="方法">方法</h2>

<p><code>PositionOptions</code> 介面沒有實現也沒有繼承任何方法。</p>

<h2 id="規格">規格</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('Geolocation', '#positionoptions', 'PositionOptions')}}</td>
   <td>{{Spec2('Geolocation')}}</td>
   <td>Initial definition</td>
  </tr>
 </tbody>
</table>

<h2 id="瀏覽器的相容性">瀏覽器的相容性</h2>

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

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>5</td>
   <td>{{CompatGeckoDesktop("1.9.1")}}</td>
   <td>9</td>
   <td>10.60<br>
    {{CompatNo}} 15.0<br>
    16.0</td>
   <td>5</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Feature</th>
   <th>Android</th>
   <th>Chrome for Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatGeckoMobile("4")}}</td>
   <td>{{CompatUnknown}}</td>
   <td>10.60</td>
   <td>{{CompatUnknown}}</td>
  </tr>
 </tbody>
</table>
</div>

<h2 id="請參考">請參考</h2>

<ul>
 <li><a href="/en-US/docs/WebAPI/Using_geolocation">Using geolocation</a></li>
 <li>{{domxref("Geolocation")}} 介面使用此物件。</li>
</ul>