<!-- Generated by documentation.js. Update this documentation by updating the source code. -->### Table of Contents*   [CSV][1]
*   [Flickr][2]
*   [KartaView][3]
*   [Mapillary][4]
*   [Panoramax][5]
*   [WikiCommons][6]
*   [PicturesManager][7]
*   [PicturesManager#fetcherdone][8]
*   [PicturesManager#fetcherfailed][9]
*   [Detection][10]
*   [LatLng][11]
*   [LatLngBounds][12]
*   [Picture][13]## CSV**Extends Fetcher**CSV fetcher. Allows to serve statically stored images, indexed by a CSV file.
It doesn't need any credentials.### Parameters*   `csv` **[string][14]** The CSV URL
*   `options` **[object][15]?** The fetcher options### nameGet this provider name.Returns **[string][14]** The provider human-readable name.### logoUrlGet this provider logo URL.Returns **[string][14]** The provider logo URL.### homepageUrlGet this provider homepage URL.Returns **[string][14]** The provider homepage URL.### requestPicturesGet all the images in the given area for this provider.
To get pictures when ready, suscribe to the [donepictures][16] event.#### Parameters*   `boundingBox` **[LatLngBounds][12]** The bounding box of the area where you want to get pictures.
*   `options` **[Object][15]?** The options for pictures retrieval.

    *   `options.mindate` **int?** The minimal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).
    *   `options.maxdate` **int?** The maximal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).Returns **[Promise][17]** A promise resolving on pictures as an array.### requestSummaryGet summary statistics about pictures available in the given area.
To get summary when ready, suscribe to the [donesummary][18] event.#### Parameters*   `boundingBox` **[LatLngBounds][12]** The bounding box of the area where you want to get the summary.
*   `options` **[Object][15]?** The options for summary retrieval.

    *   `options.mindate` **int?** The minimal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).
    *   `options.maxdate` **int?** The maximal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).Returns **[Promise][17]** A promise resolving on pictures summary## Flickr**Extends Fetcher**Flickr fetcher.### Parameters*   `apiKey`  The API key for Flickr### ExamplesCredentials for Flickr Fetcher (see PicturesManager)```javascript
fetcherCredentials: {
	flickr: { key: "APIKEY" }
}
```### nameGet this provider name.Returns **[string][14]** The provider human-readable name.### logoUrlGet this provider logo URL.Returns **[string][14]** The provider logo URL.### homepageUrlGet this provider homepage URL.Returns **[string][14]** The provider homepage URL.### requestPicturesGet all the images in the given area for this provider.
To get pictures when ready, suscribe to the [donepictures][16] event.#### Parameters*   `boundingBox` **[LatLngBounds][12]** The bounding box of the area where you want to get pictures.
*   `options` **[object][15]?** The options for pictures retrieval.

    *   `options.mindate` **int?** The minimal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).
    *   `options.maxdate` **int?** The maximal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).Returns **[Promise][17]** A promise resolving on pictures as an array.### requestSummaryGet summary statistics about pictures available in the given area.
To get summary when ready, suscribe to the [donesummary][18] event.#### Parameters*   `boundingBox` **[LatLngBounds][12]** The bounding box of the area where you want to get the summary.
*   `options` **[object][15]?** The options for summary retrieval.

    *   `options.mindate` **int?** The minimal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).
    *   `options.maxdate` **int?** The maximal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).Returns **[Promise][17]** A promise resolving on pictures summary## KartaView**Extends Fetcher**KartaView fetcher.### nameGet this provider name.Returns **[string][14]** The provider human-readable name.### logoUrlGet this provider logo URL.Returns **[string][14]** The provider logo URL.### homepageUrlGet this provider homepage URL.Returns **[string][14]** The provider homepage URL.### requestPicturesGet all the images in the given area for this provider.
To get pictures when ready, suscribe to the [donepictures][16] event.#### Parameters*   `boundingBox` **[LatLngBounds][12]** The bounding box of the area where you want to get pictures.
*   `options` **[object][15]?** The options for pictures retrieval.

    *   `options.mindate` **int?** The minimal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).
    *   `options.maxdate` **int?** The maximal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).Returns **[Promise][17]** A promise resolving on pictures as an array.### requestSummaryGet summary statistics about pictures available in the given area.
To get summary when ready, suscribe to the [donesummary][18] event.#### Parameters*   `boundingBox` **[LatLngBounds][12]** The bounding box of the area where you want to get the summary.
*   `options` **[object][15]?** The options for summary retrieval.

    *   `options.mindate` **int?** The minimal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).
    *   `options.maxdate` **int?** The maximal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).Returns **[Promise][17]** A promise resolving on pictures summary### tagsToPicturesGet a list of pictures URL according to given OSM tags.#### Parameters*   `tags` **[Object][15]** The OSM tags to interpret.Returns **[Array][19]<[string][14]>** The list of pictures URL read from tags.## Mapillary**Extends Fetcher**Mapillary fetcher.### Parameters*   `clientId`  The client ID for the Mapillary API### ExamplesCredentials for Mapillary Fetcher (see PicturesManager)```javascript
fetcherCredentials: {
	mapillary: { key: "APIKEY" }
}
```### nameGet this provider name.Returns **[string][14]** The provider human-readable name.### logoUrlGet this provider logo URL.Returns **[string][14]** The provider logo URL.### homepageUrlGet this provider homepage URL.Returns **[string][14]** The provider homepage URL.### requestPicturesGet all the images in the given area for this provider.
To get pictures when ready, suscribe to the [donepictures][16] event.#### Parameters*   `boundingBox` **[LatLngBounds][12]** The bounding box of the area where you want to get pictures.
*   `options` **[Object][15]?** The options for pictures retrieval. (optional, default `{}`)

    *   `options.mindate` **int?** The minimal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).
    *   `options.maxdate` **int?** The maximal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).Returns **[Promise][17]** A promise resolving on pictures as an array.### requestSummaryGet summary statistics about pictures available in the given area.
To get summary when ready, suscribe to the [donesummary][18] event.#### Parameters*   `boundingBox` **[LatLngBounds][12]** The bounding box of the area where you want to get the summary.
*   `options` **[Object][15]?** The options for summary retrieval. (optional, default `{}`)

    *   `options.mindate` **int?** The minimal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).
    *   `options.maxdate` **int?** The maximal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).Returns **[Promise][17]** A promise resolving on pictures summary### requestDetectionsGet feature detections in the given area.
To get detections when ready, suscribe to the [donedetections][20] event.#### Parameters*   `boundingBox` **[LatLngBounds][12]** The bounding box of the area where you want to get the detections.
*   `options` **[object][15]?** The options for detections retrieval. (optional, default `{}`)

    *   `options.types` **[Array][19]\<int>?** The list of detections types to look for (use Detection.\* constants).Returns **[Promise][17]** A promise resolving on detections### tagsToPicturesGet a list of pictures URL according to given OSM tags.#### Parameters*   `tags` **[Object][15]** The OSM tags to interpret.Returns **[Array][19]<[string][14]>** The list of pictures URL read from tags.## Panoramax**Extends Fetcher**Panoramax fetcher. It doesn't need any credential.### nameGet this provider name.Returns **[string][14]** The provider human-readable name.### logoUrlGet this provider logo URL.Returns **[string][14]** The provider logo URL.### homepageUrlGet this provider homepage URL.Returns **[string][14]** The provider homepage URL.### requestPicturesGet all the images in the given area for this provider.
To get pictures when ready, suscribe to the [donepictures][16] event.#### Parameters*   `boundingBox` **[LatLngBounds][12]** The bounding box of the area where you want to get pictures.
*   `options` **[object][15]?** The options for pictures retrieval.

    *   `options.mindate` **int?** The minimal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).
    *   `options.maxdate` **int?** The maximal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).Returns **[Promise][17]** A promise resolving on pictures as an array.### requestSummaryGet summary statistics about pictures available in the given area.
To get summary when ready, suscribe to the [donesummary][18] event.#### Parameters*   `boundingBox` **[LatLngBounds][12]** The bounding box of the area where you want to get the summary.
*   `options` **[object][15]?** The options for summary retrieval.

    *   `options.mindate` **int?** The minimal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).
    *   `options.maxdate` **int?** The maximal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).Returns **[Promise][17]** A promise resolving on pictures summary### tagsToPicturesGet a list of pictures URL according to given OSM tags.#### Parameters*   `tags` **[Object][15]** The OSM tags to interpret.Returns **[Array][19]<[string][14]>** The list of pictures URL read from tags.## WikiCommons**Extends Fetcher**Wikimedia Commons fetcher. It doesn't need any credentials.### nameGet this provider name.Returns **[string][14]** The provider human-readable name.### logoUrlGet this provider logo URL.Returns **[string][14]** The provider logo URL.### homepageUrlGet this provider homepage URL.Returns **[string][14]** The provider homepage URL.### requestPicturesGet all the images in the given area for this provider.
To get pictures when ready, suscribe to the [donepictures][16] event.#### Parameters*   `boundingBox` **[LatLngBounds][12]** The bounding box of the area where you want to get pictures.
*   `options` **[object][15]?** The options for pictures retrieval.

    *   `options.mindate` **int?** The minimal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).
    *   `options.maxdate` **int?** The maximal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).Returns **[Promise][17]** A promise resolving on pictures as an array.### requestSummaryGet summary statistics about pictures available in the given area.
To get summary when ready, suscribe to the [donesummary][18] event.#### Parameters*   `boundingBox` **[LatLngBounds][12]** The bounding box of the area where you want to get the summary.
*   `options` **[object][15]?** The options for summary retrieval.

    *   `options.mindate` **int?** The minimal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).
    *   `options.maxdate` **int?** The maximal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).Returns **[Promise][17]** A promise resolving on pictures summary### tagsToPicturesGet a list of pictures URL according to given OSM tags.#### Parameters*   `tags` **[Object][15]** The OSM tags to interpret.Returns **[Array][19]<[string][14]>** The list of pictures URL read from tags.## PicturesManager**Extends EventLauncher**PicturesManager retrieves pictures metadata from all available pictures providers.### Parameters*   `options` **[object][15]?** The options for the pictures manager.

    *   `options.fetcherCredentials` **[object][15]?** The credentials for pictures providers. As credentials are specific to each provider, you must see their fetcher documentation for details.
    *   `options.userDefinedFetchers` **[object][15]?** The CSV fetchers, as defined by user. Each one is identified by an unique ID.
    *   `options.usefetchers` **[Array][19]<[String][14]>?** The list of fetchers to use. Fetchers names must be all lowercase without spaces (example: mapillary, wikicommons, flickr). If `ignorefetchers` is also defined, only `usefetchers` parameter is considered. Can be overriden by individuals calls.
    *   `options.ignorefetchers` **[Array][19]<[String][14]>?** The list of fetchers to ignore. Fetchers names must be all lowercase without spaces (example: mapillary, wikicommons, flickr). Can be overriden by individuals calls.### Examples````javascript
```js
let pm = new PicturesManager();
pm.startPicsRetrieval(new LatLngBounds(new LatLng(1.2, 48.7), new LatLng(1.3, 48.8)), { mindate: 754464600000 })
.then(pictures => {
	for(let i=0; i < pictures.length; i++) {
		console.log(pictures[i].pictureUrl);
	}
});

//Example with user-defined fetchers
let pmu = new PicturesManager({
	userDefinedFetchers: {
		ownfetch: {
			csv: "http://my.server.net/own/index.csv", // Mandatory
			name: "OwnFetcher", // Recommended
			homepage: "http://my.server.net/own/", // Optional
			logo: "http://my.server.net/own/logo.png", // Recommended
			bbox: new LatLngBounds(new LatLng(1.2, 48.7), new LatLng(1.3, 48.8)), // Recommended if you server pictures in a specific country/area
			license: "CC By-SA 3.0", // Optional, can be overriden in CSV index
			user: "Default user name" // Optional, can be overriden in CSV index
		}
	}
});
```
````### getFetcherDetailsGet details about available fetchers.Returns **[Object][15]** An object, where keys are fetcher IDs and values are an object { name, homepageUrl, logoUrl }.### startPicsRetrievalAsk for pictures metadata retrieval.
You can listen to [fetcherdone][8] and [fetcherfailed][9] events for watching progress.#### Parameters*   `boundingBox` **[LatLngBounds][12]** The area in which data must be retrieved.
*   `options` **[object][15]?** The options for pictures retrieval.

    *   `options.mindate` **int?** The minimal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).
    *   `options.maxdate` **int?** The maximal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).
    *   `options.usefetchers` **[Array][19]<[String][14]>?** The list of fetchers to use. Fetchers names must be all lowercase without spaces (example: mapillary, wikicommons, flickr). If `ignorefetchers` is also defined, only `usefetchers` parameter is considered.
    *   `options.ignorefetchers` **[Array][19]<[String][14]>?** The list of fetchers to ignore. Fetchers names must be all lowercase without spaces (example: mapillary, wikicommons, flickr).Returns **[Promise][17]** A promise resolving on downloaded pictures### startPicsRetrievalAroundAsk for pictures metadata retrieval in a circle.
You can listen to [fetcherdone][8] and [fetcherfailed][9] events for watching progress.#### Parameters*   `center` **[LatLng][11]** The center of the circle.
*   `radius` **int** The radius of the circle, in meters.
*   `options` **[object][15]?** The options for pictures retrieval.

    *   `options.mindate` **int?** The minimal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).
    *   `options.maxdate` **int?** The maximal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).
    *   `options.usefetchers` **[Array][19]<[String][14]>?** The list of fetchers to use. Fetchers names must be all lowercase without spaces (example: mapillary, wikicommons, flickr). If `ignorefetchers` is also defined, only `usefetchers` parameter is considered.
    *   `options.ignorefetchers` **[Array][19]<[String][14]>?** The list of fetchers to ignore. Fetchers names must be all lowercase without spaces (example: mapillary, wikicommons, flickr).
    *   `options.towardscenter` **[boolean][21]?** Set to true if you only want pictures pointing towards center. Defaults to false.
    *   `options.cameraAngle` **int?** The opening angle of camera in degrees (defaults to 70°)Returns **[Promise][17]** A promise resolving on downloaded pictures### startSummaryRetrievalAsk for pictures availability summary in a given area.
You can listen to [fetcherdone][8] and [fetcherfailed][9] events for watching progress.#### Parameters*   `boundingBox` **[LatLngBounds][12]** The area in which data must be retrieved.
*   `options` **[object][15]?** The options for summary retrieval.

    *   `options.mindate` **int?** The minimal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).
    *   `options.maxdate` **int?** The maximal capture date pictures should have, in milliseconds since 1st January 1970 (Unix time).
    *   `options.usefetchers` **[Array][19]<[String][14]>?** The list of fetchers to use. Fetchers names must be all lowercase without spaces (example: mapillary, wikicommons, flickr). If `ignorefetchers` is also defined, only `usefetchers` parameter is considered.
    *   `options.ignorefetchers` **[Array][19]<[String][14]>?** The list of fetchers to ignore. Fetchers names must be all lowercase without spaces (example: mapillary, wikicommons, flickr).Returns **[Promise][17]** A promise resolving on pictures statistics### startDetectionsRetrievalAsk for features images providers have automatically detected.
You can listen to [fetcherdone][8] and [fetcherfailed][9] events for watching progress.#### Parameters*   `boundingBox` **[LatLngBounds][12]** The area in which data must be retrieved.
*   `options` **[object][15]?** The options for detections retrieval.

    *   `options.types` **[Array][19]\<int>?** The list of feature types to look for (use Detection.\* constants)
    *   `options.usefetchers` **[Array][19]<[String][14]>?** The list of fetchers to use. Fetchers names must be all lowercase without spaces (example: mapillary, wikicommons, flickr). If `ignorefetchers` is also defined, only `usefetchers` parameter is considered.
    *   `options.ignorefetchers` **[Array][19]<[String][14]>?** The list of fetchers to ignore. Fetchers names must be all lowercase without spaces (example: mapillary, wikicommons, flickr).
    *   `options.asgeojson` **[boolean][21]?** Set to true if result should be returned as a GeoJSON feature collectionReturns **[Promise][17]** A promise resolving on downloaded detections### getPicturesFromTagsRead pictures URL from OpenStreetMap tags.#### Parameters*   `tags` **[Object][15]** The OpenStreetMap tags.Returns **[Array][19]<[string][14]>** A list of read pictures URL.## PicturesManager#fetcherdoneEvent sent when a fetcher has done its data retrieval.Type: [string][14]### Examples```javascript
let pm = new PicturesManager();
pm.on("fetcherdone", fetcherId => {
	console.log("Fetcher "+fetcherId+" has done its job");
});
pm.startPicsRetrieval(new LatLngBounds(new LatLng(1.2, 42.3), new LatLng(1.3, 42.4)));
```## PicturesManager#fetcherfailedEvent sent when a fetcher has failed to retrieve data.Type: [string][14]### Examples```javascript
let pm = new PicturesManager();
pm.on("fetcherfailed", fetcherId => {
	console.log("Fetcher "+fetcherId+" has failed");
});
pm.startPicsRetrieval(new LatLngBounds(new LatLng(1.2, 42.3), new LatLng(1.3, 42.4)));
```## DetectionA detection is a geolocated feature extracted from analysis of provider pictures.
It has mainly a type (stop sign, crossing, hydrant...) and coordinates.### Parameters*   `type` **int** The kind of feature (use class constants)
*   `coordinates` **[LatLng][11]** The feature geolocation
*   `date` **[Date][22]** When the feature was detected, in milliseconds since 1st January 1970 (Unix time).
*   `provider` **[string][14]** The detection provider### typeThe feature type (for example, stop sign, hydrant, bench...) \*### coordinatesThe feature geolocation \*### dateThe date when the feature was detected \*### providerThe detection provider \*### OBJECT\_BENCHBench type \*### SIGN\_STOPStop sign type \*### MARK\_CROSSINGPedestrian crossing type \*### OBJECT\_BICYCLE\_PARKINGBicycle parking type \*### OBJECT\_CCTVCCTV type \*### OBJECT\_HYDRANTFire hydrant type \*### OBJECT\_POSTBOXPost box type \*### OBJECT\_MANHOLEManhole type \*### OBJECT\_PARKING\_METERParking meter type \*### OBJECT\_PHONETelephone type \*### SIGN\_ADVERTAdvert sign type \*### SIGN\_INFOInformation sign type \*### SIGN\_STOREStore sign type \*### OBJECT\_STREET\_LIGHTStreet light type \*### OBJECT\_POLEPole type \*### OBJECT\_UTILITY\_POLEUtility pole type \*### SIGN\_RESERVED\_PARKINGReserved parking type \*### SIGN\_ANIMAL\_CROSSINGAnimal crossing (all kind) type \*### SIGN\_RAILWAY\_CROSSINGRailway crossing type \*### TYPE\_DETAILSDetails for features types
Use Detection.\* constants as key, which gives you { name, osmTags, symbol } object as value.## LatLng*   **See**: [https://github.com/Leaflet/Leaflet/blob/master/src/geo/LatLng.js][23]Represents a geographical point with a certain latitude and longitude.### Parameters*   `lat` **float** The latitude, in degrees.
*   `lng` **float** The longitude, in degrees.
*   `alt` **float?** The altitude, in meters.### Examples```javascript
var latlng = new LatLng(50.5, 30.5);
```**Meta***   **author**: Leaflet Team## LatLngBounds*   **See**: [https://github.com/Leaflet/Leaflet/blob/master/src/geo/LatLngBounds.js][24]Represents a rectangular geographical area on a map.
Caution: if the area crosses the antimeridian (often confused with the International Date Line), you must specify corners *outside* the \[-180, 180] degrees longitude range.### Parameters*   `corner1` **[LatLng][11]** The south-west corner of the box.
*   `corner2` **[LatLng][11]** The north-east corner of the box.### Examples```javascript
var corner1 = new LatLng(40.712, -74.227),
corner2 = new LatLng(40.774, -74.125),
bounds = new LatLngBounds(corner1, corner2);
```**Meta***   **author**: Leaflet Team## PictureA picture is an image took by an author, made available freely by a given provider.
It has coordinates associated, and some other metadata.### Parameters*   `pictureUrl` **[string][14]** The picture URL.
*   `date` **int** The date where picture was taken, in milliseconds since 1st January 1970 (Unix time).
*   `coords` **[LatLng][11]** The coordinates where picture was taken.
*   `provider` **[string][14]** The provider of the given picture.
*   `author` **[string][14]?** The author of the picture.
*   `license` **[string][14]?** The license of this picture.
*   `detailsUrl` **[string][14]?** The URL where more details about the picture can be found.
*   `direction` **int?** The direction at which picture was taken, in degrees (0° = North, 90° = East, 180° = South, 270° = West).
*   `osmTags` **[Object][15]?** Tags describing this picture in OSM key/value format
*   `thumbUrl` **[string][14]?** The URL where you can find a small-sized version of the picture
*   `details` **[Object][15]?** Other picture details

    *   `details.isSpherical` **[boolean][21]?** Is it a 360° picture ?### pictureUrlThe picture URL.### dateThe date where picture was taken, in milliseconds since 1st January 1970 (Unix time).### coordinatesThe coordinates where picture was taken.### providerThe provider of the given picture.### authorThe author of the picture.### licenseThe license of this picture.### detailsUrlThe URL where more details about the picture can be found.### directionThe direction at which picture was taken, in degrees (0° = North, 90° = East, 180° = South, 270° = West).### osmTagsTags describing this picture in OSM key/value format### thumbUrlThe URL where thumbnail can be found### detailsThe other details about the picture \*### lookAlikeTest if two pictures seems very similar (regarding timestamp, location and direction)#### Parameters*   `other` **[Picture][13]** The picture to compare with the current oneReturns **[boolean][21]** True if look alike[1]: #csv[2]: #flickr[3]: #kartaview[4]: #mapillary[5]: #panoramax[6]: #wikicommons[7]: #picturesmanager[8]: #picturesmanagerfetcherdone[9]: #picturesmanagerfetcherfailed[10]: #detection[11]: #latlng[12]: #latlngbounds[13]: #picture[14]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String[15]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object[16]: #fetcherdonepictures[17]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise[18]: #fetcherdonesummary[19]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array[20]: #fetcherdonedetections[21]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean[22]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Date[23]: https://github.com/Leaflet/Leaflet/blob/master/src/geo/LatLng.js[24]: https://github.com/Leaflet/Leaflet/blob/master/src/geo/LatLngBounds.js
