o Pf[@sHdZddlZddlmZddlmZmZmZmZm Z m Z m Z ddl m Z mZmZmZddlmZddlmZmZddlmZmZmZmZmZmZmZGd d d eZGd d d eZGd ddeZ GdddeZ!GdddeZ"GdddeZ#Gddde Z$GdddeZ%GdddeZ&GdddeZ'GdddeZ(dS)z Classes for drawing maps. N) OrderedDict)DictListOptionalSequenceTupleTypeUnion)ElementFigureHtml MacroElement)Template)ElementAddToElement EventHandler)JsCode TypeBounds TypeJsonValuecamelizeescape_backticks parse_optionsvalidate_locationc@seZdZdZdefddZdS)Eventeda:The base class for Layer and Map Adds the `on` method for event handling capabilities. See https://leafletjs.com/reference.html#evented for more in depth documentation. Please note that we have only added the `on( eventMap)` variant of this method using python keyword arguments. event_mapcKs&|D] \}}|t||qdSN)items add_childr)selfr event_typehandlerr V/home/deployuser/azure_apps/autowriter/venv/lib/python3.10/site-packages/folium/map.pyon$sz Evented.onN)__name__ __module__ __qualname____doc__rr"r r r r!rs rc sLeZdZdZ    d deedededeffd d Zfd d ZZ S)Layera:An abstract class for everything that is a Layer on the map. It will be used to define whether an object will be included in LayerControls. Parameters ---------- name : string, default None The name of the Layer, as it will appear in LayerControls overlay : bool, default False Adds the layer as an optional overlay (True) or the base layer (False). control : bool, default True Whether the Layer will be included in LayerControls. show: bool, default True Whether the layer will be shown on opening. NFTnameoverlaycontrolshowcs6t|dur |n||_||_||_||_dSr)super__init__get_name layer_namer)r*r+)rr(r)r*r+ __class__r r!r-:s  zLayer.__init__c sD|jr|jt||jd|ddtjdi|dS)N) element_nameelement_parent_name_addr(r )r+rrr._parentr,render)rkwargsr0r r!r7Gs z Layer.render)NFTT) r#r$r%r&rstrboolr-r7 __classcell__r r r0r!r')s  r'c sLeZdZdZedZ    d deedededed e f fd d Z Z S) FeatureGroupau Create a FeatureGroup layer ; you can put things in it and handle them as a single layer. For example, you can add a LayerControl to tick/untick the whole group. Parameters ---------- name : str, default None The name of the featureGroup layer. It will be displayed in the LayerControl. If None get_name() will be called to get the technical (ugly) name. overlay : bool, default True Whether your layer will be an overlay (ticked with a check box in LayerControls) or a base layer (ticked with a radio button). control: bool, default True Whether the layer will be included in LayerControls. show: bool, default True Whether the layer will be shown on opening. **kwargs Additional (possibly inherited) options. See https://leafletjs.com/reference.html#featuregroup z {% macro script(this, kwargs) %} var {{ this.get_name() }} = L.featureGroup( {{ this.options|tojson }} ); {% endmacro %} NTr(r)r*r+r8c sDtj||||dd|_|dur|n||_tdi||_dS)N)r(r)r*r+r<r )r,r-_namer. tile_nameroptions)rr(r)r*r+r8r0r r!r-vszFeatureGroup.__init__)NTTT) r#r$r%r&r _templaterr9r:rr-r;r r r0r!r<Ss( r<c s`eZdZdZedZ    ddededed ed ef fd d Z dddZ dfdd Z Z S) LayerControla Creates a LayerControl object to be added on a folium map. This object should be added to a Map object. Only Layer children of Map are included in the layer control. Note ---- The LayerControl should be added last to the map. Otherwise, the LayerControl and/or the controlled layers may not appear. Parameters ---------- position : str The position of the control (one of the map corners), can be 'topleft', 'topright', 'bottomleft' or 'bottomright' default: 'topright' collapsed : bool, default True If true the control will be collapsed into an icon and expanded on mouse hover or touch. autoZIndex : bool, default True If true the control assigns zIndexes in increasing order to all of its layers so that the order is preserved when switching them on/off. draggable: bool, default False By default the layer control has a fixed position. Set this argument to True to allow dragging the control around. **kwargs Additional (possibly inherited) options. See https://leafletjs.com/reference.html#control-layers a {% macro script(this,kwargs) %} var {{ this.get_name() }}_layers = { base_layers : { {%- for key, val in this.base_layers.items() %} {{ key|tojson }} : {{val}}, {%- endfor %} }, overlays : { {%- for key, val in this.overlays.items() %} {{ key|tojson }} : {{val}}, {%- endfor %} }, }; let {{ this.get_name() }} = L.control.layers( {{ this.get_name() }}_layers.base_layers, {{ this.get_name() }}_layers.overlays, {{ this.options|tojson }} ).addTo({{this._parent.get_name()}}); {%- if this.draggable %} new L.Draggable({{ this.get_name() }}.getContainer()).enable(); {%- endif %} {% endmacro %} toprightTFposition collapsed autoZIndex draggabler8c sBtd|_td|||d||_||_t|_t|_dS)NrA)rCrDrEr ) r,r-r=rr?rFr base_layersoverlays)rrCrDrErFr8r0r r!r-s  zLayerControl.__init__returnNcCst|_t|_dSr)rrGrHrr r r!resets zLayerControl.resetc sd||jjD] }t|tr|jsq |j}|js#| |j |<q | |j |<q t dS)/Renders the HTML representation of the element.N)rKr6 _childrenvalues isinstancer'r*r/r)r.rGrHr,r7)rr8itemkeyr0r r!r7szLayerControl.render)rBTTFrIN) r#r$r%r&rr@r9r:rr-rKr7r;r r r0r!rAs,  rAc sVeZdZdZedZhdZ     dd ed ed ed ed ede f fdd Z Z S)Icona] Creates an Icon object that will be rendered using Leaflet.awesome-markers. Parameters ---------- color : str, default 'blue' The color of the marker. You can use: ['red', 'blue', 'green', 'purple', 'orange', 'darkred', 'lightred', 'beige', 'darkblue', 'darkgreen', 'cadetblue', 'darkpurple', 'white', 'pink', 'lightblue', 'lightgreen', 'gray', 'black', 'lightgray'] icon_color : str, default 'white' The color of the drawing on the marker. You can use colors above, or an html color code. icon : str, default 'info-sign' The name of the marker sign. See Font-Awesome website to choose yours. Warning : depending on the icon you choose you may need to adapt the `prefix` as well. angle : int, default 0 The icon will be rotated by this amount of degrees. prefix : str, default 'glyphicon' The prefix states the source of the icon. 'fa' for font-awesome or 'glyphicon' for bootstrap 3. https://github.com/lvoogdt/Leaflet.awesome-markers a  {% macro script(this, kwargs) %} var {{ this.get_name() }} = L.AwesomeMarkers.icon( {{ this.options|tojson }} ); {{ this._parent.get_name() }}.setIcon({{ this.get_name() }}); {% endmacro %} >redbluegraypinkbeigeblackgreenwhiteorangepurpledarkreddarkbluelightred cadetblue darkgreen lightblue lightgray darkpurple lightgreenrUr[ info-signr glyphiconcolor icon_coloriconangleprefixr8c sXtd|_||jvrtjd|jdddtd||||d|d||_dS) NrSz)color argument of Icon should be one of: .) stacklevelz fa-rotate-) marker_colorrjrkrm extra_classesr )r,r-r= color_optionswarningswarnrr?)rrirjrkrlrmr8r0r r!r-&s    z Icon.__init__)rUr[rgrrh) r#r$r%r&rr@rsr9intrr-r;r r r0r!rSs0  rSc seZdZdZedZ     ddeeede de dfde d e dfd ee d e d e f fd d ZdeeefddZdfdd ZZS)Markera] Create a simple stock Leaflet marker on the map, with optional popup text or Vincent visualization. Parameters ---------- location: tuple or list Latitude and Longitude of Marker (Northing, Easting) popup: string or folium.Popup, default None Label for the Marker; either an escaped HTML string to initialize folium.Popup or a folium.Popup instance. tooltip: str or folium.Tooltip, default None Display a text when hovering over the object. icon: Icon plugin the Icon plugin to use to render the marker. draggable: bool, default False Set to True to be able to drag the marker around the map. Returns ------- Marker names and HTML in obj.template_vars Examples -------- >>> Marker(location=[45.5, -122.3], popup="Portland, OR") >>> Marker(location=[45.5, -122.3], popup=Popup("Portland, OR")) # If the popup label has characters that need to be escaped in HTML >>> Marker( ... location=[45.5, -122.3], ... popup=Popup("Mom & Pop Arrow Shop >>", parse_html=True), ... ) a {% macro script(this, kwargs) %} var {{ this.get_name() }} = L.marker( {{ this.location|tojson }}, {{ this.options|tojson }} ).addTo({{ this._parent.get_name() }}); {% endmacro %} NFlocationpopupPopuptooltipTooltiprkrFr8c std|_|durt|nd|_td|pd|pdd||_|dur.||||_|durB|t |t r;|nt t ||durX|t |t rO|nt t |dSdS)Nrw)rFautoPanr ) r,r-r=rrxrr?rrkrOrzr9r|)rrxryr{rkrFr8r0r r!r-ms$    zMarker.__init__rIcCs|jdusJ|j|jgS)zyComputes the bounds of the object itself. Because a marker has only single coordinates, we repeat them. N)rxrJr r r!_get_self_boundss zMarker._get_self_boundscs(|jdur t|jdtdS)Nz6 location must be assigned when added directly to map.)rx ValueErrorr=r,r7rJr0r r!r7s  z Marker.render)NNNNFrR)r#r$r%r&rr@rrfloatr r9rSr:rr-rr~r7r;r r r0r!rw@s2!    rwcspeZdZdZedZ      ddeeedfde deee fd e d e d e d e ffd d Z dddZ ZS)rzaCreate a Popup instance that can be linked to a Layer. Parameters ---------- html: string or Element Content of the Popup. parse_html: bool, default False True if the popup is a template that needs to the rendered first. max_width: int for pixels or text for percentages, default '100%' The maximal width of the popup. show: bool, default False True renders the popup open on page load. sticky: bool, default False True prevents map and other popup clicks from closing. lazy: bool, default False True only loads the Popup content when clicking on the Marker. aG var {{this.get_name()}} = L.popup({{ this.options|tojson }}); {% for name, element in this.html._children.items() %} {% if this.lazy %} {{ this._parent.get_name() }}.once('click', function() { {{ this.get_name() }}.setContent($(`{{ element.render(**kwargs).replace('\n',' ') }}`)[0]); }); {% else %} var {{ name }} = $(`{{ element.render(**kwargs).replace('\n',' ') }}`)[0]; {{ this.get_name() }}.setContent({{ name }}); {% endif %} {% endfor %} {{ this._parent.get_name() }}.bindPopup({{ this.get_name() }}) {% if this.show %}.openPopup(){% endif %}; {% for name, element in this.script._children.items() %} {{element.render()}} {% endfor %} NF100%html parse_html max_widthr+stickylazyr8c  std|_t|_t|_t|_||j_||j_||j_| }t|tr/|j |nt|t rBt |}|j t ||d||_ ||_td||sO|rQdnd|rVdndd||_dS)Nrz)scriptF)r autoClose closeOnClickr )r,r-r=r headerrrr6rOrr9rr r+rrr?) rrrrr+rrr8rr0r r!r-s.     zPopup.__init__rIcKsf|jD] \}}|jdi|q|}t|tsJd|jjt|j j||d| ddS)rLz8You cannot render this Element if it is not in a Figure.)thisr8r5Nr ) rMrr7get_rootrOr rrr r@r.)rr8r(childfigurer r r!r7s z Popup.render)NFrFFFrR)r#r$r%r&rr@r r9r r:rvrr-r7r;r r r0r!rzs6  %rzc seZdZUdZedZefefefefefefe e fefefd Z e ee edffed<  dded eed ed effd d Zd e eefde eeffddZZS)r|a~ Create a tooltip that shows text when hovering over its parent object. Parameters ---------- text: str String to display as a tooltip on the object. If the argument is of a different type it will be converted to str. style: str, default None. HTML inline style properties like font and colors. Will be applied to a div with the text in it. sticky: bool, default True Whether the tooltip should follow the mouse. **kwargs These values will map directly to the Leaflet Options. More info available here: https://leafletjs.com/reference.html#tooltip aK {% macro script(this, kwargs) %} {{ this._parent.get_name() }}.bindTooltip( ` {{ this.text }} `, {{ this.options|tojson }} ); {% endmacro %} ) paneoffset direction permanentr interactiveopacity attribution className. valid_optionsNTtextstylerr8c sXtd|_t||_|d|i|||_|r*t|ts%Jd||_ dSdS)Nr|rz8Pass a valid inline HTML style property string to style.) r,r-r=r9rupdaterr?rOr)rrrrr8r0r r!r-"s    zTooltip.__init__rIcCsvdd|D}|D]+}||jvs Jd|d|jt|||j|s8Jd|d|j|dq |S)z?Validate the provided kwargs and return options as json string.cSsi|] \}}t||qSr )r).0rQvaluer r r! =sz)Tooltip.parse_options..z2The option {} is not in the available options: {}.z, z The option z% must be one of the following types: rn)rkeysrformatjoinrO)rr8rQr r r!r8s   zTooltip.parse_options)NT)r#r$r%r&rr@r9tupler:rrvrrrr__annotations__rrr-rr;r r r0r!r|s>    r|c sdeZdZdZedZ    d dedeee deee deee dee f fd d Z Z S) FitBoundsaFit the map to contain a bounding box with the maximum zoom level possible. Parameters ---------- bounds: list of (latitude, longitude) points Bounding box specified as two points [southwest, northeast] padding_top_left: (x, y) point, default None Padding in the top left corner. Useful if some elements in the corner, such as controls, might obscure objects you're zooming to. padding_bottom_right: (x, y) point, default None Padding in the bottom right corner. padding: (x, y) point, default None Equivalent to setting both top left and bottom right padding to the same value. max_zoom: int, default None Maximum zoom to be used. z {% macro script(this, kwargs) %} {{ this._parent.get_name() }}.fitBounds( {{ this.bounds|tojson }}, {{ this.options|tojson }} ); {% endmacro %} Nboundspadding_top_leftpadding_bottom_rightpaddingmax_zoomcs,td|_||_t||||d|_dS)Nr)rrrr)r,r-r=rrr?)rrrrrrr0r r!r-js  zFitBounds.__init__)NNNN) r#r$r%r&rr@rrrrrvr-r;r r r0r!rJs(   rc sHeZdZdZedZ    d dedeed ed effd d Z Z S) FitOverlaysaFit the bounds of the maps to the enabled overlays. Parameters ---------- padding: int, default 0 Amount of padding in pixels applied in the corners. max_zoom: int, optional The maximum possible zoom to use when fitting to the bounds. fly: bool, default False Use a smoother, longer animation. fit_on_map_load: bool, default True Apply the fit when initially loading the map. a {% macro script(this, kwargs) %} function customFlyToBounds() { let bounds = L.latLngBounds([]); {{ this._parent.get_name() }}.eachLayer(function(layer) { if (typeof layer.getBounds === 'function') { bounds.extend(layer.getBounds()); } }); if (bounds.isValid()) { {{ this._parent.get_name() }}.{{ this.method }}(bounds, {{ this.options|tojson }}); } } {{ this._parent.get_name() }}.on('overlayadd', customFlyToBounds); {%- if this.fit_on_map_load %} customFlyToBounds(); {%- endif %} {% endmacro %} rNFTrrflyfit_on_map_loadcs:td|_|r dnd|_||_t||f|d|_dS)Nr flyToBounds fitBounds)rr)r,r-r=methodrrr?)rrrrrr0r r!r-s zFitOverlays.__init__)rNFT) r#r$r%r&rr@rvrr:r-r;r r r0r!r}s$rcsDeZdZdZedZ  d dedeeefde ffdd Z Z S) CustomPanean Creates a custom pane to hold map elements. Behavior is as in https://leafletjs.com/examples/map-panes/ Parameters ---------- name: string Name of the custom pane. Other map elements can be added to the pane by specifying the 'pane' kwarg when constructing them. z_index: int or string, default 625 The z-index that will be associated with the pane, and will determine which map elements lie over/under it. The default (625) corresponds to between markers and tooltips. Default panes and z-indexes can be found at https://leafletjs.com/reference.html#map-pane pointer_events: bool, default False Whether or not layers in the pane should interact with the cursor. Setting to False will prevent interfering with pointer events associated with lower layers. a {% macro script(this, kwargs) %} var {{ this.get_name() }} = {{ this._parent.get_name() }}.createPane( {{ this.name|tojson }}); {{ this.get_name() }}.style.zIndex = {{ this.z_index|tojson }}; {% if not this.pointer_events %} {{ this.get_name() }}.style.pointerEvents = 'none'; {% endif %} {% endmacro %} qFr(z_indexpointer_eventscs&td|_||_||_||_dS)NPane)r,r-r=r(rr)rr(rrr0r r!r-s  zCustomPane.__init__)rF) r#r$r%r&rr@r9r rvr:r-r;r r r0r!rs r))r&rt collectionsrtypingrrrrrrr branca.elementr r r r jinja2rfolium.elementsrrfolium.utilitiesrrrrrrrrr'r<rArSrwrzr|rrrr r r r!s& $ $ *1a[V`T33