---
title: PositionOptions
slug: Web/API/PositionOptions
tags:
  - API
  - Geolocation API
  - Interface
  - PositionOptions
  - Reference
  - Secure context
translation_of: Web/API/PositionOptions
---
<div>{{securecontext_header}}{{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> <em>인터페이스는 어떤 속성도 상속하지 않습니다.</em></p>

<dl>
 <dt>{{domxref("PositionOptions.enableHighAccuracy")}} {{securecontext_inline}}</dt>
 <dd>위치정보를 가장 높은 정확도로 수신하고 싶음을 나타내는 {{domxref("Boolean")}}입니다. 이 값이 <code>true</code>이고, 장치도 지원한다면 더 정확한 위치정보를 받을 수 있습니다. 그러나 느린 응답 속도와, 모바일 장치에서의 전력 소모량 증가는 주의해야 합니다. 반대로, 값이 <font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">false</span></font>면 기기가 더 빠르게 반응하고 전력 소모도 줄일 수 있습니다. 기본값은 <font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">false</span></font>입니다.</dd>
 <dt>{{domxref("PositionOptions.timeout")}} {{securecontext_inline}}</dt>
 <dd>기기가 위치를 반환할 때 소모할 수 있는 최대 시간을 밀리초로 나타내는 양의 <code>long</code> 값입니다. 기본값은 {{jsxref("Infinity")}}로, 위치정보를 알아낼 때까지 <code>getCurrentPosition()</code>의 성공 콜백을 호출하지 않습니다.</dd>
 <dt>{{domxref("PositionOptions.maximumAge")}} {{securecontext_inline}}</dt>
 <dd>캐시에 저장한 위치정보를 대신 반환할 수 있는 최대 시간을 밀리초로 나타내는 양의 <code>long</code> 값입니다. <code>0</code>으로 설정하면 장치가 사전에 미리 저장한 위치를 사용하지 않고, 항상 현재 위치를 검색합니다. {{jsxref("Infinity")}}로 설정하면 지난 시간에 상관없이 캐시에 저장한 위치를 반환합니다. 기본값은 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>{{Compat("api.PositionOptions")}}</p>

<h2 id="같이_보기">같이 보기</h2>

<ul>
 <li><a href="/ko/docs/Web/API/Geolocation_API">Geolocation API</a></li>
 <li>이 인터페이스를 사용하는 {{domxref("Geolocation")}} 인터페이스.</li>
</ul>