Saltar a contenido

geocoder

Permite georreferenciar una dirección, teniendo en cuenta lo siguiente:

  • La dirección debe ser un string con el formato:
  • 'direccion, ciudad': Ejemplo: '10 Whitechapel High St, london'
  • 'latitud, longitud': Ejemplo: '51.51455, -0.07306'

Lista de Parámetros:

El método geocoder recibe 3 parametros:

  • address: string default: null
  • callBack: function default: null (ver detalles más abajo.)
  • options: un objeto con opciones adicionales (este campo no es requerido).
    • centerMap: boolean default: null
    • country: string default: false
    • marker: true default: null
    • zoom: integer default: null

Definición:

1
fn.geocoder = function(address, callBack, options) {};

Ejemplos:

  • Con las opciones por defecto:
1
2
3
4
5
Anuket.geocoder('10 Whitechapel High St, london', function(coords, results, status) {
  console.log('coords', coords);
  console.log('results', results);
  console.log('status', status);
});
  • Definiendo opciones:
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
var options = {
  country: 'GB',
  centerMap: true,
  zoom: 14,
  marker: true
}

Anuket.geocoder('10 Whitechapel High St, london', function(coords, results, status) {
  console.log('coords', coords);
  console.log('results', results);
  console.log('status', status);
}, options);

Consideraciones:

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

  • La opción country acepta un nombre de país ó un código de país bajo el estandar ISO 3166-1 de dos letras, permite aplicar un filtro por país a la busqueda, en caso de que no se envíe, la busqueda será global, más información por aquí.

  • 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 devueltas por el servicio de georreferenciación.

Nota:

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

  • Si la georreferenciación 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, devuelve tres parametros:

    • coords: Un objeto con el primer resultado de la georreferenciación.
    • results: Un objeto con todos los resultados de la georreferenciación.
    • status: Un mensaje con el código del resultado obtenido.

Nota:

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