<commit_before># donde.js v0.3.2

Donde.js es una bibloteca de JavaScript que facilita el uso del servicio GoogleMaps para acciones como:

* Agregar un mapa al sitio.
* Centrar el mapa en la locación actual del usuario.
* Agregar marcadores al mapa.
* Permitir al usuario filtrar los marcadores.

## Instalación

Bajar desde la [pagina del projecto](https://github.com/HiroAgustin/donde.js).

Utilizando [Bower](http://twitter.github.com/bower/): `bower install donde.js`.

## API

La forma más simple del codigo se reduce a: `new Donde(options).init();`
siendo "options" un objecto con cualquiera de los siguientes attributos:

### idMap

Un string con la id del elemento en el cual se va a renderear el mapa.
Por defecto buscamos la id "map": `mapId: 'map'`.

### defaultLocation

En caso de que no se pueda obtener la geo-localización del usuario, el mapa se centrará en base a este objeto.
El mismo debe de tener 2 attributos: "latitude" y "longitude".

Por defecto lo centramos en la terminal de Tres Cruces en Montevideo, Uruguay:

```
defaultLocation: {
  latitude: -34.8937720817105
, longitude: -56.1659574508667
}
```

### markers

Un array de objectos, cada uno va a ser agregado al mapa como un marcador.
Es necesario que contengan la información sobre el lugar a ser colocados.
En caso de querer asociar el marcador a una imagen, debe de tener un "type".

Ejemplo:
```
markers: [
  {latitude: -34.790626820565095, longitude: -56.352119473107685, type: 'Super'}
, {latitude: -34.79742147359551, longitude: -56.24659744591109, type: 'Baile'}
, {latitude: -34.81001579769451, longitude: -56.221292252489484, type: 'Super'}
, {latitude: -34.81661616310021, longitude: -56.13930858324866, type: 'Kiosco'}
  ...
]
```

### mapping

Es posible que la data de los marcadores no se encuentre en el formato deseado, en esos casos
usamos el atributo mapping para mapear los valores de los datos con los requeridos por la bibloteca.

Ejemplo:
```
mapping: {
  latitude: function (marker)
  {
    return marker.geometry.coordinates[1]
  }
, longitude: function (marker)
  {
    return marker.geometry.coordinates[0]
  }
, type: function (marker)
  {
    return item.properties.NAME;
  }
}
```

### icons

Un objeto que mapea el tipo de marcador ("type") con la imagen a utilizar en el mapa. Ejemplo:

```
icons: {
  Super: 'img/marker-super.png'
, Baile: 'img/marker-baile.png'
, Kiosco: 'img/marker-kiosco.png'
  ...
}
```
**Recordar:** la url de la imagen es relativa al lugar donde llaman al script.

***

Por más detalles sobre los posibles attributos y metodos disponibles, ver los ejemplos.

## Contribuidores

* [<NAME>](https://github.com/HiroAgustin) - [@hiroagustin](https://twitter.com/hiroagustin)
* [<NAME>](https://github.com/nmontesdeoca) - [@_nmontesdeoca](https://twitter.com/_nmontesdeoca)

Cualquier tipo de colaboración o comentario es agradecido **:)**<commit_msg>update readme to english<commit_after># donde.js

> Simplifies the basic use of Google Maps.

This being:

* Embedding a map.
* Centering to the user's current location.
* Add a set of markers to the map.
* Apply a filter to the markers.

## Installation

Install the library by running: `bower install donde.js --save`.

## Usage

Once you have included the script in your markup, you can run:

```js
new Donde({
  container: 'js-map'
, zoom: 15
, defaultPosition: {
    latitude: -34.8937720817105
  , longitude: -56.1659574508667
  }
, markers: [
    {
      icon: 'img/marker-1.png'
    , type: 'A'
    , position: {
        latitude: -34.790626820565095
      , longitude: -56.352119473107685,
      }
    }
  , {
      icon: 'img/marker-2.png'
    , type: 'B'
    , position: {
        latitude: -34.79742147359551
      , longitude: -56.24659744591109
      }
    }
  ]
});
```

## Options

1. `container` is the id of the DOM element where the map will be rendered.

2. `zoom` is the map's default zoom value.

3. `defaultPosition` is where the map will be centered and the user's marker positioned in case geolocation is unavailable.

4. Markers
    * `icon` is the path to the markers image.
    * `type` is used for the filtering of markers.
    * `position` is the geolocation where the marker should be placed.

## License

[MIT license](https://github.com/HiroAgustin/donde.js/blob/master/LICENSE.md).

{'fraction_non_alphanumeric': 0.11346198558474774, 'fraction_numerical': 0.06300860265054639, 'mean_word_length': 3.6710097719869705, 'pattern_counts': {'":': 1, '<': 5, '<?xml version=': 0, '>': 6, 'https://': 6, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6376182', 'n_tokens_mistral': 1704, 'n_tokens_neox': 1512, 'n_words': 505}