1. Import
This commit is contained in:
43
html/locating/leaflet-bing-layer-gh-pages/README.md
Normal file
43
html/locating/leaflet-bing-layer-gh-pages/README.md
Normal file
@@ -0,0 +1,43 @@
|
||||
# leaflet-bing-layer
|
||||
|
||||
Bing Maps Layer for Leaflet v1.0.0
|
||||
|
||||
|
||||
### L.TileLayer.Bing(options|BingMapsKey)
|
||||
|
||||
Create a new Bing Maps Layer. Depends on [Promises](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) which needs a polyfill for [older browsers](http://caniuse.com/#feat=promises) by adding this script to your html `<head>`:
|
||||
|
||||
```html
|
||||
<script src="https://cdn.polyfill.io/v2/polyfill.min.js?features=Promise"></script>
|
||||
```
|
||||
|
||||
### Parameters
|
||||
|
||||
| parameter | type | description |
|
||||
| ----------------------------- | -------------- | ----------------------------------------------------------------------------------------------------- |
|
||||
| `options` | string\|object | A valid [Bing Maps Key](https://msdn.microsoft.com/en-us/library/ff428642.aspx) or an `options` object. `options` inherits from [L.TileLayer options](http://mourner.github.io/Leaflet/reference.html#tilelayer-options) (e.g. you can use `minZoom` and `opacity` and etc) |
|
||||
| `options.bingMapsKey` | string | A valid Bing Maps Key [_required_] |
|
||||
| `[options.imagerySet]` | string | _optional:_ [Imagery Type](https://msdn.microsoft.com/en-us/library/ff701716.aspx) [_default=Aerial_]<br>- `Aerial` - Aerial imagery<br>- `AerialWithLabels` - Aerial imagery with a road overlay<br>- `AerialWithLabelsOnDemand` - Aerial imagery with on-demand road overlay.<br>- `CanvasDark` - A dark version of the road maps.<br>- `CanvasLight` - A lighter version of the road maps which also has some of the details such as hill shading disabled.<br>- `CanvasGray` - A grayscale version of the road maps.<br>- `Road` - Roads without additional imagery. Uses the legacy static tile service.<br>- `RoadOnDemand` - Roads without additional imagery. Uses the dynamic tile service.<br>- `OrdnanceSurvey` - Ordnance Survey imagery. This imagery is visible only for the London area.<br>**[Not supported](https://social.msdn.microsoft.com/Forums/en-US/3d80d4a6-f4c9-4926-a336-e0d545b1ef3c/is-it-possible-to-retrieve-birdseye-map-tiles-using-rest-services?forum=bingmapsservices)**: `Birdseye` and `BirdseyeWithLabels` |
|
||||
| `[options.culture]` | string | _optional:_ Language for labels, [see options](https://msdn.microsoft.com/en-us/library/hh441729.aspx) [_default=en_US_] |
|
||||
| `[options.style]` | string | _optional:_ Use a [custom map style](https://msdn.microsoft.com/en-us/library/mt823632.aspx) - only works with the `AerialWithLabelsOnDemand` and `RoadOnDemand` imagerySet options. |
|
||||
|
||||
Other options are passed through to a [Leaflet TileLayer](http://leafletjs.com/reference-1.3.0.html#tilelayer-l-tilelayer)
|
||||
|
||||
### Methods
|
||||
|
||||
| Method | Returns | Description |
|
||||
| ---------- | -------------- | ------------- |
|
||||
| `getMetaData(<LatLng> latlng, <Number> zoom)` | `Promise` | Get the [Bing Imagery metadata](https://msdn.microsoft.com/en-us/library/ff701712.aspx) for a specific [`LatLng`](http://leafletjs.com/reference.html#latlng) and zoom level. `latLng` or `zoom` are optional *if* the layer is attached to a map, they default to current map center and zoom. Returns a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) that resolves to the metadata JSON from Bing |
|
||||
|
||||
### Example
|
||||
|
||||
```js
|
||||
var map = L.map('map').setView([51.505, -0.09], 13)
|
||||
L.tileLayer.bing(MyBingMapsKey).addTo(map)
|
||||
```
|
||||
|
||||
[Live Example](http://digidem.github.io/leaflet-bing-layer/) see [index.html](index.html)
|
||||
|
||||
### License
|
||||
|
||||
MIT
|
||||
Reference in New Issue
Block a user