---
title: Geolocation
slug: Web/API/Geolocation
tags:
  - API
  - Geolocalização
  - Geolocation
  - Geolocation API
translation_of: Web/API/Geolocation
---
<div>{{APIRef("Geolocation API")}}</div>

<p>A interface <strong>Geolocation</strong> representa um objeto ábil de programaticamente obter a posição do aparelho. Dá ao conteúdo web acesso à localização do aparelho. Isto permite com que o website ou a aplicação ofereça resultados customizados baseados na localização do usuário.</p>

<p>Um objeto com tal interface é obtido utilizando a propriedade {{domxref("NavigatorGeolocation.geolocation")}} implementada pelo objeto {{domxref("Navigator")}}.</p>

<div class="note">
<p><strong>Nota:</strong> Por questões de segurança, quando uma página tenta obter acesso às informações de localização o usuário é notificado e uma requisição é feita para o mesmo fornecesser a permissão. Saiba que cada navegaor possui suas próprias políticas e métodos para requisitar tal permissão.</p>
</div>

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

<p><em>A interface </em>Geolocation<em> não implementa nem herda qualquer propriedade.</em></p>

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

<p><em>A interface </em>Geolocation<em> não herda qualquer métodos.</em></p>

<dl>
 <dt>{{domxref("Geolocation.getCurrentPosition()")}}</dt>
 <dd>Determina a posição atual do aparelho e retorna um objeto {{domxref("Position")}} com os dados.</dd>
 <dt>{{domxref("Geolocation.watchPosition()")}}</dt>
 <dd>Retorna um valor long representando a nova função de callback estabelecida para ser invocada a qualquer momento que o localização do aparelho alterar-se.</dd>
 <dt>{{domxref("Geolocation.clearWatch()")}}</dt>
 <dd>Remove qualquer encarregado previamente instalado usando<em> watchPosition()</em>.</dd>
</dl>

<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')}}</td>
   <td>{{Spec2('Geolocation')}}</td>
   <td>Especificação Inicial</td>
  </tr>
 </tbody>
</table>

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

<p> </p>

<p>{{Compat("api.Geolocation")}}</p>

<p> </p>

<div id="compat-desktop"> </div>

<h2 id="Veja_Também">Veja Também</h2>

<ul>
 <li><a href="/en-US/docs/WebAPI/Using_geolocation" title="/en-US/docs/WebAPI/Using_geolocation">Usando Geolocation</a></li>
</ul>