Visão geral
Este tutorial mostra como exibir o local geográfico de um usuário ou dispositivo em um mapa do Google usando o recurso de geolocalização da Google Maps JavaScript API.
Abaixo está um mapa que pode identificar seu local atual.
O exemplo abaixo mostra o código inteiro de que você precisa para criar esse mapa.
// Note: This example requires that you consent to location sharing when
// prompted by your browser. If you see the error "The Geolocation service
// failed.", it means you probably did not give permission for the browser to
// locate you.
function initMap() {
var map = new google.maps.Map(document.getElementById('map'), {
center: {lat: -34.397, lng: 150.644},
zoom: 6
});
var infoWindow = new google.maps.InfoWindow({map: map});
// Try HTML5 geolocation.
if (navigator.geolocation) {
navigator.geolocation.getCurrentPosition(function(position) {
var pos = {
lat: position.coords.latitude,
lng: position.coords.longitude
};
infoWindow.setPosition(pos);
infoWindow.setContent('Location found.');
map.setCenter(pos);
}, function() {
handleLocationError(true, infoWindow, map.getCenter());
});
} else {
// Browser doesn't support Geolocation
handleLocationError(false, infoWindow, map.getCenter());
}
}
function handleLocationError(browserHasGeolocation, infoWindow, pos) {
infoWindow.setPosition(pos);
infoWindow.setContent(browserHasGeolocation ?
'Error: The Geolocation service failed.' :
'Error: Your browser doesn\'t support geolocation.');
}
<div id="map"></div>
/* Always set the map height explicitly to define the size of the div
* element that contains the map. */
#map {
height: 100%;
}
/* Optional: Makes the sample page fill the window. */
html, body {
height: 100%;
margin: 0;
padding: 0;
}
<!-- Replace the value of the key parameter with your own API key. --> <script async defer src="https://maps.googleapis.com/maps/api/js?key=AIzaSyCkUOdZ5y7hMm0yrcCQoCvLwzdM6M8s5qk&callback=initMap"> </script>
Sua vez de tentar
Passe o cursor na parte superior direita do bloco de código para copiar o código ou abri-lo no JSFiddle.
<!DOCTYPE html>
<html>
<head>
<title>Geolocation</title>
<meta name="viewport" content="initial-scale=1.0, user-scalable=no">
<meta charset="utf-8">
<style>
/* Always set the map height explicitly to define the size of the div
* element that contains the map. */
#map {
height: 100%;
}
/* Optional: Makes the sample page fill the window. */
html, body {
height: 100%;
margin: 0;
padding: 0;
}
</style>
</head>
<body>
<div id="map"></div>
<script>
// Note: This example requires that you consent to location sharing when
// prompted by your browser. If you see the error "The Geolocation service
// failed.", it means you probably did not give permission for the browser to
// locate you.
function initMap() {
var map = new google.maps.Map(document.getElementById('map'), {
center: {lat: -34.397, lng: 150.644},
zoom: 6
});
var infoWindow = new google.maps.InfoWindow({map: map});
// Try HTML5 geolocation.
if (navigator.geolocation) {
navigator.geolocation.getCurrentPosition(function(position) {
var pos = {
lat: position.coords.latitude,
lng: position.coords.longitude
};
infoWindow.setPosition(pos);
infoWindow.setContent('Location found.');
map.setCenter(pos);
}, function() {
handleLocationError(true, infoWindow, map.getCenter());
});
} else {
// Browser doesn't support Geolocation
handleLocationError(false, infoWindow, map.getCenter());
}
}
function handleLocationError(browserHasGeolocation, infoWindow, pos) {
infoWindow.setPosition(pos);
infoWindow.setContent(browserHasGeolocation ?
'Error: The Geolocation service failed.' :
'Error: Your browser doesn\'t support geolocation.');
}
</script>
<script async defer
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
</script>
</body>
</html>
O que é geolocalização?
Geolocalização se refere à identificação do local geográfico de um usuário ou dispositivo de computação por meio de uma variedade de mecanismos de coleta de dados. Normalmente, a maior parte dos serviços de geolocalização usam endereços de roteamento de rede ou dispositivos internos de GPS para determinar esse local. A geolocalização é uma API específica do dispositivo. Isso significa que navegadores ou dispositivos devem ter suporte para geolocalização para poder usá-la em aplicativos da Web.
Padrão de geolocalização W3C
Aplicativos que queiram realizar geolocalização devem ter suporte para o padrão de geolocalização W3C. Observe que o exemplo de código acima determina o local do usuário usando a propriedade navigator.geolocation do W3C.
Alguns navegadores usam endereços IP para detectar o local de um usuário. No entanto, talvez só mostrem uma estimativa aproximada do local de um usuário. A abordagem W3C é a mais fácil e com maior suporte, portanto, ela deve ter prioridade sobre outros métodos de geolocalização.
O parâmetro Sensor
A Google Maps JavaScript API anteriormente exigia o parâmetro sensor para indicar se o aplicativo usou um sensor para determinar o local do usuário. Esse parâmetro não é mais obrigatório.
