---
title: PositionError
slug: Web/API/GeolocationPositionError
translation_of: Web/API/GeolocationPositionError
---
<div>{{APIRef("Geolocation API")}}</div>

<p>A interface <strong><code>PositionError</code></strong> representa a rasão de um erro ocorrer quando usando o dispositivo de geolocalização.</p>

<h2 id="Propriedades">Propriedades</h2>

<p><em>A interface <code>PositionError</code> não herda nenhuma propriedade</em>.</p>

<dl>
 <dt>{{domxref("PositionError.code")}} {{readonlyInline}}</dt>
 <dd>Retorna um tipo <code>unsigned short</code> representando o código de erro. Os valores possíveis são os seguintes:
 <table class="standard-table">
  <tbody>
   <tr>
    <th scope="col">Valor</th>
    <th scope="col">Constante associada</th>
    <th scope="col">Descrição</th>
   </tr>
   <tr>
    <td><code>1</code></td>
    <td><code>PERMISSION_DENIED</code></td>
    <td>Não foi possível obter a informação sobre geolocalização por que a página não possuía permissão para fazê-lo.</td>
   </tr>
   <tr>
    <td><code>2</code></td>
    <td><code>POSITION_UNAVAILABLE</code></td>
    <td>A obtenção da geolocalização falhou por que pelo menos uma fonte interna de posicionamento retornou um erro interno.</td>
   </tr>
   <tr>
    <td><code>3</code></td>
    <td><code>TIMEOUT</code></td>
    <td>O tempo máximo permitido para obter a geolocalização, definido por {{domxref("PositionOptions.timeout")}} foi atingido antes de se obter a informação.</td>
   </tr>
  </tbody>
 </table>
 </dd>
 <dt>{{domxref("PositionError.message")}} {{readonlyInline}}</dt>
 <dd>Retorna um {{domxref("DOMString")}} humanamente legível descrevendo os detalhes do erro. A especificação observa que esta informação é primariamente projetada para propósitos de debug e não deve ser exibida diretamente na interface com o usuário.</dd>
</dl>

<h2 id="Métodos">Métodos</h2>

<p><em><em>A interface <code>PositionError</code> não implementa nem herda qualquer método<em>.</em></em></em></p>

<h2 id="Especificações">Especificações</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Especificação</th>
   <th scope="col">Status</th>
   <th scope="col">Comentário</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('Geolocation', '#positionerror', 'PositionError')}}</td>
   <td>{{Spec2('Geolocation')}}</td>
   <td>Especificação inicial.</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility">Compatibilidade com navegadores</h2>

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

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Funcionalidade</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari</th>
  </tr>
  <tr>
   <td>Suporte básico</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>Funcionalidade</th>
   <th>Android</th>
   <th>Chrome para Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>IE Mobile</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Suporte básico</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="Veja_também">Veja também</h2>

<ul>
 <li><a href="/en-US/docs/WebAPI/Using_geolocation">Usando geolocation</a></li>
 <li>A interface {{domxref("Geolocation")}} que o utiliza.</li>
</ul>