Saltar a contenido

inverseGeocoder

Permite traducir una ubicación en el mapa (coordenadas) en una dirección legible, teniendo en cuenta lo siguiente:

  • Las coordenadas deben ser un objeto con el formato:
    • {lat: Float, lng: Float}: Ejemplo: {lat: 51.51455, lng: -0.07306}

Lista de Parámetros:

El método inverseGeocoder recibe 3 parametros:

  • coords: object default: null
  • callBack: function default: null
  • options: un objeto con opciones adicionales (este campo no es requerido).
    • centerMap: boolean default: null
    • marker: true default: null
    • zoom: integer default: null

Definición:

1
fn.inverseGeocoder = function(coords, callBack, options) {};

Ejemplos:

  • Con las opciones por defecto:
1
2
3
4
5
Anuket.inverseGeocoder({lat: 51.51455, lng: -0.07306}, function(address, results, status) {
  console.log('formatted address', address);
  console.log('results', results);
  console.log('status', status);
});
  • Definiendo opciones:
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
var options = {
  centerMap: true, 
  marker: true,
  zoom: 14
}

Anuket.inverseGeocoder({lat: 51.51455, lng: -0.07306}, function(address, results, status) {
  console.log('formatted address', address);
  console.log('results', results);
  console.log('status', status);
}, options);

Consideraciones:

  • Los campos lat y lng que representan la latitud y la longitud, del objeto coords, respectivamente, están en formato númerico con decimales y se recomendia enviar al menos, 5 digitos decimales, para una mejor precisión en las coordenadas.

  • La opción centerMap solo acepta true ó false, permite centrar el mapa.

  • La opción marker solo acepta true ó false, permite establecer un marcador en el mapa.

  • La opción zoom solo acepta un valor numérico (enteros positivos) de 0 a 18, permitiendo establecer el nivel de zoom en el mapa.

  • Las opciones centerMap y marker utilizan las coordenadas originales enviadas como parámetro.

Nota:

  • Las opciones anteriores se aplicarán, sólo si el resultado de la georreferenciación inversa es satisfactorio.

  • Si la georreferenciación inversa falla, se devolverá un código de error, definido en la documentación de Google Maps Api.

  • El parámetro callBack es una función anónima, que se ejecuta al finalizar el servicio de la georreferenciación inversa, devuelve tres parametros:

    • address: Un string con el primer resultado de la georreferenciación inversa, normalmente, la direccción legible.
    • results: Un objeto con todos los resultados de la georreferenciación inversa.
    • status: Un mensaje con el código del resultado obtenido.

  • La geocodificación inversa no es una ciencia exacta. El geocodificador intentará encontrar la ubicación direccionable más cercana dentro de una cierta tolerancia.

Nota:

Recomendamos leer el apartado de Geocodificación inversa y Filtrado de componentes para más información.