From 75b1d0d074f9f795af0266e32bddbaa5f82b1ea7 Mon Sep 17 00:00:00 2001
From: Stefan Kuethe <stefan.kuethe@eoda.de>
Date: Thu, 23 May 2024 22:51:44 +0200
Subject: [PATCH] Deployed 28fc2fe with MkDocs version: 1.6.0

---
 changelog/index.html                          |  22 +++
 .../__pycache__/app.cpython-39.pyc            | Bin 2705 -> 2706 bytes
 examples/earthquake_clusters/app.py           |   6 +-
 examples/earthquake_clusters/index.html       |  10 +-
 .../__pycache__/app.cpython-39.pyc            | Bin 2718 -> 2664 bytes
 examples/every_person_in_manhattan/app.py     |   5 +-
 examples/every_person_in_manhattan/index.html | 151 +++++++++---------
 search/search_index.json                      |   2 +-
 sitemap.xml.gz                                | Bin 127 -> 127 bytes
 9 files changed, 106 insertions(+), 90 deletions(-)

diff --git a/changelog/index.html b/changelog/index.html
index a127f594..e21e292e 100644
--- a/changelog/index.html
+++ b/changelog/index.html
@@ -470,6 +470,15 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#maplibre-v015" class="md-nav__link">
+    <span class="md-ellipsis">
+      maplibre v0.1.5
+    </span>
+  </a>
+  
+</li>
+      
         <li class="md-nav__item">
   <a href="#maplibre-v014" class="md-nav__link">
     <span class="md-ellipsis">
@@ -953,6 +962,15 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
       
+        <li class="md-nav__item">
+  <a href="#maplibre-v015" class="md-nav__link">
+    <span class="md-ellipsis">
+      maplibre v0.1.5
+    </span>
+  </a>
+  
+</li>
+      
         <li class="md-nav__item">
   <a href="#maplibre-v014" class="md-nav__link">
     <span class="md-ellipsis">
@@ -1008,6 +1026,10 @@
 
 
 <h1 id="changelog-for-maplibre-for-python">Changelog for MapLibre for Python</h1>
+<h2 id="maplibre-v015">maplibre v0.1.5</h2>
+<ul>
+<li>Update deprecated render function to support <code>shiny&gt;=0.7.0</code></li>
+</ul>
 <h2 id="maplibre-v014">maplibre v0.1.4</h2>
 <ul>
 <li><code>anywidget&gt;=0.9.0</code> (#36)</li>
diff --git a/examples/earthquake_clusters/__pycache__/app.cpython-39.pyc b/examples/earthquake_clusters/__pycache__/app.cpython-39.pyc
index 675ad2d52d8789da4dd7baa54ef6dcf993c50646..108983bdd0fe40ffe8c9daae90d809a0d3759214 100644
GIT binary patch
delta 59
zcmbOzI!Tl_k(ZZ?0SKln@lR9S$ZNsK$U51LQJax%auMUY$wo|a9Jd6EQu9($i#EG5
O-C|{A->kq<$OHhWDi1OM

delta 68
zcmbOvI#HB2k(ZZ?0SFQut<p?4@>(!5vQ2hl)MjL#T*SCeP{22_z$Y`QC^aZGFD11o
WwP><Dll<mDrt_?fteX`%3Yh>V!x4M{

diff --git a/examples/earthquake_clusters/app.py b/examples/earthquake_clusters/app.py
index ce16e3a0..1342b8ee 100644
--- a/examples/earthquake_clusters/app.py
+++ b/examples/earthquake_clusters/app.py
@@ -3,10 +3,10 @@
 from maplibre import (
     Layer,
     LayerType,
-    Map,  # render_maplibregl,
-    MapLibreRenderer,
+    Map,
     MapOptions,
     output_maplibregl,
+    render_maplibregl,
 )
 from maplibre.basemaps import Carto
 from maplibre.sources import GeoJSONSource
@@ -89,7 +89,7 @@ def create_map() -> Map:
 
 
 def server(input, output, session):
-    @MapLibreRenderer
+    @render_maplibregl
     def maplibre():
         return create_map()
 
diff --git a/examples/earthquake_clusters/index.html b/examples/earthquake_clusters/index.html
index a9e41cb2..ae927d13 100644
--- a/examples/earthquake_clusters/index.html
+++ b/examples/earthquake_clusters/index.html
@@ -897,10 +897,10 @@ <h1>Earthquake clusters</h1>
 </span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="kn">from</span> <span class="nn">maplibre</span> <span class="kn">import</span> <span class="p">(</span>
 </span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a>    <span class="n">Layer</span><span class="p">,</span>
 </span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a>    <span class="n">LayerType</span><span class="p">,</span>
-</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a>    <span class="n">Map</span><span class="p">,</span>  <span class="c1"># render_maplibregl,</span>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a>    <span class="n">MapLibreRenderer</span><span class="p">,</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a>    <span class="n">MapOptions</span><span class="p">,</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a>    <span class="n">output_maplibregl</span><span class="p">,</span>
+</span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a>    <span class="n">Map</span><span class="p">,</span>
+</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a>    <span class="n">MapOptions</span><span class="p">,</span>
+</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a>    <span class="n">output_maplibregl</span><span class="p">,</span>
+</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a>    <span class="n">render_maplibregl</span><span class="p">,</span>
 </span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a><span class="p">)</span>
 </span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="kn">from</span> <span class="nn">maplibre.basemaps</span> <span class="kn">import</span> <span class="n">Carto</span>
 </span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="kn">from</span> <span class="nn">maplibre.sources</span> <span class="kn">import</span> <span class="n">GeoJSONSource</span>
@@ -983,7 +983,7 @@ <h1>Earthquake clusters</h1>
 </span><span id="__span-0-89"><a id="__codelineno-0-89" name="__codelineno-0-89" href="#__codelineno-0-89"></a>
 </span><span id="__span-0-90"><a id="__codelineno-0-90" name="__codelineno-0-90" href="#__codelineno-0-90"></a>
 </span><span id="__span-0-91"><a id="__codelineno-0-91" name="__codelineno-0-91" href="#__codelineno-0-91"></a><span class="k">def</span> <span class="nf">server</span><span class="p">(</span><span class="nb">input</span><span class="p">,</span> <span class="n">output</span><span class="p">,</span> <span class="n">session</span><span class="p">):</span>
-</span><span id="__span-0-92"><a id="__codelineno-0-92" name="__codelineno-0-92" href="#__codelineno-0-92"></a>    <span class="nd">@MapLibreRenderer</span>
+</span><span id="__span-0-92"><a id="__codelineno-0-92" name="__codelineno-0-92" href="#__codelineno-0-92"></a>    <span class="nd">@render_maplibregl</span>
 </span><span id="__span-0-93"><a id="__codelineno-0-93" name="__codelineno-0-93" href="#__codelineno-0-93"></a>    <span class="k">def</span> <span class="nf">maplibre</span><span class="p">():</span>
 </span><span id="__span-0-94"><a id="__codelineno-0-94" name="__codelineno-0-94" href="#__codelineno-0-94"></a>        <span class="k">return</span> <span class="n">create_map</span><span class="p">()</span>
 </span><span id="__span-0-95"><a id="__codelineno-0-95" name="__codelineno-0-95" href="#__codelineno-0-95"></a>
diff --git a/examples/every_person_in_manhattan/__pycache__/app.cpython-39.pyc b/examples/every_person_in_manhattan/__pycache__/app.cpython-39.pyc
index ef1167919af5ba29118d77a2073d1138ee8e451d..a13094f0fd30c637cb295b4e2bed45ade5dbec8b 100644
GIT binary patch
delta 830
zcmZuvOHWfl6u#&7w!M8)S{^NwwoqEA2rX2^SBQq7Au*PKicVr0;2f~E51iYAxFM!2
zZG_x~E{JJa>Dq<<0C&1@ed7->Ze6)^Zb?i`oXPp-J7>=M&SYlZ_WtPcu6sOANsQ&w
z+}20+*c*m##}h9O%Kfar9ArU|P-P)>umN<kL3FV&Sz1HrZUc*KOXxWTisYl@ryh!+
zcN?&)DWk6mEJjLeSl9?jtvJPsqirxJOOTE1#Uu?<47<@UYGe#hhz7Q;6vmzt8GD-w
zI~XG;d5hzeqC^9*5Bm#%!KQ_sBNam@fCD&qsIUnNw$2Ni#BdwPg+my@Xj7(OaSCHN
zECd5Mg7K!cZDDB~#l)e+GSo+D$~0s)O*5E$A|C<&N?C&91<}dX@ju@;T?~XIHcJ<2
z7RMU$s~DT3xz;6`Xh^NgZK(|)tw{)qq(}`5NEQFIbOhR`j0BzeP+&!+>DHCDU<j*H
zYFu~A`}!OC7j%DkX?X+?*MBO{12f|KHPw6sP{9XI;0b-t`aO~m5gz{+Mol*<;D-Lx
z_ReN9-ls?HsgZG$4hwh>hP6=Hsn^bGI~C^UqF%I*9hiN%R{*muZf((K&9KrgRchQ!
zNm+SXEQYOGuL%Leu92n{s+CU1PR5z$lqq5g8#ayjF7fMvYn^`tGB_;?c!6ileKnsi
zuNNx$ya9WutA?Wc)F>qNjJh`OE3faA3LBiJv}&DilEz)4f_eXj>$O5j<8Cu()gBir
z``jaV=kUBsH`EAB>c7={Fr?=kp|s!3Q#LlL&zNmtX=UN|B9ECNbvd`Xbay3p$FSDw
wJ0;>#QzW6kc4Q%|e{tNJ`Og&_>a}te>m`~8k*%Qs6;xRmjLL4%Z#p0R0W+S&qyPW_

delta 880
zcmZuvOHWfl6rOW?+uoM8R49)=D5aK`ioEfSZiq385d#`<64Fr40bBbZb6XTQ#MEu$
z<1X9~)4DLacHtk;l^d7l#vkBT7p|QtF~r0>Ip3W7&3C?e{s_J93vBxRUM9a^8z0Hx
zc@c=g_ZQ<&4uBy;qcl(+<b&lf50@i6A~_F_qL;_8iw~iX$H~zeMt>W4VuxYi4NxLC
zLLus>1a|KL2Adk5XaY}?-a08GMXWVS$zr+<s__iD$Xy(xAxdHo_R1O!LlmXh&ViHS
z*mtO5e^cjK@=~C9ipD9^035)<0${l5;HSyJ$RS`9V^4KHL6O#^j42#y19f2>hcVIA
zC{mop5ll+I5T3+T)7f_L863s*Q^sd$kY;GMq47DI$IJumIf!p`h9F-&E2r{xh_3|2
zvlt39evZ!5IUH+f&l3CsU1(jTi3V$3YO^)~TVn`1(^<m-tkN^Xo`d;mnn9=ClUOlm
zuC>sX8Nw>dW?yRi!EQknB#|p`?v@I9LDru38+tyJ9UA~C>x=%lcR^l_X{ZYV1A^cM
zk+#;I-{Wb?h}6F@s(v#PmaG-mJD1ADz)N>FnN?X*!h5ith01Qdc2wFaP=m|Xk~?$I
zrDWX_xa;cnHf_~xC+$(CCX^)W6w|V^UDbL`8rW`=OtVm}bSCU5jy$K7i88ibCW$=~
zH)L*ho)~E0b?6WPF|WproZNSzlFQlfFnih7t)K2;$XF+gwbj7i1DQ1M7b^Qgt&9hc
z$!c9}ktuwNKGxQ2g_0@!igX^;1!UgYkqBCEjW|qNpN+c^x1yf#RIk$M`F!;ecP(CD
zS-g2wj3~;uy}Ww;&dTyF+gYpcmPjO&N!r@-%)z|%%5!c0KgVtx3*{=-OLPUK+T504
RfT78Nl*b1?hZXd${{d}{)71a~

diff --git a/examples/every_person_in_manhattan/app.py b/examples/every_person_in_manhattan/app.py
index 721847b0..89ea6278 100644
--- a/examples/every_person_in_manhattan/app.py
+++ b/examples/every_person_in_manhattan/app.py
@@ -14,9 +14,6 @@
 )
 from maplibre.basemaps import Carto
 from maplibre.controls import ScaleControl
-
-# New since Shiny v0.7.0
-from maplibre.shiny import MapLibreRenderer
 from maplibre.sources import GeoJSONSource
 from maplibre.utils import df_to_geojson
 from shiny import App, reactive, ui
@@ -72,7 +69,7 @@ def create_map() -> Map:
 
 
 def server(input, output, session):
-    @MapLibreRenderer
+    @render_maplibregl
     def maplibre():
         return create_map()
 
diff --git a/examples/every_person_in_manhattan/index.html b/examples/every_person_in_manhattan/index.html
index 281a9e4b..ad5bcc92 100644
--- a/examples/every_person_in_manhattan/index.html
+++ b/examples/every_person_in_manhattan/index.html
@@ -908,84 +908,81 @@ <h1>Every person in manhattan</h1>
 </span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="p">)</span>
 </span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="kn">from</span> <span class="nn">maplibre.basemaps</span> <span class="kn">import</span> <span class="n">Carto</span>
 </span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a><span class="kn">from</span> <span class="nn">maplibre.controls</span> <span class="kn">import</span> <span class="n">ScaleControl</span>
-</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a>
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a><span class="c1"># New since Shiny v0.7.0</span>
-</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a><span class="kn">from</span> <span class="nn">maplibre.shiny</span> <span class="kn">import</span> <span class="n">MapLibreRenderer</span>
-</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a><span class="kn">from</span> <span class="nn">maplibre.sources</span> <span class="kn">import</span> <span class="n">GeoJSONSource</span>
-</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a><span class="kn">from</span> <span class="nn">maplibre.utils</span> <span class="kn">import</span> <span class="n">df_to_geojson</span>
-</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a><span class="kn">from</span> <span class="nn">shiny</span> <span class="kn">import</span> <span class="n">App</span><span class="p">,</span> <span class="n">reactive</span><span class="p">,</span> <span class="n">ui</span>
-</span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a>
-</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a><span class="n">MALE_COLOR</span> <span class="o">=</span> <span class="s2">&quot;rgb(0, 128, 255)&quot;</span>
-</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a><span class="n">FEMALE_COLOR</span> <span class="o">=</span> <span class="s2">&quot;rgb(255, 0, 128)&quot;</span>
-</span><span id="__span-0-26"><a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a><span class="n">LAYER_ID</span> <span class="o">=</span> <span class="s2">&quot;every-person-in-manhattan-circles&quot;</span>
-</span><span id="__span-0-27"><a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a><span class="n">CIRCLE_RADIUS</span> <span class="o">=</span> <span class="mi">2</span>
-</span><span id="__span-0-28"><a id="__codelineno-0-28" name="__codelineno-0-28" href="#__codelineno-0-28"></a>
-</span><span id="__span-0-29"><a id="__codelineno-0-29" name="__codelineno-0-29" href="#__codelineno-0-29"></a><span class="n">point_data</span> <span class="o">=</span> <span class="n">pd</span><span class="o">.</span><span class="n">read_json</span><span class="p">(</span>
-</span><span id="__span-0-30"><a id="__codelineno-0-30" name="__codelineno-0-30" href="#__codelineno-0-30"></a>    <span class="s2">&quot;https://raw.githubusercontent.com/visgl/deck.gl-data/master/examples/scatterplot/manhattan.json&quot;</span>
-</span><span id="__span-0-31"><a id="__codelineno-0-31" name="__codelineno-0-31" href="#__codelineno-0-31"></a><span class="p">)</span>
-</span><span id="__span-0-32"><a id="__codelineno-0-32" name="__codelineno-0-32" href="#__codelineno-0-32"></a>
-</span><span id="__span-0-33"><a id="__codelineno-0-33" name="__codelineno-0-33" href="#__codelineno-0-33"></a><span class="n">point_data</span><span class="o">.</span><span class="n">columns</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&quot;lng&quot;</span><span class="p">,</span> <span class="s2">&quot;lat&quot;</span><span class="p">,</span> <span class="s2">&quot;sex&quot;</span><span class="p">]</span>
-</span><span id="__span-0-34"><a id="__codelineno-0-34" name="__codelineno-0-34" href="#__codelineno-0-34"></a>
-</span><span id="__span-0-35"><a id="__codelineno-0-35" name="__codelineno-0-35" href="#__codelineno-0-35"></a><span class="n">every_person_in_manhattan_source</span> <span class="o">=</span> <span class="n">GeoJSONSource</span><span class="p">(</span>
-</span><span id="__span-0-36"><a id="__codelineno-0-36" name="__codelineno-0-36" href="#__codelineno-0-36"></a>    <span class="n">data</span><span class="o">=</span><span class="n">df_to_geojson</span><span class="p">(</span><span class="n">point_data</span><span class="p">,</span> <span class="n">properties</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;sex&quot;</span><span class="p">]),</span>
-</span><span id="__span-0-37"><a id="__codelineno-0-37" name="__codelineno-0-37" href="#__codelineno-0-37"></a><span class="p">)</span>
-</span><span id="__span-0-38"><a id="__codelineno-0-38" name="__codelineno-0-38" href="#__codelineno-0-38"></a>
-</span><span id="__span-0-39"><a id="__codelineno-0-39" name="__codelineno-0-39" href="#__codelineno-0-39"></a><span class="n">bbox</span> <span class="o">=</span> <span class="n">shapely</span><span class="o">.</span><span class="n">bounds</span><span class="p">(</span>
-</span><span id="__span-0-40"><a id="__codelineno-0-40" name="__codelineno-0-40" href="#__codelineno-0-40"></a>    <span class="n">shapely</span><span class="o">.</span><span class="n">from_geojson</span><span class="p">(</span><span class="n">json</span><span class="o">.</span><span class="n">dumps</span><span class="p">(</span><span class="n">every_person_in_manhattan_source</span><span class="o">.</span><span class="n">data</span><span class="p">))</span>
-</span><span id="__span-0-41"><a id="__codelineno-0-41" name="__codelineno-0-41" href="#__codelineno-0-41"></a><span class="p">)</span>
-</span><span id="__span-0-42"><a id="__codelineno-0-42" name="__codelineno-0-42" href="#__codelineno-0-42"></a>
-</span><span id="__span-0-43"><a id="__codelineno-0-43" name="__codelineno-0-43" href="#__codelineno-0-43"></a><span class="n">every_person_in_manhattan_circles</span> <span class="o">=</span> <span class="n">Layer</span><span class="p">(</span>
-</span><span id="__span-0-44"><a id="__codelineno-0-44" name="__codelineno-0-44" href="#__codelineno-0-44"></a>    <span class="nb">type</span><span class="o">=</span><span class="n">LayerType</span><span class="o">.</span><span class="n">CIRCLE</span><span class="p">,</span>
-</span><span id="__span-0-45"><a id="__codelineno-0-45" name="__codelineno-0-45" href="#__codelineno-0-45"></a>    <span class="nb">id</span><span class="o">=</span><span class="n">LAYER_ID</span><span class="p">,</span>
-</span><span id="__span-0-46"><a id="__codelineno-0-46" name="__codelineno-0-46" href="#__codelineno-0-46"></a>    <span class="n">source</span><span class="o">=</span><span class="n">every_person_in_manhattan_source</span><span class="p">,</span>
-</span><span id="__span-0-47"><a id="__codelineno-0-47" name="__codelineno-0-47" href="#__codelineno-0-47"></a>    <span class="n">paint</span><span class="o">=</span><span class="p">{</span>
-</span><span id="__span-0-48"><a id="__codelineno-0-48" name="__codelineno-0-48" href="#__codelineno-0-48"></a>        <span class="s2">&quot;circle-color&quot;</span><span class="p">:</span> <span class="p">[</span><span class="s2">&quot;match&quot;</span><span class="p">,</span> <span class="p">[</span><span class="s2">&quot;get&quot;</span><span class="p">,</span> <span class="s2">&quot;sex&quot;</span><span class="p">],</span> <span class="mi">1</span><span class="p">,</span> <span class="n">MALE_COLOR</span><span class="p">,</span> <span class="n">FEMALE_COLOR</span><span class="p">],</span>
-</span><span id="__span-0-49"><a id="__codelineno-0-49" name="__codelineno-0-49" href="#__codelineno-0-49"></a>        <span class="s2">&quot;circle-radius&quot;</span><span class="p">:</span> <span class="n">CIRCLE_RADIUS</span><span class="p">,</span>
-</span><span id="__span-0-50"><a id="__codelineno-0-50" name="__codelineno-0-50" href="#__codelineno-0-50"></a>    <span class="p">},</span>
-</span><span id="__span-0-51"><a id="__codelineno-0-51" name="__codelineno-0-51" href="#__codelineno-0-51"></a><span class="p">)</span>
-</span><span id="__span-0-52"><a id="__codelineno-0-52" name="__codelineno-0-52" href="#__codelineno-0-52"></a>
-</span><span id="__span-0-53"><a id="__codelineno-0-53" name="__codelineno-0-53" href="#__codelineno-0-53"></a><span class="n">map_options</span> <span class="o">=</span> <span class="n">MapOptions</span><span class="p">(</span>
-</span><span id="__span-0-54"><a id="__codelineno-0-54" name="__codelineno-0-54" href="#__codelineno-0-54"></a>    <span class="n">style</span><span class="o">=</span><span class="n">Carto</span><span class="o">.</span><span class="n">POSITRON</span><span class="p">,</span>
-</span><span id="__span-0-55"><a id="__codelineno-0-55" name="__codelineno-0-55" href="#__codelineno-0-55"></a>    <span class="n">bounds</span><span class="o">=</span><span class="nb">tuple</span><span class="p">(</span><span class="n">bbox</span><span class="p">),</span>
-</span><span id="__span-0-56"><a id="__codelineno-0-56" name="__codelineno-0-56" href="#__codelineno-0-56"></a>    <span class="n">fit_bounds_options</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;padding&quot;</span><span class="p">:</span> <span class="mi">20</span><span class="p">},</span>
-</span><span id="__span-0-57"><a id="__codelineno-0-57" name="__codelineno-0-57" href="#__codelineno-0-57"></a><span class="p">)</span>
-</span><span id="__span-0-58"><a id="__codelineno-0-58" name="__codelineno-0-58" href="#__codelineno-0-58"></a>
-</span><span id="__span-0-59"><a id="__codelineno-0-59" name="__codelineno-0-59" href="#__codelineno-0-59"></a>
-</span><span id="__span-0-60"><a id="__codelineno-0-60" name="__codelineno-0-60" href="#__codelineno-0-60"></a><span class="k">def</span> <span class="nf">create_map</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Map</span><span class="p">:</span>
-</span><span id="__span-0-61"><a id="__codelineno-0-61" name="__codelineno-0-61" href="#__codelineno-0-61"></a>    <span class="n">m</span> <span class="o">=</span> <span class="n">Map</span><span class="p">(</span><span class="n">map_options</span><span class="p">)</span>
-</span><span id="__span-0-62"><a id="__codelineno-0-62" name="__codelineno-0-62" href="#__codelineno-0-62"></a>    <span class="n">m</span><span class="o">.</span><span class="n">add_control</span><span class="p">(</span><span class="n">ScaleControl</span><span class="p">(),</span> <span class="n">position</span><span class="o">=</span><span class="s2">&quot;bottom-left&quot;</span><span class="p">)</span>
-</span><span id="__span-0-63"><a id="__codelineno-0-63" name="__codelineno-0-63" href="#__codelineno-0-63"></a>    <span class="n">m</span><span class="o">.</span><span class="n">add_layer</span><span class="p">(</span><span class="n">every_person_in_manhattan_circles</span><span class="p">)</span>
-</span><span id="__span-0-64"><a id="__codelineno-0-64" name="__codelineno-0-64" href="#__codelineno-0-64"></a>    <span class="k">return</span> <span class="n">m</span>
-</span><span id="__span-0-65"><a id="__codelineno-0-65" name="__codelineno-0-65" href="#__codelineno-0-65"></a>
-</span><span id="__span-0-66"><a id="__codelineno-0-66" name="__codelineno-0-66" href="#__codelineno-0-66"></a>
-</span><span id="__span-0-67"><a id="__codelineno-0-67" name="__codelineno-0-67" href="#__codelineno-0-67"></a><span class="n">app_ui</span> <span class="o">=</span> <span class="n">ui</span><span class="o">.</span><span class="n">page_fluid</span><span class="p">(</span>
-</span><span id="__span-0-68"><a id="__codelineno-0-68" name="__codelineno-0-68" href="#__codelineno-0-68"></a>    <span class="n">ui</span><span class="o">.</span><span class="n">panel_title</span><span class="p">(</span><span class="s2">&quot;Every Person in Manhattan&quot;</span><span class="p">),</span>
-</span><span id="__span-0-69"><a id="__codelineno-0-69" name="__codelineno-0-69" href="#__codelineno-0-69"></a>    <span class="n">output_maplibregl</span><span class="p">(</span><span class="s2">&quot;maplibre&quot;</span><span class="p">,</span> <span class="n">height</span><span class="o">=</span><span class="mi">600</span><span class="p">),</span>
-</span><span id="__span-0-70"><a id="__codelineno-0-70" name="__codelineno-0-70" href="#__codelineno-0-70"></a>    <span class="n">ui</span><span class="o">.</span><span class="n">input_slider</span><span class="p">(</span><span class="s2">&quot;radius&quot;</span><span class="p">,</span> <span class="s2">&quot;Radius&quot;</span><span class="p">,</span> <span class="n">value</span><span class="o">=</span><span class="n">CIRCLE_RADIUS</span><span class="p">,</span> <span class="nb">min</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="nb">max</span><span class="o">=</span><span class="mi">5</span><span class="p">),</span>
-</span><span id="__span-0-71"><a id="__codelineno-0-71" name="__codelineno-0-71" href="#__codelineno-0-71"></a><span class="p">)</span>
-</span><span id="__span-0-72"><a id="__codelineno-0-72" name="__codelineno-0-72" href="#__codelineno-0-72"></a>
-</span><span id="__span-0-73"><a id="__codelineno-0-73" name="__codelineno-0-73" href="#__codelineno-0-73"></a>
-</span><span id="__span-0-74"><a id="__codelineno-0-74" name="__codelineno-0-74" href="#__codelineno-0-74"></a><span class="k">def</span> <span class="nf">server</span><span class="p">(</span><span class="nb">input</span><span class="p">,</span> <span class="n">output</span><span class="p">,</span> <span class="n">session</span><span class="p">):</span>
-</span><span id="__span-0-75"><a id="__codelineno-0-75" name="__codelineno-0-75" href="#__codelineno-0-75"></a>    <span class="nd">@MapLibreRenderer</span>
-</span><span id="__span-0-76"><a id="__codelineno-0-76" name="__codelineno-0-76" href="#__codelineno-0-76"></a>    <span class="k">def</span> <span class="nf">maplibre</span><span class="p">():</span>
-</span><span id="__span-0-77"><a id="__codelineno-0-77" name="__codelineno-0-77" href="#__codelineno-0-77"></a>        <span class="k">return</span> <span class="n">create_map</span><span class="p">()</span>
-</span><span id="__span-0-78"><a id="__codelineno-0-78" name="__codelineno-0-78" href="#__codelineno-0-78"></a>
-</span><span id="__span-0-79"><a id="__codelineno-0-79" name="__codelineno-0-79" href="#__codelineno-0-79"></a>    <span class="nd">@reactive</span><span class="o">.</span><span class="n">Effect</span>
-</span><span id="__span-0-80"><a id="__codelineno-0-80" name="__codelineno-0-80" href="#__codelineno-0-80"></a>    <span class="nd">@reactive</span><span class="o">.</span><span class="n">event</span><span class="p">(</span><span class="nb">input</span><span class="o">.</span><span class="n">radius</span><span class="p">,</span> <span class="n">ignore_init</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-</span><span id="__span-0-81"><a id="__codelineno-0-81" name="__codelineno-0-81" href="#__codelineno-0-81"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">radius</span><span class="p">():</span>
-</span><span id="__span-0-82"><a id="__codelineno-0-82" name="__codelineno-0-82" href="#__codelineno-0-82"></a>        <span class="k">async</span> <span class="k">with</span> <span class="n">MapContext</span><span class="p">(</span><span class="s2">&quot;maplibre&quot;</span><span class="p">)</span> <span class="k">as</span> <span class="n">m</span><span class="p">:</span>
-</span><span id="__span-0-83"><a id="__codelineno-0-83" name="__codelineno-0-83" href="#__codelineno-0-83"></a>            <span class="n">m</span><span class="o">.</span><span class="n">set_paint_property</span><span class="p">(</span><span class="n">LAYER_ID</span><span class="p">,</span> <span class="s2">&quot;circle-radius&quot;</span><span class="p">,</span> <span class="nb">input</span><span class="o">.</span><span class="n">radius</span><span class="p">())</span>
+</span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a><span class="kn">from</span> <span class="nn">maplibre.sources</span> <span class="kn">import</span> <span class="n">GeoJSONSource</span>
+</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a><span class="kn">from</span> <span class="nn">maplibre.utils</span> <span class="kn">import</span> <span class="n">df_to_geojson</span>
+</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a><span class="kn">from</span> <span class="nn">shiny</span> <span class="kn">import</span> <span class="n">App</span><span class="p">,</span> <span class="n">reactive</span><span class="p">,</span> <span class="n">ui</span>
+</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a>
+</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a><span class="n">MALE_COLOR</span> <span class="o">=</span> <span class="s2">&quot;rgb(0, 128, 255)&quot;</span>
+</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a><span class="n">FEMALE_COLOR</span> <span class="o">=</span> <span class="s2">&quot;rgb(255, 0, 128)&quot;</span>
+</span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a><span class="n">LAYER_ID</span> <span class="o">=</span> <span class="s2">&quot;every-person-in-manhattan-circles&quot;</span>
+</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a><span class="n">CIRCLE_RADIUS</span> <span class="o">=</span> <span class="mi">2</span>
+</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a>
+</span><span id="__span-0-26"><a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a><span class="n">point_data</span> <span class="o">=</span> <span class="n">pd</span><span class="o">.</span><span class="n">read_json</span><span class="p">(</span>
+</span><span id="__span-0-27"><a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a>    <span class="s2">&quot;https://raw.githubusercontent.com/visgl/deck.gl-data/master/examples/scatterplot/manhattan.json&quot;</span>
+</span><span id="__span-0-28"><a id="__codelineno-0-28" name="__codelineno-0-28" href="#__codelineno-0-28"></a><span class="p">)</span>
+</span><span id="__span-0-29"><a id="__codelineno-0-29" name="__codelineno-0-29" href="#__codelineno-0-29"></a>
+</span><span id="__span-0-30"><a id="__codelineno-0-30" name="__codelineno-0-30" href="#__codelineno-0-30"></a><span class="n">point_data</span><span class="o">.</span><span class="n">columns</span> <span class="o">=</span> <span class="p">[</span><span class="s2">&quot;lng&quot;</span><span class="p">,</span> <span class="s2">&quot;lat&quot;</span><span class="p">,</span> <span class="s2">&quot;sex&quot;</span><span class="p">]</span>
+</span><span id="__span-0-31"><a id="__codelineno-0-31" name="__codelineno-0-31" href="#__codelineno-0-31"></a>
+</span><span id="__span-0-32"><a id="__codelineno-0-32" name="__codelineno-0-32" href="#__codelineno-0-32"></a><span class="n">every_person_in_manhattan_source</span> <span class="o">=</span> <span class="n">GeoJSONSource</span><span class="p">(</span>
+</span><span id="__span-0-33"><a id="__codelineno-0-33" name="__codelineno-0-33" href="#__codelineno-0-33"></a>    <span class="n">data</span><span class="o">=</span><span class="n">df_to_geojson</span><span class="p">(</span><span class="n">point_data</span><span class="p">,</span> <span class="n">properties</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;sex&quot;</span><span class="p">]),</span>
+</span><span id="__span-0-34"><a id="__codelineno-0-34" name="__codelineno-0-34" href="#__codelineno-0-34"></a><span class="p">)</span>
+</span><span id="__span-0-35"><a id="__codelineno-0-35" name="__codelineno-0-35" href="#__codelineno-0-35"></a>
+</span><span id="__span-0-36"><a id="__codelineno-0-36" name="__codelineno-0-36" href="#__codelineno-0-36"></a><span class="n">bbox</span> <span class="o">=</span> <span class="n">shapely</span><span class="o">.</span><span class="n">bounds</span><span class="p">(</span>
+</span><span id="__span-0-37"><a id="__codelineno-0-37" name="__codelineno-0-37" href="#__codelineno-0-37"></a>    <span class="n">shapely</span><span class="o">.</span><span class="n">from_geojson</span><span class="p">(</span><span class="n">json</span><span class="o">.</span><span class="n">dumps</span><span class="p">(</span><span class="n">every_person_in_manhattan_source</span><span class="o">.</span><span class="n">data</span><span class="p">))</span>
+</span><span id="__span-0-38"><a id="__codelineno-0-38" name="__codelineno-0-38" href="#__codelineno-0-38"></a><span class="p">)</span>
+</span><span id="__span-0-39"><a id="__codelineno-0-39" name="__codelineno-0-39" href="#__codelineno-0-39"></a>
+</span><span id="__span-0-40"><a id="__codelineno-0-40" name="__codelineno-0-40" href="#__codelineno-0-40"></a><span class="n">every_person_in_manhattan_circles</span> <span class="o">=</span> <span class="n">Layer</span><span class="p">(</span>
+</span><span id="__span-0-41"><a id="__codelineno-0-41" name="__codelineno-0-41" href="#__codelineno-0-41"></a>    <span class="nb">type</span><span class="o">=</span><span class="n">LayerType</span><span class="o">.</span><span class="n">CIRCLE</span><span class="p">,</span>
+</span><span id="__span-0-42"><a id="__codelineno-0-42" name="__codelineno-0-42" href="#__codelineno-0-42"></a>    <span class="nb">id</span><span class="o">=</span><span class="n">LAYER_ID</span><span class="p">,</span>
+</span><span id="__span-0-43"><a id="__codelineno-0-43" name="__codelineno-0-43" href="#__codelineno-0-43"></a>    <span class="n">source</span><span class="o">=</span><span class="n">every_person_in_manhattan_source</span><span class="p">,</span>
+</span><span id="__span-0-44"><a id="__codelineno-0-44" name="__codelineno-0-44" href="#__codelineno-0-44"></a>    <span class="n">paint</span><span class="o">=</span><span class="p">{</span>
+</span><span id="__span-0-45"><a id="__codelineno-0-45" name="__codelineno-0-45" href="#__codelineno-0-45"></a>        <span class="s2">&quot;circle-color&quot;</span><span class="p">:</span> <span class="p">[</span><span class="s2">&quot;match&quot;</span><span class="p">,</span> <span class="p">[</span><span class="s2">&quot;get&quot;</span><span class="p">,</span> <span class="s2">&quot;sex&quot;</span><span class="p">],</span> <span class="mi">1</span><span class="p">,</span> <span class="n">MALE_COLOR</span><span class="p">,</span> <span class="n">FEMALE_COLOR</span><span class="p">],</span>
+</span><span id="__span-0-46"><a id="__codelineno-0-46" name="__codelineno-0-46" href="#__codelineno-0-46"></a>        <span class="s2">&quot;circle-radius&quot;</span><span class="p">:</span> <span class="n">CIRCLE_RADIUS</span><span class="p">,</span>
+</span><span id="__span-0-47"><a id="__codelineno-0-47" name="__codelineno-0-47" href="#__codelineno-0-47"></a>    <span class="p">},</span>
+</span><span id="__span-0-48"><a id="__codelineno-0-48" name="__codelineno-0-48" href="#__codelineno-0-48"></a><span class="p">)</span>
+</span><span id="__span-0-49"><a id="__codelineno-0-49" name="__codelineno-0-49" href="#__codelineno-0-49"></a>
+</span><span id="__span-0-50"><a id="__codelineno-0-50" name="__codelineno-0-50" href="#__codelineno-0-50"></a><span class="n">map_options</span> <span class="o">=</span> <span class="n">MapOptions</span><span class="p">(</span>
+</span><span id="__span-0-51"><a id="__codelineno-0-51" name="__codelineno-0-51" href="#__codelineno-0-51"></a>    <span class="n">style</span><span class="o">=</span><span class="n">Carto</span><span class="o">.</span><span class="n">POSITRON</span><span class="p">,</span>
+</span><span id="__span-0-52"><a id="__codelineno-0-52" name="__codelineno-0-52" href="#__codelineno-0-52"></a>    <span class="n">bounds</span><span class="o">=</span><span class="nb">tuple</span><span class="p">(</span><span class="n">bbox</span><span class="p">),</span>
+</span><span id="__span-0-53"><a id="__codelineno-0-53" name="__codelineno-0-53" href="#__codelineno-0-53"></a>    <span class="n">fit_bounds_options</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;padding&quot;</span><span class="p">:</span> <span class="mi">20</span><span class="p">},</span>
+</span><span id="__span-0-54"><a id="__codelineno-0-54" name="__codelineno-0-54" href="#__codelineno-0-54"></a><span class="p">)</span>
+</span><span id="__span-0-55"><a id="__codelineno-0-55" name="__codelineno-0-55" href="#__codelineno-0-55"></a>
+</span><span id="__span-0-56"><a id="__codelineno-0-56" name="__codelineno-0-56" href="#__codelineno-0-56"></a>
+</span><span id="__span-0-57"><a id="__codelineno-0-57" name="__codelineno-0-57" href="#__codelineno-0-57"></a><span class="k">def</span> <span class="nf">create_map</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Map</span><span class="p">:</span>
+</span><span id="__span-0-58"><a id="__codelineno-0-58" name="__codelineno-0-58" href="#__codelineno-0-58"></a>    <span class="n">m</span> <span class="o">=</span> <span class="n">Map</span><span class="p">(</span><span class="n">map_options</span><span class="p">)</span>
+</span><span id="__span-0-59"><a id="__codelineno-0-59" name="__codelineno-0-59" href="#__codelineno-0-59"></a>    <span class="n">m</span><span class="o">.</span><span class="n">add_control</span><span class="p">(</span><span class="n">ScaleControl</span><span class="p">(),</span> <span class="n">position</span><span class="o">=</span><span class="s2">&quot;bottom-left&quot;</span><span class="p">)</span>
+</span><span id="__span-0-60"><a id="__codelineno-0-60" name="__codelineno-0-60" href="#__codelineno-0-60"></a>    <span class="n">m</span><span class="o">.</span><span class="n">add_layer</span><span class="p">(</span><span class="n">every_person_in_manhattan_circles</span><span class="p">)</span>
+</span><span id="__span-0-61"><a id="__codelineno-0-61" name="__codelineno-0-61" href="#__codelineno-0-61"></a>    <span class="k">return</span> <span class="n">m</span>
+</span><span id="__span-0-62"><a id="__codelineno-0-62" name="__codelineno-0-62" href="#__codelineno-0-62"></a>
+</span><span id="__span-0-63"><a id="__codelineno-0-63" name="__codelineno-0-63" href="#__codelineno-0-63"></a>
+</span><span id="__span-0-64"><a id="__codelineno-0-64" name="__codelineno-0-64" href="#__codelineno-0-64"></a><span class="n">app_ui</span> <span class="o">=</span> <span class="n">ui</span><span class="o">.</span><span class="n">page_fluid</span><span class="p">(</span>
+</span><span id="__span-0-65"><a id="__codelineno-0-65" name="__codelineno-0-65" href="#__codelineno-0-65"></a>    <span class="n">ui</span><span class="o">.</span><span class="n">panel_title</span><span class="p">(</span><span class="s2">&quot;Every Person in Manhattan&quot;</span><span class="p">),</span>
+</span><span id="__span-0-66"><a id="__codelineno-0-66" name="__codelineno-0-66" href="#__codelineno-0-66"></a>    <span class="n">output_maplibregl</span><span class="p">(</span><span class="s2">&quot;maplibre&quot;</span><span class="p">,</span> <span class="n">height</span><span class="o">=</span><span class="mi">600</span><span class="p">),</span>
+</span><span id="__span-0-67"><a id="__codelineno-0-67" name="__codelineno-0-67" href="#__codelineno-0-67"></a>    <span class="n">ui</span><span class="o">.</span><span class="n">input_slider</span><span class="p">(</span><span class="s2">&quot;radius&quot;</span><span class="p">,</span> <span class="s2">&quot;Radius&quot;</span><span class="p">,</span> <span class="n">value</span><span class="o">=</span><span class="n">CIRCLE_RADIUS</span><span class="p">,</span> <span class="nb">min</span><span class="o">=</span><span class="mi">1</span><span class="p">,</span> <span class="nb">max</span><span class="o">=</span><span class="mi">5</span><span class="p">),</span>
+</span><span id="__span-0-68"><a id="__codelineno-0-68" name="__codelineno-0-68" href="#__codelineno-0-68"></a><span class="p">)</span>
+</span><span id="__span-0-69"><a id="__codelineno-0-69" name="__codelineno-0-69" href="#__codelineno-0-69"></a>
+</span><span id="__span-0-70"><a id="__codelineno-0-70" name="__codelineno-0-70" href="#__codelineno-0-70"></a>
+</span><span id="__span-0-71"><a id="__codelineno-0-71" name="__codelineno-0-71" href="#__codelineno-0-71"></a><span class="k">def</span> <span class="nf">server</span><span class="p">(</span><span class="nb">input</span><span class="p">,</span> <span class="n">output</span><span class="p">,</span> <span class="n">session</span><span class="p">):</span>
+</span><span id="__span-0-72"><a id="__codelineno-0-72" name="__codelineno-0-72" href="#__codelineno-0-72"></a>    <span class="nd">@render_maplibregl</span>
+</span><span id="__span-0-73"><a id="__codelineno-0-73" name="__codelineno-0-73" href="#__codelineno-0-73"></a>    <span class="k">def</span> <span class="nf">maplibre</span><span class="p">():</span>
+</span><span id="__span-0-74"><a id="__codelineno-0-74" name="__codelineno-0-74" href="#__codelineno-0-74"></a>        <span class="k">return</span> <span class="n">create_map</span><span class="p">()</span>
+</span><span id="__span-0-75"><a id="__codelineno-0-75" name="__codelineno-0-75" href="#__codelineno-0-75"></a>
+</span><span id="__span-0-76"><a id="__codelineno-0-76" name="__codelineno-0-76" href="#__codelineno-0-76"></a>    <span class="nd">@reactive</span><span class="o">.</span><span class="n">Effect</span>
+</span><span id="__span-0-77"><a id="__codelineno-0-77" name="__codelineno-0-77" href="#__codelineno-0-77"></a>    <span class="nd">@reactive</span><span class="o">.</span><span class="n">event</span><span class="p">(</span><span class="nb">input</span><span class="o">.</span><span class="n">radius</span><span class="p">,</span> <span class="n">ignore_init</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+</span><span id="__span-0-78"><a id="__codelineno-0-78" name="__codelineno-0-78" href="#__codelineno-0-78"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">radius</span><span class="p">():</span>
+</span><span id="__span-0-79"><a id="__codelineno-0-79" name="__codelineno-0-79" href="#__codelineno-0-79"></a>        <span class="k">async</span> <span class="k">with</span> <span class="n">MapContext</span><span class="p">(</span><span class="s2">&quot;maplibre&quot;</span><span class="p">)</span> <span class="k">as</span> <span class="n">m</span><span class="p">:</span>
+</span><span id="__span-0-80"><a id="__codelineno-0-80" name="__codelineno-0-80" href="#__codelineno-0-80"></a>            <span class="n">m</span><span class="o">.</span><span class="n">set_paint_property</span><span class="p">(</span><span class="n">LAYER_ID</span><span class="p">,</span> <span class="s2">&quot;circle-radius&quot;</span><span class="p">,</span> <span class="nb">input</span><span class="o">.</span><span class="n">radius</span><span class="p">())</span>
+</span><span id="__span-0-81"><a id="__codelineno-0-81" name="__codelineno-0-81" href="#__codelineno-0-81"></a>
+</span><span id="__span-0-82"><a id="__codelineno-0-82" name="__codelineno-0-82" href="#__codelineno-0-82"></a>
+</span><span id="__span-0-83"><a id="__codelineno-0-83" name="__codelineno-0-83" href="#__codelineno-0-83"></a><span class="n">app</span> <span class="o">=</span> <span class="n">App</span><span class="p">(</span><span class="n">app_ui</span><span class="p">,</span> <span class="n">server</span><span class="p">)</span>
 </span><span id="__span-0-84"><a id="__codelineno-0-84" name="__codelineno-0-84" href="#__codelineno-0-84"></a>
-</span><span id="__span-0-85"><a id="__codelineno-0-85" name="__codelineno-0-85" href="#__codelineno-0-85"></a>
-</span><span id="__span-0-86"><a id="__codelineno-0-86" name="__codelineno-0-86" href="#__codelineno-0-86"></a><span class="n">app</span> <span class="o">=</span> <span class="n">App</span><span class="p">(</span><span class="n">app_ui</span><span class="p">,</span> <span class="n">server</span><span class="p">)</span>
-</span><span id="__span-0-87"><a id="__codelineno-0-87" name="__codelineno-0-87" href="#__codelineno-0-87"></a>
-</span><span id="__span-0-88"><a id="__codelineno-0-88" name="__codelineno-0-88" href="#__codelineno-0-88"></a><span class="k">if</span> <span class="vm">__name__</span> <span class="o">==</span> <span class="s2">&quot;__main__&quot;</span><span class="p">:</span>
-</span><span id="__span-0-89"><a id="__codelineno-0-89" name="__codelineno-0-89" href="#__codelineno-0-89"></a>    <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">sys</span><span class="o">.</span><span class="n">argv</span><span class="p">)</span> <span class="o">==</span> <span class="mi">2</span><span class="p">:</span>
-</span><span id="__span-0-90"><a id="__codelineno-0-90" name="__codelineno-0-90" href="#__codelineno-0-90"></a>        <span class="n">file_name</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">argv</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span>
-</span><span id="__span-0-91"><a id="__codelineno-0-91" name="__codelineno-0-91" href="#__codelineno-0-91"></a>        <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">file_name</span><span class="p">,</span> <span class="s2">&quot;w&quot;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
-</span><span id="__span-0-92"><a id="__codelineno-0-92" name="__codelineno-0-92" href="#__codelineno-0-92"></a>            <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">create_map</span><span class="p">()</span><span class="o">.</span><span class="n">to_html</span><span class="p">())</span>
-</span><span id="__span-0-93"><a id="__codelineno-0-93" name="__codelineno-0-93" href="#__codelineno-0-93"></a>    <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-94"><a id="__codelineno-0-94" name="__codelineno-0-94" href="#__codelineno-0-94"></a>        <span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">()</span>
+</span><span id="__span-0-85"><a id="__codelineno-0-85" name="__codelineno-0-85" href="#__codelineno-0-85"></a><span class="k">if</span> <span class="vm">__name__</span> <span class="o">==</span> <span class="s2">&quot;__main__&quot;</span><span class="p">:</span>
+</span><span id="__span-0-86"><a id="__codelineno-0-86" name="__codelineno-0-86" href="#__codelineno-0-86"></a>    <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">sys</span><span class="o">.</span><span class="n">argv</span><span class="p">)</span> <span class="o">==</span> <span class="mi">2</span><span class="p">:</span>
+</span><span id="__span-0-87"><a id="__codelineno-0-87" name="__codelineno-0-87" href="#__codelineno-0-87"></a>        <span class="n">file_name</span> <span class="o">=</span> <span class="n">sys</span><span class="o">.</span><span class="n">argv</span><span class="p">[</span><span class="mi">1</span><span class="p">]</span>
+</span><span id="__span-0-88"><a id="__codelineno-0-88" name="__codelineno-0-88" href="#__codelineno-0-88"></a>        <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">file_name</span><span class="p">,</span> <span class="s2">&quot;w&quot;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+</span><span id="__span-0-89"><a id="__codelineno-0-89" name="__codelineno-0-89" href="#__codelineno-0-89"></a>            <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">create_map</span><span class="p">()</span><span class="o">.</span><span class="n">to_html</span><span class="p">())</span>
+</span><span id="__span-0-90"><a id="__codelineno-0-90" name="__codelineno-0-90" href="#__codelineno-0-90"></a>    <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-91"><a id="__codelineno-0-91" name="__codelineno-0-91" href="#__codelineno-0-91"></a>        <span class="n">app</span><span class="o">.</span><span class="n">run</span><span class="p">()</span>
 </span></code></pre></div>
 <p>Run example:</p>
 <div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>poetry<span class="w"> </span>run<span class="w"> </span>uvicorn<span class="w"> </span>docs.examples.every_person_in_manhattan.app:app<span class="w"> </span>--reload
diff --git a/search/search_index.json b/search/search_index.json
index b9933153..c4f6d2a4 100644
--- a/search/search_index.json
+++ b/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"MapLibre for Python","text":"<p>MapLibre for Python provides Python bindings for MapLibre GL JS.</p> <p>It integrates seamlessly into Shiny for Python and Jupyter.</p>"},{"location":"#installation","title":"Installation","text":"<pre><code># Stable\npip install maplibre\n\npip install \"maplibre[all]\"\n\n# Dev\npip install git+https://github.com/eodaGmbH/py-maplibregl@dev\n</code></pre>"},{"location":"#basic-usage","title":"Basic usage","text":""},{"location":"#standalone","title":"Standalone","text":"<pre><code>import webbrowser\n\nfrom maplibre import Layer, LayerType, Map, MapOptions\nfrom maplibre.sources import GeoJSONSource\n\nvancouver_blocks = GeoJSONSource(\n    data=\"https://raw.githubusercontent.com/visgl/deck.gl-data/master/examples/geojson/vancouver-blocks.json\",\n)\n\nmap_options = MapOptions(\n    center=(-123.1256, 49.24658),\n    zoom=12,\n    hash=True,\n    pitch=35,\n)\n\nm = Map(map_options)\nm.add_layer(\n    Layer(\n        type=LayerType.LINE,\n        source=vancouver_blocks,\n        paint={\"line-color\": \"white\"},\n    )\n)\n\ntemp_file = \"/tmp/pymaplibregl.html\"\n\nwith open(temp_file, \"w\") as f:\n    f.write(m.to_html(style=\"height: 800px;\"))\n\nwebbrowser.open(temp_file)\n</code></pre>"},{"location":"#shiny-integration","title":"Shiny integration","text":"<pre><code>from maplibre import Map, MapContext, output_maplibregl, render_maplibregl\nfrom maplibre.controls import Marker\nfrom shiny import App, reactive, ui\n\napp_ui = ui.page_fluid(\n    output_maplibregl(\"maplibre\", height=600),\n    ui.div(\"Click on map to set a marker\"),\n)\n\n\ndef server(input, output, session):\n    @render_maplibregl\n    def maplibre():\n        m = Map()\n        return m\n\n    @reactive.Effect\n    @reactive.event(input.maplibre)\n    async def coords():\n        async with MapContext(\"maplibre\") as m:\n            print(input.maplibre())\n            lng_lat = tuple(input.maplibre()[\"coords\"].values())\n            marker = Marker(lng_lat=lng_lat)\n            m.add_marker(marker)\n            m.add_call(\"flyTo\", {\"center\": lng_lat})\n\n\napp = App(app_ui, server)\n\nif __name__ == \"__main__\":\n    app.run()\n</code></pre>"},{"location":"#jupyter-widget","title":"Jupyter widget","text":"<pre><code>from maplibre.ipywidget import MapWidget as Map\n\nm = Map()\nm\n</code></pre>"},{"location":"changelog/","title":"Changelog for MapLibre for Python","text":""},{"location":"changelog/#maplibre-v014","title":"maplibre v0.1.4","text":"<ul> <li><code>anywidget&gt;=0.9.0</code> (#36)</li> </ul>"},{"location":"changelog/#maplibre-v013","title":"maplibre v0.1.3","text":"<ul> <li>Display all properties in popup and tooltip if <code>prop = None</code> (#26)</li> <li>Support mustache templates for popups and tooltips (#27)</li> </ul>"},{"location":"changelog/#maplibre-v012","title":"maplibre v0.1.2","text":"<ul> <li>Add <code>Map.set_data</code></li> <li>Add <code>Map.set_visibility</code></li> <li>Do not import <code>ipywidget.MapWidget</code> in <code>__init__</code> and skip tests for <code>MapWidget</code>, because it causes a <code>core dumped</code> error, see anywidget issue</li> <li>Remove <code>requests</code> dependency</li> <li>Remove dead code</li> <li>Add more examples</li> </ul>"},{"location":"changelog/#maplibre-v011","title":"maplibre v0.1.1","text":"<ul> <li>Initial PyPI release</li> </ul>"},{"location":"jupyter/","title":"Jupyter","text":"<p>Use <code>MapWidget</code> in your Juyper Notebook:</p> <pre><code>import ipywidgets as widgets\n\nfrom maplibre import Layer, LayerType\nfrom maplibre.sources import GeoJSONSource\nfrom maplibre.controls import ScaleControl, Marker\nfrom maplibre.ipywidget import MapWidget as Map\n\n# Create a source\nearthquakes = GeoJSONSource(\n    data=\"https://docs.mapbox.com/mapbox-gl-js/assets/earthquakes.geojson\"\n)\n\n# Create a layer\nlayer_id = \"earthquakes\"\n\nearthquake_circles = Layer(\n    type=LayerType.CIRCLE,\n    id=layer_id,\n    source=earthquakes,\n    paint={\"circle-color\": \"yellow\"}\n)\n\n# Render map\nm = Map()\nm.add_control(ScaleControl(), position=\"bottom-left\")\nm.add_layer(earthquake_circles)\nm.add_tooltip(layer_id, \"mag\")\nm.add_marker(Marker(lng_lat=(100.507, 13.745)))\nm\n\n# Change radius\n_ = widgets.interact(\n    lambda radius: m.set_paint_property(layer_id, \"circle-radius\", radius),\n    radius=(1, 8, 1)\n)\n\n# Change color\n_ = widgets.interact(\n    lambda color: m.set_paint_property(layer_id, \"circle-color\", color),\n    color=[\"green\", \"yellow\", \"orange\", \"red\"]\n)\n\n# Set filter on magnitude\n_ = widgets.interact(\n    lambda mag_min: m.set_filter(layer_id, [\"&gt;=\", [\"get\", \"mag\"], mag_min]),\n    mag_min=(1, 8, 1)\n)\n\n# Observe map-on-click event\nfrom IPython.display import clear_output\n\noutput = widgets.Output()\n\n\ndef log_lng_lat(lng_lat):\n    with output:\n        clear_output()\n        print(lng_lat.new)\n\n\nm.observe(log_lng_lat, names=\"lng_lat\")\noutput\n</code></pre>"},{"location":"layers/","title":"Layers","text":"<p>The <code>paint</code> and <code>layout</code> properties for the layers depend on the type of the layer. They are passed as a <code>dict</code> corresponding to the Layer Style Spec.</p> <p>For example, to set the radius and the color for a circle layer, the <code>paint</code> property looks like this:</p> <pre><code>paint = {\n    \"circle-radius\": 5,\n    \"circle-color\": \"yellow\"\n}\n</code></pre> <p>The value for any <code>layout</code> property, <code>paint</code> property, or <code>filter</code> may also be specified as an expression. For details see Expressions.</p> <p>For example, if the source of your layer has a <code>color</code> property that contains the color of the feature, you can use the following expression:</p> <pre><code>paint = {\n    \"circle-radius\": 5,\n    \"circle-color\": [\"get\", \"color\"]\n}\n</code></pre> <p>A more complex expression where the color depends on the <code>type</code> property of the layer's source might look like this:</p> <pre><code>paint={\n        \"circle-color\": [\n            \"match\",\n            [\"get\", \"type\"],\n            # darkred if type == \"mid\"\n            \"mid\",\n            \"darkred\",\n            # darkgreen if type == \"major\"\n            \"major\",\n            \"darkgreen\",\n            # else blue\n            \"darkblue\",\n        ]\n}\n</code></pre> <p>Filter features of a source according to its <code>magnitude</code> property:</p> <pre><code># Only show features where magnitude &gt;= 5\nfilter = [\"&gt;=\", [\"get\", \"magnitude\"], 5]\n</code></pre>"},{"location":"shiny/","title":"Shiny","text":""},{"location":"shiny/#input-and-output","title":"Input and output","text":"<p>Use <code>output_maplibregl</code> in the UI and <code>render_maplibregl</code> in the server section of your Shiny for Python app:</p> <pre><code>from shiny import App, ui\nfrom maplibre import output_maplibregl, render_maplibregl, Map\n\napp_ui = ui.page_fluid(\n    ui.panel_title(\"MapLibre\"),\n    output_maplibregl(\"maplibre\", height=600)\n)\n\n\ndef server(input, output, session):\n    @render_maplibregl\n    def maplibre():\n        m = Map()\n        return m\n\n\napp = App(app_ui, server)\n</code></pre>"},{"location":"shiny/#reactivity","title":"Reactivity","text":""},{"location":"shiny/#input-events","title":"Input events","text":"<p>MapLibre for Python provides the following reactive inputs:</p> <ul> <li><code>map-on-click</code> event: Sends the coordinates of the location that was clicked on. The name of the input event corresponds to the output id.     For <code>output_maplibregl(\"maplibre\")</code> you need to listen to <code>input.maplibre</code>.</li> <li><code>feature-on-click</code> event: Sends the properties of the feature that was clicked on. The name of the \u00ecnput is made up of the output id + <code>layer</code> + layer id.      For <code>output_maplibregl(\"maplibre\")</code> and a layer with <code>id=test</code> you need to listen to <code>input.maplibre_layer_test</code>.</li> </ul>"},{"location":"shiny/#map-updates","title":"Map updates","text":"<p>Use <code>MapContext</code> to update your <code>Map</code> object.</p>"},{"location":"shiny/#example","title":"Example","text":"<pre><code>from maplibre import (\n    Layer,\n    LayerType,\n    Map,\n    MapContext,\n    output_maplibregl,\n    render_maplibregl,\n)\nfrom maplibre.sources import GeoJSONSource\nfrom shiny import App, reactive, render, ui\n\nLAYER_ID = \"earthquakes\"\nCIRCLE_RADIUS = 5\n\napp_ui = ui.page_fluid(\n    #\n    # Render map\n    #\n    ui.panel_title(\"MapLibre\"),\n    output_maplibregl(\"maplibre\", height=600),\n    #\n    # Show coords\n    #\n    ui.div(\"Click on the map to print the coords.\", style=\"padding: 10px;\"),\n    ui.output_text_verbatim(\"coords\", placeholder=True),\n    #\n    # Show props of a feature\n    #\n    ui.div(\"Click on a feature to print its props.\", style=\"padding: 10px;\"),\n    ui.output_text_verbatim(\"props\", placeholder=True),\n    #\n    # Change radius\n    #\n    ui.input_slider(\"radius\", \"Radius\", value=CIRCLE_RADIUS, min=1, max=10),\n)\n\n\ndef server(input, output, session):\n    @render_maplibregl\n    def maplibre():\n        m = Map(zoom=3)\n        m.add_layer(\n            Layer(\n                type=LayerType.CIRCLE,\n                id=LAYER_ID,\n                source=GeoJSONSource(\n                    data=\"https://docs.mapbox.com/mapbox-gl-js/assets/earthquakes.geojson\"\n                ),\n                paint={\"circle-color\": \"yellow\"},\n            )\n        )\n        return m\n\n    @render.text\n    def coords():\n        return str(input.maplibre())\n\n    @render.text\n    def props():\n        return str(input.maplibre_layer_earthquakes())\n\n    @reactive.Effect\n    @reactive.event(input.radius)\n    async def radius():\n        async with MapContext(\"maplibre\") as m:\n            m.set_paint_property(LAYER_ID, \"circle-radius\", input.radius())\n\n\napp = App(app_ui, server)\n</code></pre> <p>Run this example:</p> <pre><code>poetry run uvicorn docs.examples.getting_started.reactivity:app --reload\n</code></pre>"},{"location":"api/basemaps/","title":"Basemaps","text":""},{"location":"api/basemaps/#maplibre.basemaps.Carto","title":"<code>maplibre.basemaps.Carto</code>","text":"<p>             Bases: <code>Enum</code></p> <p>Carto basemap styles</p> <p>Attributes:</p> <ul> <li> <code>DARK_MATTER</code>         \u2013          <p>dark-matter</p> </li> <li> <code>POSITRON</code>         \u2013          <p>positron</p> </li> <li> <code>VOYAGER</code>         \u2013          <p>voyager</p> </li> <li> <code>POSITRON_NOLABELS</code>         \u2013          <p>positron-nolabels</p> </li> <li> <code>DARK_MATTER_NOLABELS</code>         \u2013          <p>dark-matter-nolabels</p> </li> <li> <code>VOYAGER_NOLABELS</code>         \u2013          <p>voyager-nolabels</p> </li> </ul> <p>Examples:</p> <pre><code>&gt;&gt;&gt; from maplibre import Map, MapOptions\n&gt;&gt;&gt; from maplibre.basemaps import Carto\n</code></pre> <pre><code>&gt;&gt;&gt; map = Map(MapOptions(style=Carto.DARK_MATTER))\n</code></pre> Source code in <code>maplibre/basemaps.py</code> <pre><code>class Carto(Enum):\n    \"\"\"Carto basemap styles\n\n    Attributes:\n        DARK_MATTER: dark-matter\n        POSITRON: positron\n        VOYAGER: voyager\n        POSITRON_NOLABELS: positron-nolabels\n        DARK_MATTER_NOLABELS: dark-matter-nolabels\n        VOYAGER_NOLABELS: voyager-nolabels\n\n    Examples:\n        &gt;&gt;&gt; from maplibre import Map, MapOptions\n        &gt;&gt;&gt; from maplibre.basemaps import Carto\n\n        &gt;&gt;&gt; map = Map(MapOptions(style=Carto.DARK_MATTER))\n    \"\"\"\n\n    DARK_MATTER = \"dark-matter\"\n    POSITRON = \"positron\"\n    VOYAGER = \"voyager\"\n    POSITRON_NOLABELS = \"positron-nolabels\"\n    DARK_MATTER_NOLABELS = \"dark-matter-nolabels\"\n    VOYAGER_NOLABELS = \"voyager-nolabels\"\n</code></pre>"},{"location":"api/basemaps/#maplibre.basemaps.construct_basemap_style","title":"<code>maplibre.basemaps.construct_basemap_style(name='nice-style', sources={}, layers=[])</code>","text":"<p>Construct a basemap style</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>The name of the basemap style.</p> <code>'nice-style'</code> <code>sources</code> <code>dict</code> <p>The sources to be used for the basemap style.</p> <code>{}</code> <code>layers</code> <code>list</code> <p>The layers to be used for the basemap style.</p> <code>[]</code> Source code in <code>maplibre/basemaps.py</code> <pre><code>def construct_basemap_style(\n    name: str = \"nice-style\", sources: dict = {}, layers: list = []\n) -&gt; dict:\n    \"\"\"Construct a basemap style\n\n    Args:\n        name (str): The name of the basemap style.\n        sources (dict): The sources to be used for the basemap style.\n        layers (list): The layers to be used for the basemap style.\n    \"\"\"\n    layers = [\n        layer.to_dict() if isinstance(layer, Layer) else layer for layer in layers\n    ]\n    return {\"name\": name, \"version\": 8, \"sources\": sources, \"layers\": layers}\n</code></pre>"},{"location":"api/controls/","title":"Markers and controls","text":""},{"location":"api/controls/#maplibre.controls.Popup","title":"<code>maplibre.controls.Popup</code>","text":"<p>             Bases: <code>BaseModel</code></p> <p>Popup</p> <p>Attributes:</p> Name Type Description <code>text</code> <code>str</code> <p>The Text of the popup.</p> <code>options</code> <code>PopupOptions | dict</code> <p>Popup options.</p> Source code in <code>maplibre/controls.py</code> <pre><code>class Popup(BaseModel):\n    \"\"\"Popup\n\n    Attributes:\n        text: The Text of the popup.\n        options (PopupOptions | dict): Popup options.\n    \"\"\"\n\n    text: str\n    options: Union[PopupOptions, dict] = {}\n</code></pre>"},{"location":"api/controls/#maplibre.controls.PopupOptions","title":"<code>maplibre.controls.PopupOptions</code>","text":"<p>             Bases: <code>BaseModel</code></p> <p>Popup options</p> Source code in <code>maplibre/controls.py</code> <pre><code>class PopupOptions(BaseModel):\n    \"\"\"Popup options\"\"\"\n\n    anchor: str = None\n    close_button: bool = Field(False, serialization_alias=\"closeButton\")\n    close_on_click: bool = Field(None, serialization_alias=\"closeOnClick\")\n    close_on_move: bool = Field(None, serialization_alias=\"closeOnMove\")\n    max_width: int = Field(None, serialization_alias=\"maxWidth\")\n    offset: Union[int, list, dict] = None\n</code></pre>"},{"location":"api/controls/#maplibre.controls.Marker","title":"<code>maplibre.controls.Marker</code>","text":"<p>             Bases: <code>BaseModel</code></p> <p>Marker</p> <p>Attributes:</p> Name Type Description <code>lng_lat</code> <code>tuple | list</code> <p>Required. The longitude and latitude of the marker.</p> <code>popup</code> <code>Popup | dict</code> <p>The Popup that is displayed when a user clicks on the marker.</p> <code>options</code> <code>MarkerOptions | dict</code> <p>Marker options.</p> Source code in <code>maplibre/controls.py</code> <pre><code>class Marker(BaseModel):\n    \"\"\"Marker\n\n    Attributes:\n        lng_lat (tuple |list): **Required.** The longitude and latitude of the marker.\n        popup (Popup | dict): The Popup that is displayed when a user clicks on the marker.\n        options (MarkerOptions | dict): Marker options.\n    \"\"\"\n\n    lng_lat: Union[tuple, list] = Field(None, serialization_alias=\"lngLat\")\n    popup: Union[Popup, dict] = None\n    options: Union[MarkerOptions, dict] = {}\n</code></pre>"},{"location":"api/controls/#maplibre.controls.MarkerOptions","title":"<code>maplibre.controls.MarkerOptions</code>","text":"<p>             Bases: <code>BaseModel</code></p> <p>Marker options</p> Source code in <code>maplibre/controls.py</code> <pre><code>class MarkerOptions(BaseModel):\n    \"\"\"Marker options\"\"\"\n\n    anchor: str = None\n    color: str = None\n    draggable: bool = None\n    offset: Union[tuple, list] = None\n    pitch_alignment: str = Field(None, serialization_alias=\"pitchAlignment\")\n    rotation: int = None\n    rotation_alignment: str = Field(None, serialization_alias=\"rotationAlignment\")\n    scale: int = None\n</code></pre>"},{"location":"api/controls/#maplibre.controls.ControlPosition","title":"<code>maplibre.controls.ControlPosition</code>","text":"<p>             Bases: <code>Enum</code></p> <p>Control position</p> <p>Attributes:</p> <ul> <li> <code>TOP_LEFT</code>         \u2013          <p>top-left</p> </li> <li> <code>TOP_RIGHT</code>         \u2013          <p>top-right</p> </li> <li> <code>BOTTOM_LEFT</code>         \u2013          <p>bottom-left</p> </li> <li> <code>BOTTOM_RIGHT</code>         \u2013          <p>bottom-right</p> </li> </ul> Source code in <code>maplibre/controls.py</code> <pre><code>class ControlPosition(Enum):\n    \"\"\"Control position\n\n    Attributes:\n        TOP_LEFT: top-left\n        TOP_RIGHT: top-right\n        BOTTOM_LEFT: bottom-left\n        BOTTOM_RIGHT: bottom-right\n    \"\"\"\n\n    TOP_LEFT = \"top-left\"\n    TOP_RIGHT = \"top-right\"\n    BOTTOM_LEFT = \"bottom-left\"\n    BOTTOM_RIGHT = \"bottom-right\"\n</code></pre>"},{"location":"api/controls/#maplibre.controls.FullscreenControl","title":"<code>maplibre.controls.FullscreenControl</code>","text":"<p>             Bases: <code>Control</code></p> <p>Fullscreen control</p> <p>Examples:</p> <pre><code>&gt;&gt;&gt; from maplibre import Map\n&gt;&gt;&gt; from maplibre.controls import FullscreenControl, ControlPosition\n</code></pre> <pre><code>&gt;&gt;&gt; map = Map()\n&gt;&gt;&gt; map.add_control(FullscreenControl(), ControlPosition.BOTTOM_LEFT)\n</code></pre> Source code in <code>maplibre/controls.py</code> <pre><code>class FullscreenControl(Control):\n    \"\"\"Fullscreen control\n\n    Examples:\n        &gt;&gt;&gt; from maplibre import Map\n        &gt;&gt;&gt; from maplibre.controls import FullscreenControl, ControlPosition\n\n        &gt;&gt;&gt; map = Map()\n        &gt;&gt;&gt; map.add_control(FullscreenControl(), ControlPosition.BOTTOM_LEFT)\n    \"\"\"\n\n    # _name: str = ControlType.FULLSCREEN.value\n    pass\n</code></pre>"},{"location":"api/controls/#maplibre.controls.ScaleControl","title":"<code>maplibre.controls.ScaleControl</code>","text":"<p>             Bases: <code>Control</code></p> <p>Scale control</p> Source code in <code>maplibre/controls.py</code> <pre><code>class ScaleControl(Control):\n    \"\"\"Scale control\"\"\"\n\n    # _name: str = ControlType.SCALE.value\n    max_width: int = Field(None, serialization_alias=\"maxWidth\")\n    unit: Literal[\"imperial\", \"metric\", \"nautical\"] = \"metric\"\n</code></pre>"},{"location":"api/controls/#maplibre.controls.NavigationControl","title":"<code>maplibre.controls.NavigationControl</code>","text":"<p>             Bases: <code>Control</code></p> <p>Navigation control</p> Source code in <code>maplibre/controls.py</code> <pre><code>class NavigationControl(Control):\n    \"\"\"Navigation control\"\"\"\n\n    # _name: str = ControlType.NAVIGATION.value\n    show_compass: bool = Field(True, serialization_alias=\"showCompass\")\n    show_zoom: bool = Field(True, serialization_alias=\"showZoom\")\n    visualize_pitch: bool = Field(False, serialization_alias=\"visualizePitch\")\n</code></pre>"},{"location":"api/controls/#maplibre.controls.GeolocateControl","title":"<code>maplibre.controls.GeolocateControl</code>","text":"<p>             Bases: <code>Control</code></p> <p>Geolocate control</p> Source code in <code>maplibre/controls.py</code> <pre><code>class GeolocateControl(Control):\n    \"\"\"Geolocate control\"\"\"\n\n    # _name: str = ControlType.GEOLOCATE.value\n    position_options: dict = Field(None, serialization_alias=\"positionOptions\")\n    show_accuracy_circle: bool = Field(True, serialization_alias=\"showAccuracyCircle\")\n    show_user_heading: bool = Field(False, serialization_alias=\"showUserHeading\")\n    show_user_location: bool = Field(True, serialization_alias=\"showUserLocation\")\n    track_user_location: bool = Field(False, serialization_alias=\"trackUserLocation\")\n</code></pre>"},{"location":"api/layer/","title":"Layer","text":""},{"location":"api/layer/#maplibre.Layer","title":"<code>maplibre.Layer</code>","text":"<p>             Bases: <code>BaseModel</code></p> <p>Layer properties</p> Notes <p>See layers for more details on the <code>paint</code> and <code>layout</code> properties of the layers.</p> <p>Attributes:</p> Name Type Description <code>id</code> <code>str</code> <p>Required. The unique ID of the layer. Defaults to <code>str(uuid4())</code>.</p> <code>type</code> <code>str | LayerType</code> <p>Required. The type of the layer.</p> <code>filter</code> <code>list</code> <p>The filter expression that is applied to the source of the layer.</p> <code>layout</code> <code>dict</code> <p>The layout properties of the layer.</p> <code>max_zoom</code> <code>int</code> <p>The maximum zoom level for the layer.</p> <code>min_zoom</code> <code>int</code> <p>The minimum zoom level for the layer.</p> <code>paint</code> <code>dict</code> <p>The paint properties of the layer.</p> <code>source</code> <code>str | Source</code> <p>The name (unique ID) of a source or a source object to be used for the layer.</p> <code>source_layer</code> <code>str</code> <p>The layer to use from a vector tile source.</p> <p>Examples:</p> <pre><code>&gt;&gt;&gt; from maplibre.layer import Layer, LayerType\n</code></pre> <pre><code>&gt;&gt;&gt; layer = Layer(id=\"test-layer\", type=LayerType.CIRCLE, source=\"test-source\")\n</code></pre> Source code in <code>maplibre/layer.py</code> <pre><code>class Layer(BaseModel):\n    \"\"\"Layer properties\n\n    Notes:\n        See [layers](https://maplibre.org/maplibre-style-spec/layers/) for more details on the\n        `paint` and `layout` properties of the layers.\n\n    Attributes:\n        id (str): **Required.** The unique ID of the layer. Defaults to `str(uuid4())`.\n        type (str | LayerType): **Required.** The type of the layer.\n        filter (list): The filter expression that is applied to the source of the layer.\n        layout (dict): The layout properties of the layer.\n        max_zoom (int): The maximum zoom level for the layer.\n        min_zoom (int): The minimum zoom level for the layer.\n        paint (dict): The paint properties of the layer.\n        source (str | Source): The name (unique ID) of a source or a source object to be used for the layer.\n        source_layer (str): The layer to use from a vector tile source.\n\n    Examples:\n        &gt;&gt;&gt; from maplibre.layer import Layer, LayerType\n\n        &gt;&gt;&gt; layer = Layer(id=\"test-layer\", type=LayerType.CIRCLE, source=\"test-source\")\n    \"\"\"\n\n    id: str = Field(default_factory=lambda: str(uuid4()))\n    type: LayerType\n    filter: list = None\n    layout: dict = None\n    max_zoom: int = Field(None, serialization_alias=\"maxzoom\")\n    metadata: dict = None\n    min_zoom: int = Field(None, serialization_alias=\"minzoom\")\n    paint: dict = None\n    source: Union[str, Source, dict, None] = None\n    source_layer: str = Field(None, serialization_alias=\"source-layer\")\n\n    @field_validator(\"source\")\n    def validate_source(cls, v):\n        if isinstance(v, Source):\n            return v.to_dict()\n\n        return v\n\n    @field_validator(\"paint\", \"layout\")\n    def fix_paint(cls, v):\n        if isinstance(v, dict):\n            return fix_keys(v)\n\n        return v\n</code></pre>"},{"location":"api/layer/#maplibre.LayerType","title":"<code>maplibre.LayerType</code>","text":"<p>             Bases: <code>Enum</code></p> <p>Rendering type of layer</p> <p>Attributes:</p> <ul> <li> <code>CIRCLE</code>         \u2013          <p>A filled circle.</p> </li> <li> <code>FILL</code>         \u2013          <p>A filled polygon with an optional stroked border.</p> </li> <li> <code>FILL_EXTRUSION</code>         \u2013          <p>An extruded polygon.</p> </li> <li> <code>LINE</code>         \u2013          <p>A stroked line.</p> </li> <li> <code>SYMBOL</code>         \u2013          <p>An icon or a text label.</p> </li> <li> <code>RASTER</code>         \u2013          <p>Raster map textures such as satellite imagery.</p> </li> <li> <code>HEATMAP</code>         \u2013          <p>A heatmap.</p> </li> <li> <code>HILLSHADE</code>         \u2013          <p>A Client-side hillshading visualization based on DEM data.</p> </li> <li> <code>BACKGROUND</code>         \u2013          <p>A background color or pattern.</p> </li> </ul> Source code in <code>maplibre/layer.py</code> <pre><code>class LayerType(Enum):\n    \"\"\"Rendering type of layer\n\n    Attributes:\n        CIRCLE: A filled circle.\n        FILL: A filled polygon with an optional stroked border.\n        FILL_EXTRUSION: An extruded polygon.\n        LINE: A stroked line.\n        SYMBOL: An icon or a text label.\n        RASTER: Raster map textures such as satellite imagery.\n        HEATMAP: A heatmap.\n        HILLSHADE: A Client-side hillshading visualization based on DEM data.\n        BACKGROUND: A background color or pattern.\n    \"\"\"\n\n    CIRCLE = \"circle\"\n    FILL = \"fill\"\n    FILL_EXTRUSION = \"fill-extrusion\"\n    LINE = \"line\"\n    SYMBOL = \"symbol\"\n    RASTER = \"raster\"\n    HEATMAP = \"heatmap\"\n    HILLSHADE = \"hillshade\"\n    BACKGROUND = \"background\"\n</code></pre>"},{"location":"api/map/","title":"Map","text":""},{"location":"api/map/#maplibre.Map","title":"<code>maplibre.Map</code>","text":"<p>             Bases: <code>object</code></p> <p>Map</p> <p>Parameters:</p> Name Type Description Default <code>map_options</code> <code>MapOptions</code> <p>Map options.</p> <code>MapOptions()</code> <code>**kwargs</code> <p>Keyword arguments that are appended to the <code>MapOptions</code> object.</p> <code>{}</code> <p>Examples:</p> <pre><code>&gt;&gt;&gt; from maplibre.map import Map, MapOptions\n</code></pre> <pre><code>&gt;&gt;&gt; map_options = MapOptions(center=(9.5, 51.31667), zoom=8)\n&gt;&gt;&gt; map = Map(map_options)\n&gt;&gt;&gt; dict(map)\n{'mapOptions': {'center': (9.5, 51.31667), 'style': 'https://basemaps.cartocdn.com/gl/dark-matter-gl-style/style.json', 'zoom': 8}, 'calls': []}\n</code></pre> Source code in <code>maplibre/map.py</code> <pre><code>class Map(object):\n    \"\"\"Map\n\n    Args:\n        map_options (MapOptions): Map options.\n        **kwargs: Keyword arguments that are appended to the `MapOptions` object.\n\n    Examples:\n        &gt;&gt;&gt; from maplibre.map import Map, MapOptions\n\n        &gt;&gt;&gt; map_options = MapOptions(center=(9.5, 51.31667), zoom=8)\n        &gt;&gt;&gt; map = Map(map_options)\n        &gt;&gt;&gt; dict(map)\n        {'mapOptions': {'center': (9.5, 51.31667), 'style': 'https://basemaps.cartocdn.com/gl/dark-matter-gl-style/style.json', 'zoom': 8}, 'calls': []}\n    \"\"\"\n\n    MESSAGE = \"not implemented yet\"\n\n    def __init__(self, map_options: MapOptions = MapOptions(), **kwargs):\n        self.map_options = map_options.to_dict() | kwargs\n        self._message_queue = []\n\n    def __iter__(self):\n        for k, v in self.to_dict().items():\n            yield k, v\n\n    def to_dict(self) -&gt; dict:\n        return {\"mapOptions\": self.map_options, \"calls\": self._message_queue}\n\n    \"\"\"\n    @property\n    def sources(self) -&gt; list:\n        return [item[\"data\"] for item in self._calls if item[\"name\"] == \"addSource\"]\n\n    @property\n    def layers(self) -&gt; list:\n        return [item[\"data\"] for item in self._calls if item[\"name\"] == \"addLayer\"]\n    \"\"\"\n\n    # TODO: Rename to add_map_call\n    def add_call_(self, func_name: str, params: list) -&gt; None:\n        self._message_queue.append(\n            {\"name\": \"applyFunc\", \"data\": {\"funcName\": func_name, \"params\": params}}\n        )\n\n    def add_call(self, method_name: str, *args) -&gt; None:\n        \"\"\"Add a method call that is executed on the map instance\n\n        Args:\n            method_name (str): The name of the map method to be executed.\n            *args (any): The arguments to be passed to the map method.\n        \"\"\"\n        # TODO: Pass as dict? {\"name\": method_name, \"args\": args}\n        call = [method_name, args]\n        self._message_queue.append(call)\n\n    def add_control(\n        self,\n        control: Control,\n        position: [str | ControlPosition] = ControlPosition.TOP_RIGHT,\n    ) -&gt; None:\n        \"\"\"Add a control to the map\n\n        Args:\n            control (Control): The control to be added to the map.\n            position (str | ControlPosition): The position of the control.\n        \"\"\"\n        self.add_call(\n            \"addControl\",\n            control.type,\n            control.to_dict(),\n            ControlPosition(position).value,\n        )\n\n    def add_source(self, id: str, source: [Source | dict]) -&gt; None:\n        \"\"\"Add a source to the map\"\"\"\n        if isinstance(source, Source):\n            source = source.to_dict()\n\n        self.add_call(\"addSource\", id, source)\n\n    def add_layer(self, layer: [Layer | dict]) -&gt; None:\n        \"\"\"Add a layer to the map\n\n        Args:\n            layer (Layer | dict): The Layer to be added to the map.\n        \"\"\"\n        if isinstance(layer, Layer):\n            layer = layer.to_dict()\n\n        self.add_call(\"addLayer\", layer)\n\n    def add_marker(self, marker: Marker) -&gt; None:\n        \"\"\"Add a marker to the map\n\n        Args:\n            marker (Marker): The marker to be added to the map.\n        \"\"\"\n        self.add_call(\"addMarker\", marker.to_dict())\n\n    def add_popup(self, layer_id: str, prop: str = None, template: str = None) -&gt; None:\n        \"\"\"Add a popup to the map\n\n        Args:\n            layer_id (str): The layer to which the popup is added.\n            prop (str): The property of the source to be displayed. If `None`, all properties are displayed.\n            template (str): A mustache template. If supplied, `prop` is ignored.\n        \"\"\"\n        self.add_call(\"addPopup\", layer_id, prop, template)\n\n    def add_tooltip(\n        self, layer_id: str, prop: str = None, template: str = None\n    ) -&gt; None:\n        \"\"\"Add a tooltip to the map\n\n        Args:\n            layer_id (str): The layer to which the tooltip is added.\n            prop (str): The property of the source to be displayed. If `None`, all properties are displayed.\n            template (str): A mustache template. If supplied, `prop` is ignored.\n\n        Examples:\n            &gt;&gt;&gt; map = Map()\n            &gt;&gt;&gt; # ...\n            &gt;&gt;&gt; map.add_tooltip(\"test-layer\", template=\"Name: {{ name }}\")\n        \"\"\"\n        self.add_call(\"addTooltip\", layer_id, prop, template)\n\n    def set_filter(self, layer_id: str, filter_: list):\n        \"\"\"Update the filter of a layer\n\n        Args:\n            layer_id (str): The name of the layer to be updated.\n            filter_ (list): The filter expression that is applied to the source of the layer.\n        \"\"\"\n        self.add_call(\"setFilter\", layer_id, filter_)\n\n    def set_paint_property(self, layer_id: str, prop: str, value: any) -&gt; None:\n        \"\"\"Update the paint property of a layer\n\n        Args:\n            layer_id (str): The name of the layer to be updated.\n            prop (str): The name of the paint property to be updated.\n            value (any): The new value of the paint property.\n        \"\"\"\n        self.add_call(\"setPaintProperty\", layer_id, prop, value)\n\n    def set_layout_property(self, layer_id: str, prop: str, value: any) -&gt; None:\n        \"\"\"Update a layout property of a layer\n\n        Args:\n            layer_id (str): The name of the layer to be updated.\n            prop (str): The name of the layout property to be updated.\n            value (any): The new value of the layout property.\n        \"\"\"\n        self.add_call(\"setLayoutProperty\", layer_id, prop, value)\n\n    def set_data(self, source_id: str, data: dict) -&gt; None:\n        \"\"\"Update the data of a GeoJSON source\n\n        Args:\n            source_id (str): The name of the source to be updated.\n            data (dict): The data of the source.\n        \"\"\"\n        self.add_call(\"setSourceData\", source_id, data)\n\n    def set_visibility(self, layer_id: str, visible: bool = True) -&gt; None:\n        \"\"\"Update the visibility of a layer\n\n        Args:\n            layer_id (str): The name of the layer to be updated.\n            visible (bool): Whether the layer is visible or not.\n        \"\"\"\n        value = \"visible\" if visible else \"none\"\n        self.add_call(\"setLayoutProperty\", layer_id, \"visibility\", value)\n\n    def to_html(self, **kwargs) -&gt; str:\n        \"\"\"Render to html\n\n        Args:\n            **kwargs (Any): Additional keyword arguments that are passed to the template.\n                Currently, `style` is the only supported keyword argument.\n\n        Examples:\n            &gt;&gt;&gt; from maplibre import Map\n\n            &gt;&gt;&gt; map = Map()\n            &gt;&gt;&gt; with open(\"/tmp/map.html\", \"w\") as f:\n            ...     f.write(map.to_html(style=\"height: 800px;\") # doctest: +SKIP\n        \"\"\"\n        js_lib = read_internal_file(\"srcjs\", \"index.js\")\n        js_snippet = Template(js_template).render(data=json.dumps(self.to_dict()))\n        output = Template(html_template).render(\n            js=\"\\n\".join([js_lib, js_snippet]), **kwargs\n        )\n        return output\n</code></pre>"},{"location":"api/map/#maplibre.Map.add_call","title":"<code>add_call(method_name, *args)</code>","text":"<p>Add a method call that is executed on the map instance</p> <p>Parameters:</p> Name Type Description Default <code>method_name</code> <code>str</code> <p>The name of the map method to be executed.</p> required <code>*args</code> <code>any</code> <p>The arguments to be passed to the map method.</p> <code>()</code> Source code in <code>maplibre/map.py</code> <pre><code>def add_call(self, method_name: str, *args) -&gt; None:\n    \"\"\"Add a method call that is executed on the map instance\n\n    Args:\n        method_name (str): The name of the map method to be executed.\n        *args (any): The arguments to be passed to the map method.\n    \"\"\"\n    # TODO: Pass as dict? {\"name\": method_name, \"args\": args}\n    call = [method_name, args]\n    self._message_queue.append(call)\n</code></pre>"},{"location":"api/map/#maplibre.Map.add_control","title":"<code>add_control(control, position=ControlPosition.TOP_RIGHT)</code>","text":"<p>Add a control to the map</p> <p>Parameters:</p> Name Type Description Default <code>control</code> <code>Control</code> <p>The control to be added to the map.</p> required <code>position</code> <code>str | ControlPosition</code> <p>The position of the control.</p> <code>TOP_RIGHT</code> Source code in <code>maplibre/map.py</code> <pre><code>def add_control(\n    self,\n    control: Control,\n    position: [str | ControlPosition] = ControlPosition.TOP_RIGHT,\n) -&gt; None:\n    \"\"\"Add a control to the map\n\n    Args:\n        control (Control): The control to be added to the map.\n        position (str | ControlPosition): The position of the control.\n    \"\"\"\n    self.add_call(\n        \"addControl\",\n        control.type,\n        control.to_dict(),\n        ControlPosition(position).value,\n    )\n</code></pre>"},{"location":"api/map/#maplibre.Map.add_layer","title":"<code>add_layer(layer)</code>","text":"<p>Add a layer to the map</p> <p>Parameters:</p> Name Type Description Default <code>layer</code> <code>Layer | dict</code> <p>The Layer to be added to the map.</p> required Source code in <code>maplibre/map.py</code> <pre><code>def add_layer(self, layer: [Layer | dict]) -&gt; None:\n    \"\"\"Add a layer to the map\n\n    Args:\n        layer (Layer | dict): The Layer to be added to the map.\n    \"\"\"\n    if isinstance(layer, Layer):\n        layer = layer.to_dict()\n\n    self.add_call(\"addLayer\", layer)\n</code></pre>"},{"location":"api/map/#maplibre.Map.add_marker","title":"<code>add_marker(marker)</code>","text":"<p>Add a marker to the map</p> <p>Parameters:</p> Name Type Description Default <code>marker</code> <code>Marker</code> <p>The marker to be added to the map.</p> required Source code in <code>maplibre/map.py</code> <pre><code>def add_marker(self, marker: Marker) -&gt; None:\n    \"\"\"Add a marker to the map\n\n    Args:\n        marker (Marker): The marker to be added to the map.\n    \"\"\"\n    self.add_call(\"addMarker\", marker.to_dict())\n</code></pre>"},{"location":"api/map/#maplibre.Map.add_popup","title":"<code>add_popup(layer_id, prop=None, template=None)</code>","text":"<p>Add a popup to the map</p> <p>Parameters:</p> Name Type Description Default <code>layer_id</code> <code>str</code> <p>The layer to which the popup is added.</p> required <code>prop</code> <code>str</code> <p>The property of the source to be displayed. If <code>None</code>, all properties are displayed.</p> <code>None</code> <code>template</code> <code>str</code> <p>A mustache template. If supplied, <code>prop</code> is ignored.</p> <code>None</code> Source code in <code>maplibre/map.py</code> <pre><code>def add_popup(self, layer_id: str, prop: str = None, template: str = None) -&gt; None:\n    \"\"\"Add a popup to the map\n\n    Args:\n        layer_id (str): The layer to which the popup is added.\n        prop (str): The property of the source to be displayed. If `None`, all properties are displayed.\n        template (str): A mustache template. If supplied, `prop` is ignored.\n    \"\"\"\n    self.add_call(\"addPopup\", layer_id, prop, template)\n</code></pre>"},{"location":"api/map/#maplibre.Map.add_source","title":"<code>add_source(id, source)</code>","text":"<p>Add a source to the map</p> Source code in <code>maplibre/map.py</code> <pre><code>def add_source(self, id: str, source: [Source | dict]) -&gt; None:\n    \"\"\"Add a source to the map\"\"\"\n    if isinstance(source, Source):\n        source = source.to_dict()\n\n    self.add_call(\"addSource\", id, source)\n</code></pre>"},{"location":"api/map/#maplibre.Map.add_tooltip","title":"<code>add_tooltip(layer_id, prop=None, template=None)</code>","text":"<p>Add a tooltip to the map</p> <p>Parameters:</p> Name Type Description Default <code>layer_id</code> <code>str</code> <p>The layer to which the tooltip is added.</p> required <code>prop</code> <code>str</code> <p>The property of the source to be displayed. If <code>None</code>, all properties are displayed.</p> <code>None</code> <code>template</code> <code>str</code> <p>A mustache template. If supplied, <code>prop</code> is ignored.</p> <code>None</code> <p>Examples:</p> <pre><code>&gt;&gt;&gt; map = Map()\n&gt;&gt;&gt; # ...\n&gt;&gt;&gt; map.add_tooltip(\"test-layer\", template=\"Name: {{ name }}\")\n</code></pre> Source code in <code>maplibre/map.py</code> <pre><code>def add_tooltip(\n    self, layer_id: str, prop: str = None, template: str = None\n) -&gt; None:\n    \"\"\"Add a tooltip to the map\n\n    Args:\n        layer_id (str): The layer to which the tooltip is added.\n        prop (str): The property of the source to be displayed. If `None`, all properties are displayed.\n        template (str): A mustache template. If supplied, `prop` is ignored.\n\n    Examples:\n        &gt;&gt;&gt; map = Map()\n        &gt;&gt;&gt; # ...\n        &gt;&gt;&gt; map.add_tooltip(\"test-layer\", template=\"Name: {{ name }}\")\n    \"\"\"\n    self.add_call(\"addTooltip\", layer_id, prop, template)\n</code></pre>"},{"location":"api/map/#maplibre.Map.set_data","title":"<code>set_data(source_id, data)</code>","text":"<p>Update the data of a GeoJSON source</p> <p>Parameters:</p> Name Type Description Default <code>source_id</code> <code>str</code> <p>The name of the source to be updated.</p> required <code>data</code> <code>dict</code> <p>The data of the source.</p> required Source code in <code>maplibre/map.py</code> <pre><code>def set_data(self, source_id: str, data: dict) -&gt; None:\n    \"\"\"Update the data of a GeoJSON source\n\n    Args:\n        source_id (str): The name of the source to be updated.\n        data (dict): The data of the source.\n    \"\"\"\n    self.add_call(\"setSourceData\", source_id, data)\n</code></pre>"},{"location":"api/map/#maplibre.Map.set_filter","title":"<code>set_filter(layer_id, filter_)</code>","text":"<p>Update the filter of a layer</p> <p>Parameters:</p> Name Type Description Default <code>layer_id</code> <code>str</code> <p>The name of the layer to be updated.</p> required <code>filter_</code> <code>list</code> <p>The filter expression that is applied to the source of the layer.</p> required Source code in <code>maplibre/map.py</code> <pre><code>def set_filter(self, layer_id: str, filter_: list):\n    \"\"\"Update the filter of a layer\n\n    Args:\n        layer_id (str): The name of the layer to be updated.\n        filter_ (list): The filter expression that is applied to the source of the layer.\n    \"\"\"\n    self.add_call(\"setFilter\", layer_id, filter_)\n</code></pre>"},{"location":"api/map/#maplibre.Map.set_layout_property","title":"<code>set_layout_property(layer_id, prop, value)</code>","text":"<p>Update a layout property of a layer</p> <p>Parameters:</p> Name Type Description Default <code>layer_id</code> <code>str</code> <p>The name of the layer to be updated.</p> required <code>prop</code> <code>str</code> <p>The name of the layout property to be updated.</p> required <code>value</code> <code>any</code> <p>The new value of the layout property.</p> required Source code in <code>maplibre/map.py</code> <pre><code>def set_layout_property(self, layer_id: str, prop: str, value: any) -&gt; None:\n    \"\"\"Update a layout property of a layer\n\n    Args:\n        layer_id (str): The name of the layer to be updated.\n        prop (str): The name of the layout property to be updated.\n        value (any): The new value of the layout property.\n    \"\"\"\n    self.add_call(\"setLayoutProperty\", layer_id, prop, value)\n</code></pre>"},{"location":"api/map/#maplibre.Map.set_paint_property","title":"<code>set_paint_property(layer_id, prop, value)</code>","text":"<p>Update the paint property of a layer</p> <p>Parameters:</p> Name Type Description Default <code>layer_id</code> <code>str</code> <p>The name of the layer to be updated.</p> required <code>prop</code> <code>str</code> <p>The name of the paint property to be updated.</p> required <code>value</code> <code>any</code> <p>The new value of the paint property.</p> required Source code in <code>maplibre/map.py</code> <pre><code>def set_paint_property(self, layer_id: str, prop: str, value: any) -&gt; None:\n    \"\"\"Update the paint property of a layer\n\n    Args:\n        layer_id (str): The name of the layer to be updated.\n        prop (str): The name of the paint property to be updated.\n        value (any): The new value of the paint property.\n    \"\"\"\n    self.add_call(\"setPaintProperty\", layer_id, prop, value)\n</code></pre>"},{"location":"api/map/#maplibre.Map.set_visibility","title":"<code>set_visibility(layer_id, visible=True)</code>","text":"<p>Update the visibility of a layer</p> <p>Parameters:</p> Name Type Description Default <code>layer_id</code> <code>str</code> <p>The name of the layer to be updated.</p> required <code>visible</code> <code>bool</code> <p>Whether the layer is visible or not.</p> <code>True</code> Source code in <code>maplibre/map.py</code> <pre><code>def set_visibility(self, layer_id: str, visible: bool = True) -&gt; None:\n    \"\"\"Update the visibility of a layer\n\n    Args:\n        layer_id (str): The name of the layer to be updated.\n        visible (bool): Whether the layer is visible or not.\n    \"\"\"\n    value = \"visible\" if visible else \"none\"\n    self.add_call(\"setLayoutProperty\", layer_id, \"visibility\", value)\n</code></pre>"},{"location":"api/map/#maplibre.Map.to_html","title":"<code>to_html(**kwargs)</code>","text":"<p>Render to html</p> <p>Parameters:</p> Name Type Description Default <code>**kwargs</code> <code>Any</code> <p>Additional keyword arguments that are passed to the template. Currently, <code>style</code> is the only supported keyword argument.</p> <code>{}</code> <p>Examples:</p> <pre><code>&gt;&gt;&gt; from maplibre import Map\n</code></pre> <pre><code>&gt;&gt;&gt; map = Map()\n&gt;&gt;&gt; with open(\"/tmp/map.html\", \"w\") as f:\n...     f.write(map.to_html(style=\"height: 800px;\")\n</code></pre> Source code in <code>maplibre/map.py</code> <pre><code>def to_html(self, **kwargs) -&gt; str:\n    \"\"\"Render to html\n\n    Args:\n        **kwargs (Any): Additional keyword arguments that are passed to the template.\n            Currently, `style` is the only supported keyword argument.\n\n    Examples:\n        &gt;&gt;&gt; from maplibre import Map\n\n        &gt;&gt;&gt; map = Map()\n        &gt;&gt;&gt; with open(\"/tmp/map.html\", \"w\") as f:\n        ...     f.write(map.to_html(style=\"height: 800px;\") # doctest: +SKIP\n    \"\"\"\n    js_lib = read_internal_file(\"srcjs\", \"index.js\")\n    js_snippet = Template(js_template).render(data=json.dumps(self.to_dict()))\n    output = Template(html_template).render(\n        js=\"\\n\".join([js_lib, js_snippet]), **kwargs\n    )\n    return output\n</code></pre>"},{"location":"api/map/#maplibre.MapOptions","title":"<code>maplibre.MapOptions</code>","text":"<p>             Bases: <code>BaseModel</code></p> <p>Map options</p> Note <p>See MapOptions for more details.</p> Source code in <code>maplibre/map.py</code> <pre><code>class MapOptions(BaseModel):\n    \"\"\"Map options\n\n    Note:\n        See [MapOptions](https://maplibre.org/maplibre-gl-js/docs/API/types/MapOptions/) for more details.\n    \"\"\"\n\n    model_config = ConfigDict(\n        validate_assignment=True, extra=\"forbid\", use_enum_values=False\n    )\n    antialias: bool = None\n    attribution_control: bool = Field(None, serialization_alias=\"attributionControl\")\n    bearing: int = None\n    bearing_snap: int = Field(None, serialization_alias=\"bearingSnap\")\n    bounds: tuple = None\n    box_zoom: bool = Field(None, serialization_alias=\"boxZoom\")\n    center: tuple = None\n    click_tolerance: int = Field(None, serialization_alias=\"clickTolerance\")\n    custom_attribution: bool = Field(None, serialization_alias=\"customAttribution\")\n    double_click_zoom: bool = Field(None, serialization_alias=\"doubleClickZoom\")\n    fade_duration: int = Field(None, serialization_alias=\"fadeDuration\")\n    fit_bounds_options: dict = Field(None, serialization_alias=\"fitBoundsOptions\")\n    hash: Union[bool, str] = None\n    interactive: bool = None\n    keyword: bool = None\n    max_bounds: tuple = Field(None, serialization_alias=\"maxBounds\")\n    max_pitch: int = Field(None, serialization_alias=\"maxPitch\")\n    max_zoom: int = Field(None, serialization_alias=\"maxZoom\")\n    min_pitch: int = Field(None, serialization_alias=\"minPitch\")\n    min_zoom: int = Field(None, serialization_alias=\"minZoom\")\n    pitch: int = None\n    scroll_zoom: bool = Field(None, serialization_alias=\"scrollZoom\")\n    style: Union[str, Carto, dict] = construct_carto_basemap_url(Carto.DARK_MATTER)\n    zoom: int = None\n\n    @field_validator(\"style\")\n    def validate_style(cls, v):\n        if isinstance(v, Carto):\n            return construct_carto_basemap_url(v)\n\n        return v\n</code></pre>"},{"location":"api/map/#maplibre.MapContext","title":"<code>maplibre.MapContext</code>","text":"<p>             Bases: <code>Map</code></p> <p>MapContext</p> <p>Use this class to update a <code>Map</code> instance in a Shiny app. Must be used inside an async function.</p> <p>See <code>maplibre.Map</code> for available methods.</p> <p>Parameters:</p> Name Type Description Default <code>id</code> <code>string</code> <p>The id of the map to be updated.</p> required <code>session</code> <code>Session</code> <p>A Shiny session. If <code>None</code>, the active session is used.</p> <code>None</code> Source code in <code>maplibre/mapcontext.py</code> <pre><code>class MapContext(Map):\n    \"\"\"MapContext\n\n    Use this class to update a `Map` instance in a Shiny app.\n    Must be used inside an async function.\n\n    See `maplibre.Map` for available methods.\n\n    Args:\n        id (string): The id of the map to be updated.\n        session (Session): A Shiny session.\n            If `None`, the active session is used.\n    \"\"\"\n\n    def __init__(self, id: str, session: Session = None) -&gt; None:\n        self.id = id\n        self._session = require_active_session(session)\n        self.map_options = {}\n        self._message_queue = []\n\n    async def __aenter__(self):\n        return self\n\n    async def __aexit__(self, exc_type, exc_val, exc_tb):\n        await self.render()\n\n    async def render(self):\n        await self._session.send_custom_message(\n            f\"pymaplibregl-{self.id}\", {\"id\": self.id, \"calls\": self._message_queue}\n        )\n</code></pre>"},{"location":"api/map/#maplibre.ipywidget.MapWidget","title":"<code>maplibre.ipywidget.MapWidget</code>","text":"<p>             Bases: <code>AnyWidget</code>, <code>Map</code></p> <p>MapWidget</p> <p>Use this class to display and update maps in Jupyter Notebooks.</p> <p>See <code>maplibre.Map</code> for available methods.</p> <p>Examples:</p> <pre><code>&gt;&gt;&gt; from maplibre import MapOptions\n&gt;&gt;&gt; from maplibre.ipywidget import MapWidget as Map\n&gt;&gt;&gt; m = Map(MapOptions(center=(-123.13, 49.254), zoom=11, pitch=45))\n&gt;&gt;&gt; m\n</code></pre> Source code in <code>maplibre/ipywidget.py</code> <pre><code>class MapWidget(AnyWidget, Map):\n    \"\"\"MapWidget\n\n    Use this class to display and update maps in Jupyter Notebooks.\n\n    See `maplibre.Map` for available methods.\n\n    Examples:\n        &gt;&gt;&gt; from maplibre import MapOptions\n        &gt;&gt;&gt; from maplibre.ipywidget import MapWidget as Map\n        &gt;&gt;&gt; m = Map(MapOptions(center=(-123.13, 49.254), zoom=11, pitch=45))\n        &gt;&gt;&gt; m # doctest: +SKIP\n    \"\"\"\n\n    _esm = join(Path(__file__).parent, \"srcjs\", \"ipywidget.js\")\n    _css = join(Path(__file__).parent, \"srcjs\", \"maplibre-gl.css\")\n    _use_message_queue = False\n    _rendered = traitlets.Bool(False, config=True).tag(sync=True)\n    map_options = traitlets.Dict().tag(sync=True)\n    calls = traitlets.List().tag(sync=True)\n    height = traitlets.Union([traitlets.Int(), traitlets.Unicode()]).tag(sync=True)\n    lng_lat = traitlets.Dict().tag(sync=True)\n\n    def __init__(self, map_options=MapOptions(), **kwargs) -&gt; None:\n        self.calls = []\n        AnyWidget.__init__(self, **kwargs)\n        Map.__init__(self, map_options, **kwargs)\n\n    @traitlets.default(\"height\")\n    def _default_height(self):\n        return \"400px\"\n\n    @traitlets.validate(\"height\")\n    def _validate_height(self, proposal):\n        height = proposal[\"value\"]\n        if isinstance(height, int):\n            return f\"{height}px\"\n\n        return height\n\n    @traitlets.observe(\"_rendered\")\n    def _on_rendered(self, change):\n        self.send({\"calls\": self._message_queue, \"msg\": \"init\"})\n        self._message_queue = []\n\n    def use_message_queue(self, value: bool = True) -&gt; None:\n        self._use_message_queue = value\n\n    def add_call(self, method_name: str, *args) -&gt; None:\n        call = [method_name, args]\n        if not self._rendered:\n            if not self._use_message_queue:\n                self.calls = self.calls + [call]\n                return\n\n            self._message_queue.append(call)\n            return\n\n        self.send({\"calls\": [call], \"msg\": \"custom call\"})\n</code></pre>"},{"location":"api/sources/","title":"Sources","text":""},{"location":"api/sources/#maplibre.sources","title":"<code>maplibre.sources</code>","text":""},{"location":"api/sources/#maplibre.sources.GeoJSONSource","title":"<code>GeoJSONSource</code>","text":"<p>             Bases: <code>Source</code></p> <p>GeoJSON Source</p> <p>Examples:</p> <pre><code>&gt;&gt;&gt; from maplibre.sources import GeoJSONSource\n</code></pre> <pre><code>&gt;&gt;&gt; source = GeoJSONSource(data=\"https://docs.mapbox.com/mapbox-gl-js/assets/earthquakes.geojson\")\n</code></pre> Source code in <code>maplibre/sources.py</code> <pre><code>class GeoJSONSource(Source):\n    \"\"\"GeoJSON Source\n\n    Examples:\n        &gt;&gt;&gt; from maplibre.sources import GeoJSONSource\n\n        &gt;&gt;&gt; source = GeoJSONSource(data=\"https://docs.mapbox.com/mapbox-gl-js/assets/earthquakes.geojson\")\n    \"\"\"\n\n    data: Union[str, dict]\n    attribution: str = None\n    buffer: int = None\n    cluster: bool = None\n    cluster_max_zoom: int = Field(None, serialization_alias=\"clusterMaxZoom\")\n    cluster_min_points: int = Field(None, serialization_alias=\"clusterMinPoints\")\n    cluster_properties: dict = Field(None, serialization_alias=\"clusterProperties\")\n    cluster_radius: int = Field(None, serialization_alias=\"clusterRadius\")\n    filter: list = None\n    generate_id: bool = Field(None, serialization_alias=\"generateId\")\n    line_metrics: bool = Field(None, serialization_alias=\"lineMetrics\")\n    maxzoom: int = None\n    promote_id: Union[str, dict] = Field(None, serialization_alias=\"promoteId\")\n    tolerance: float = None\n\n    @computed_field\n    @property\n    def type(self) -&gt; str:\n        return SourceType.GEOJSON.value\n</code></pre>"},{"location":"api/sources/#maplibre.sources.RasterTileSource","title":"<code>RasterTileSource</code>","text":"<p>             Bases: <code>Source</code></p> <p>Raster tile source</p> <p>Examples:</p> <pre><code>&gt;&gt;&gt; from maplibre.sources import RasterTileSource\n&gt;&gt;&gt; raster_source = RasterTileSource(\n...     tiles=[\"https://tile.openstreetmap.org/{z}/{x}/{y}.png\"],\n...     tile_size=256,\n...     min_zoom=0,\n...     max_zoom=19,\n... )\n</code></pre> Source code in <code>maplibre/sources.py</code> <pre><code>class RasterTileSource(Source):\n    \"\"\"Raster tile source\n\n    Examples:\n        &gt;&gt;&gt; from maplibre.sources import RasterTileSource\n        &gt;&gt;&gt; raster_source = RasterTileSource(\n        ...     tiles=[\"https://tile.openstreetmap.org/{z}/{x}/{y}.png\"],\n        ...     tile_size=256,\n        ...     min_zoom=0,\n        ...     max_zoom=19,\n        ... )\n    \"\"\"\n\n    attribution: str = None\n    bounds: tuple = None\n    max_zoom: int = Field(None, serialization_alias=\"maxzoom\")\n    min_zoom: int = Field(None, serialization_alias=\"minzoom\")\n    scheme: str = None\n    tile_size: int = Field(None, serialization_alias=\"tileSize\")\n    tiles: Union[tuple, list] = None\n    url: str = None\n    volatile: bool = None\n\n    @computed_field\n    @property\n    def type(self) -&gt; str:\n        return SourceType.RASTER.value\n</code></pre>"},{"location":"api/sources/#maplibre.sources.SourceType","title":"<code>SourceType</code>","text":"<p>             Bases: <code>Enum</code></p> <p>Source types</p> Source code in <code>maplibre/sources.py</code> <pre><code>class SourceType(Enum):\n    \"\"\"Source types\"\"\"\n\n    RASTER = \"raster\"\n    VECTOR = \"vector\"\n    RASTER_DEM = \"raster-dem\"\n    GEOJSON = \"geojson\"\n    IMAGE = \"image\"\n    VIDEO = \"video\"\n</code></pre>"},{"location":"examples/3d_indoor_mapping/","title":"3D Indoor mapping","text":"<pre><code>import sys\nimport webbrowser\n\nfrom maplibre import Layer, LayerType, Map, MapOptions\nfrom maplibre.basemaps import background\nfrom maplibre.sources import GeoJSONSource, RasterTileSource\n\nfile_name = \"/tmp/pymaplibregl_temp.html\"\n\nFLOORPLAN_SOURCE_ID = \"floorplan\"\n\nraster_source = RasterTileSource(\n    tiles=[\"https://tile.openstreetmap.org/{z}/{x}/{y}.png\"],\n    tile_size=256,\n    min_zoom=0,\n    max_zoom=19,\n)\n\nraster_layer = Layer(type=LayerType.RASTER, source=raster_source)\n\nfloorplan_source = GeoJSONSource(\n    data=\"https://maplibre.org/maplibre-gl-js/docs/assets/indoor-3d-map.geojson\"\n)\n\nfloorplan_layer = Layer(\n    type=LayerType.FILL_EXTRUSION,\n    id=\"floorplan\",\n    source=FLOORPLAN_SOURCE_ID,\n    paint={\n        \"fill-extrusion-color\": [\"get\", \"color\"],\n        \"fill-extrusion-height\": [\"get\", \"height\"],\n        \"fill-extrusion-base\": [\"get\", \"base_height\"],\n        \"fill-extrusion-opacity\": 0.5,\n    },\n)\n\nmap_options = MapOptions(\n    style=background(\"yellow\"),\n    center=(-87.61694, 41.86625),\n    zoom=17,\n    pitch=40,\n    bearing=20,\n    antialias=True,\n)\n\n\ndef create_map():\n    m = Map(map_options)\n    m.add_layer(raster_layer)\n    m.add_source(FLOORPLAN_SOURCE_ID, floorplan_source)\n    m.add_layer(floorplan_layer)\n    return m\n\n\nif __name__ == \"__main__\":\n    m = create_map()\n    if len(sys.argv) == 2:\n        file_name = sys.argv[1]\n\n    with open(file_name, \"w\") as f:\n        f.write(m.to_html())\n\n    webbrowser.open(file_name)\n</code></pre> <p>Run example:</p> <pre><code>poetry run python docs/examples/3d_indoor_mapping/app.py\n</code></pre>"},{"location":"examples/airports/","title":"Airport markers","text":"<pre><code>import sys\n\nimport pandas as pd\nfrom maplibre import (\n    Layer,\n    LayerType,\n    Map,\n    MapOptions,\n    output_maplibregl,\n    render_maplibregl,\n)\nfrom maplibre.basemaps import Carto\nfrom maplibre.controls import Marker, MarkerOptions, Popup, PopupOptions\nfrom maplibre.sources import GeoJSONSource\nfrom maplibre.utils import GeometryType, df_to_geojson\nfrom shiny import App, ui\n\nBOUNDS = (-8.92242886, 43.30508298, 13.76496714, 59.87668996)\n\nairports_data = pd.read_json(\n    \"https://github.com/visgl/deck.gl-data/raw/master/examples/line/airports.json\"\n)\n\n\ndef get_color(airport_type: str) -&gt; str:\n    color = \"darkblue\"\n    if airport_type == \"mid\":\n        color = \"darkred\"\n    elif airport_type == \"major\":\n        color = \"darkgreen\"\n\n    return color\n\n\ngeojson = df_to_geojson(\n    airports_data,\n    \"coordinates\",\n    GeometryType.POINT,\n    properties=[\"type\", \"name\", \"abbrev\"],\n)\n\nairport_circles = Layer(\n    type=LayerType.CIRCLE,\n    source=GeoJSONSource(data=geojson),\n    paint={\n        \"circle-color\": [\n            \"match\",\n            [\"get\", \"type\"],\n            \"mid\",\n            \"darkred\",\n            \"major\",\n            \"darkgreen\",\n            \"darkblue\",\n        ],\n        \"circle_radius\": 10,\n        \"circle-opacity\": 0.3,\n    },\n)\n\nmap_options = MapOptions(\n    style=Carto.POSITRON,\n    bounds=BOUNDS,\n    fit_bounds_options={\"padding\": 20},\n    hash=True,\n)\n\npopup_options = PopupOptions(close_button=False)\n\n\ndef create_map() -&gt; Map:\n    m = Map(map_options)\n    m.add_layer(airport_circles)\n    for _, r in airports_data.iterrows():\n        marker = Marker(\n            lng_lat=r[\"coordinates\"],\n            options=MarkerOptions(color=get_color(r[\"type\"])),\n            popup=Popup(\n                text=r[\"name\"],\n                options=popup_options,\n            ),\n        )\n        m.add_marker(marker)\n    return m\n\n\napp_ui = ui.page_fluid(\n    ui.panel_title(\"Airports\"),\n    output_maplibregl(\"maplibre\", height=600),\n)\n\n\ndef server(input, output, session):\n    @render_maplibregl\n    def maplibre():\n        return create_map()\n\n\napp = App(app_ui, server)\n\nif __name__ == \"__main__\":\n    if len(sys.argv) == 2:\n        with open(sys.argv[1], \"w\") as f:\n            f.write(create_map().to_html())\n    else:\n        app.run()\n</code></pre> <p>Run example:</p> <pre><code>poetry run uvicorn docs.examples.airports.app:app --reload\n</code></pre>"},{"location":"examples/custom_basemap/","title":"Custom basemap","text":"<pre><code>import sys\nimport webbrowser\n\nfrom maplibre import Layer, LayerType, Map, MapOptions\nfrom maplibre.basemaps import construct_basemap_style\nfrom maplibre.sources import GeoJSONSource\n\nfile_name = \"/tmp/pymaplibregl_temp.html\"\n\nbg_layer = Layer(\n    type=LayerType.BACKGROUND,\n    id=\"background\",\n    source=None,\n    paint={\"background-color\": \"darkblue\", \"background-opacity\": 0.8},\n)\n\ncountries_source = GeoJSONSource(\n    data=\"https://d2ad6b4ur7yvpq.cloudfront.net/naturalearth-3.3.0/ne_110m_admin_0_countries.geojson\"\n)\n\nlines_layer = Layer(\n    type=LayerType.LINE,\n    source=\"countries\",\n    paint={\"line-color\": \"white\", \"line-width\": 1.5},\n)\n\npolygons_layer = Layer(\n    type=LayerType.FILL,\n    source=\"countries\",\n    paint={\"fill-color\": \"darkred\", \"fill-opacity\": 0.8},\n)\n\ncustom_basemap = construct_basemap_style(\n    layers=[bg_layer, polygons_layer, lines_layer],\n    sources={\"countries\": countries_source},\n)\n\n\nmap_options = MapOptions(\n    style=custom_basemap,\n    center=(0, 0),\n    zoom=2,\n)\n\n\ndef create_map():\n    m = Map(map_options)\n    m.add_layer(\n        Layer(\n            type=LayerType.CIRCLE,\n            id=\"earthquakes\",\n            source=GeoJSONSource(\n                data=\"https://docs.mapbox.com/mapbox-gl-js/assets/earthquakes.geojson\"\n            ),\n            paint={\"circle-color\": \"yellow\", \"circle-radius\": 5},\n        )\n    )\n    m.add_popup(\"earthquakes\", \"mag\")\n    return m\n\n\nif __name__ == \"__main__\":\n    m = create_map()\n    if len(sys.argv) == 2:\n        file_name = sys.argv[1]\n\n    with open(file_name, \"w\") as f:\n        f.write(m.to_html())\n\n    webbrowser.open(file_name)\n</code></pre> <p>Run example:</p> <pre><code>poetry run python docs/examples/custom_basemap/app.py\n</code></pre>"},{"location":"examples/earthquake_clusters/","title":"Earthquake clusters","text":"<pre><code>import sys\n\nfrom maplibre import (\n    Layer,\n    LayerType,\n    Map,  # render_maplibregl,\n    MapLibreRenderer,\n    MapOptions,\n    output_maplibregl,\n)\nfrom maplibre.basemaps import Carto\nfrom maplibre.sources import GeoJSONSource\nfrom shiny import App, reactive, ui\n\nEARTHQUAKE_SOURCE = \"earthquakes\"\nEARTHQUAKE_CIRCLES = \"earthquake-circles\"\nEARTHQUAKE_CLUSTERS = \"earthquake-clusters\"\nEARTHQUAKE_LABELS = \"earthquake-labels\"\n\nCENTER = (-118.0931, 33.78615)\n\nearthquakes_source = GeoJSONSource(\n    data=\"https://docs.mapbox.com/mapbox-gl-js/assets/earthquakes.geojson\",\n    cluster=True,\n    cluster_radius=50,\n    cluster_min_points=2,\n    cluster_max_zoom=14,\n    cluster_properties={\n        \"maxMag\": [\"max\", [\"get\", \"mag\"]],\n        \"minMag\": [\"min\", [\"get\", \"mag\"]],\n    },\n)\n\nearthquake_circles = Layer(\n    type=LayerType.CIRCLE,\n    id=EARTHQUAKE_CIRCLES,\n    source=EARTHQUAKE_SOURCE,\n    paint={\"circle-color\": \"darkblue\"},\n    filter=[\"!\", [\"has\", \"point_count\"]],\n)\n\nearthquake_clusters = Layer(\n    type=LayerType.CIRCLE,\n    id=EARTHQUAKE_CLUSTERS,\n    source=EARTHQUAKE_SOURCE,\n    filter=[\"has\", \"point_count\"],\n    paint={\n        \"circle-color\": [\n            \"step\",\n            [\"get\", \"point_count\"],\n            \"#51bbd6\",\n            100,\n            \"#f1f075\",\n            750,\n            \"#f28cb1\",\n        ],\n        \"circle-radius\": [\"step\", [\"get\", \"point_count\"], 20, 100, 30, 750, 40],\n    },\n)\n\nearthquake_labels = Layer(\n    type=LayerType.SYMBOL,\n    id=\"text\",\n    source=EARTHQUAKE_SOURCE,\n    filter=[\"has\", \"point_count\"],\n    layout={\n        \"text-field\": [\"get\", \"point_count_abbreviated\"],\n        \"text-size\": 12,\n    },\n)\n\nmap_options = MapOptions(style=Carto.POSITRON, center=CENTER, zoom=3, hash=True)\n\n\ndef create_map() -&gt; Map:\n    m = Map(map_options)\n    m.add_source(EARTHQUAKE_SOURCE, earthquakes_source)\n    m.add_layer(earthquake_clusters)\n    m.add_layer(earthquake_circles)\n    m.add_tooltip(EARTHQUAKE_CLUSTERS, \"maxMag\")\n    m.add_layer(earthquake_labels)\n    return m\n\n\napp_ui = ui.page_fluid(\n    ui.panel_title(\"Earthquakes Cluster\"),\n    output_maplibregl(\"maplibre\", height=500),\n)\n\n\ndef server(input, output, session):\n    @MapLibreRenderer\n    def maplibre():\n        return create_map()\n\n    @reactive.Effect\n    @reactive.event(input.maplibre)\n    async def result():\n        print(f\"result: {input.maplibre()}\")\n\n\napp = App(app_ui, server)\n\nif __name__ == \"__main__\":\n    if len(sys.argv) == 2:\n        file_name = sys.argv[1]\n        with open(file_name, \"w\") as f:\n            f.write(create_map().to_html())\n    else:\n        app.run()\n</code></pre> <p>Run example:</p> <pre><code>poetry run uvicorn docs.examples.earthquake_clusters.app:app --reload\n</code></pre>"},{"location":"examples/every_person_in_manhattan/","title":"Every person in manhattan","text":"<pre><code>import json\nimport sys\n\nimport pandas as pd\nimport shapely\nfrom maplibre import (\n    Layer,\n    LayerType,\n    Map,\n    MapContext,\n    MapOptions,\n    output_maplibregl,\n    render_maplibregl,\n)\nfrom maplibre.basemaps import Carto\nfrom maplibre.controls import ScaleControl\n\n# New since Shiny v0.7.0\nfrom maplibre.shiny import MapLibreRenderer\nfrom maplibre.sources import GeoJSONSource\nfrom maplibre.utils import df_to_geojson\nfrom shiny import App, reactive, ui\n\nMALE_COLOR = \"rgb(0, 128, 255)\"\nFEMALE_COLOR = \"rgb(255, 0, 128)\"\nLAYER_ID = \"every-person-in-manhattan-circles\"\nCIRCLE_RADIUS = 2\n\npoint_data = pd.read_json(\n    \"https://raw.githubusercontent.com/visgl/deck.gl-data/master/examples/scatterplot/manhattan.json\"\n)\n\npoint_data.columns = [\"lng\", \"lat\", \"sex\"]\n\nevery_person_in_manhattan_source = GeoJSONSource(\n    data=df_to_geojson(point_data, properties=[\"sex\"]),\n)\n\nbbox = shapely.bounds(\n    shapely.from_geojson(json.dumps(every_person_in_manhattan_source.data))\n)\n\nevery_person_in_manhattan_circles = Layer(\n    type=LayerType.CIRCLE,\n    id=LAYER_ID,\n    source=every_person_in_manhattan_source,\n    paint={\n        \"circle-color\": [\"match\", [\"get\", \"sex\"], 1, MALE_COLOR, FEMALE_COLOR],\n        \"circle-radius\": CIRCLE_RADIUS,\n    },\n)\n\nmap_options = MapOptions(\n    style=Carto.POSITRON,\n    bounds=tuple(bbox),\n    fit_bounds_options={\"padding\": 20},\n)\n\n\ndef create_map() -&gt; Map:\n    m = Map(map_options)\n    m.add_control(ScaleControl(), position=\"bottom-left\")\n    m.add_layer(every_person_in_manhattan_circles)\n    return m\n\n\napp_ui = ui.page_fluid(\n    ui.panel_title(\"Every Person in Manhattan\"),\n    output_maplibregl(\"maplibre\", height=600),\n    ui.input_slider(\"radius\", \"Radius\", value=CIRCLE_RADIUS, min=1, max=5),\n)\n\n\ndef server(input, output, session):\n    @MapLibreRenderer\n    def maplibre():\n        return create_map()\n\n    @reactive.Effect\n    @reactive.event(input.radius, ignore_init=True)\n    async def radius():\n        async with MapContext(\"maplibre\") as m:\n            m.set_paint_property(LAYER_ID, \"circle-radius\", input.radius())\n\n\napp = App(app_ui, server)\n\nif __name__ == \"__main__\":\n    if len(sys.argv) == 2:\n        file_name = sys.argv[1]\n        with open(file_name, \"w\") as f:\n            f.write(create_map().to_html())\n    else:\n        app.run()\n</code></pre> <p>Run example:</p> <pre><code>poetry run uvicorn docs.examples.every_person_in_manhattan.app:app --reload\n</code></pre>"},{"location":"examples/geopandas/","title":"GeoPandas","text":"<pre><code>import sys\nimport webbrowser\n\nfrom maplibre import Layer, LayerType, Map, MapOptions\nfrom maplibre.sources import GeoJSONSource\nfrom maplibre.utils import geopandas_to_geojson\n\nimport geopandas as gpd\n\nfile_name = \"/tmp/pymaplibregl_temp.html\"\nLAYER_ID = \"wilderness\"\n\ndf_geo = gpd.read_file(\n    \"zip+https://github.com/Toblerity/Fiona/files/11151652/coutwildrnp.zip\"\n)\n\nwilderness_source = GeoJSONSource(data=geopandas_to_geojson(df_geo))\n\nwilderness_layer = Layer(\n    type=LayerType.FILL,\n    id=LAYER_ID,\n    source=wilderness_source,\n    paint={\"fill-color\": \"darkred\", \"fill-opacity\": 0.5},\n)\n\nmap_options = MapOptions(bounds=df_geo.total_bounds)\n\n\ndef create_map():\n    m = Map(map_options)\n    m.add_layer(wilderness_layer)\n    m.add_tooltip(LAYER_ID, \"NAME\")\n    return m\n\n\nif __name__ == \"__main__\":\n    m = create_map()\n    if len(sys.argv) == 2:\n        file_name = sys.argv[1]\n\n    with open(file_name, \"w\") as f:\n        f.write(m.to_html())\n\n    webbrowser.open(file_name)\n</code></pre> <p>Run example:</p> <pre><code>poetry run python docs/examples/geopandas/app.py\n</code></pre>"},{"location":"examples/road_safety/","title":"H3 Grid UK Road Safety","text":"<pre><code>import sys\nimport webbrowser\n\nimport h3\nimport pandas as pd\nfrom maplibre import (\n    Layer,\n    LayerType,\n    Map,\n    MapContext,\n    MapOptions,\n    output_maplibregl,\n    render_maplibregl,\n)\nfrom maplibre.sources import GeoJSONSource\nfrom maplibre.utils import df_to_geojson\nfrom shiny import App, reactive, ui\n\nRESOLUTION = 7\nCOLORS = (\n    \"lightblue\",\n    \"turquoise\",\n    \"lightgreen\",\n    \"yellow\",\n    \"orange\",\n    \"darkred\",\n)\n\nroad_safety = pd.read_csv(\n    \"https://raw.githubusercontent.com/visgl/deck.gl-data/master/examples/3d-heatmap/heatmap-data.csv\"\n).dropna()\n\n\ndef create_h3_grid(res=RESOLUTION) -&gt; dict:\n    road_safety[\"h3\"] = road_safety.apply(\n        lambda x: h3.geo_to_h3(x[\"lat\"], x[\"lng\"], resolution=res), axis=1\n    )\n    df = road_safety.groupby(\"h3\").h3.agg(\"count\").to_frame(\"count\").reset_index()\n    df[\"hexagon\"] = df.apply(\n        lambda x: [h3.h3_to_geo_boundary(x[\"h3\"], geo_json=True)], axis=1\n    )\n    df[\"color\"] = pd.cut(\n        df[\"count\"],\n        bins=len(COLORS),\n        labels=COLORS,\n    )\n    return df_to_geojson(\n        df, \"hexagon\", geometry_type=\"Polygon\", properties=[\"count\", \"color\"]\n    )\n\n\nsource = GeoJSONSource(data=create_h3_grid())\n\nmap_options = MapOptions(\n    center=(-1.415727, 52.232395),\n    zoom=7,\n    pitch=40,\n    bearing=-27,\n)\n\nh3_layer = Layer(\n    id=\"road-safety\",\n    type=LayerType.FILL_EXTRUSION,\n    source=source,\n    paint={\n        \"fill-extrusion-color\": [\"get\", \"color\"],\n        \"fill-extrusion-opacity\": 0.7,\n        \"fill-extrusion-height\": [\"*\", 100, [\"get\", \"count\"]],\n    },\n)\n\n\ndef create_map() -&gt; Map:\n    m = Map(map_options)\n    m.add_layer(h3_layer)\n    m.add_tooltip(\"road-safety\", \"count\")\n    return m\n\n\napp_ui = ui.page_fluid(\n    ui.panel_title(\"Road safety in UK\"),\n    output_maplibregl(\"mapylibre\", height=700),\n    ui.input_slider(\"res\", \"Resolution\", min=4, max=8, step=1, value=RESOLUTION),\n)\n\n\ndef server(input, output, session):\n    @render_maplibregl\n    def mapylibre():\n        return create_map()\n\n    @reactive.Effect\n    @reactive.event(input.res, ignore_init=True)\n    async def resolution():\n        async with MapContext(\"mapylibre\") as m:\n            with ui.Progress() as p:\n                p.set(message=\"H3 calculation in progress\")\n                m.set_data(\"road-safety\", create_h3_grid(input.res()))\n                p.set(1, message=\"Calculation finished\")\n\n\napp = App(app_ui, server)\n\nif __name__ == \"__main__\":\n    filename = sys.argv[1] if len(sys.argv) == 2 else \"/tmp/road_safety.html\"\n    with open(filename, \"w\") as f:\n        m = create_map()\n        f.write(m.to_html(style=\"height: 700px;\"))\n\n    webbrowser.open(filename)\n</code></pre> <p>Run example:</p> <pre><code>poetry run uvicorn docs.examples.road_safety.app:app --reload\n</code></pre>"},{"location":"examples/vancouver_blocks/","title":"Vancouver property value","text":"<pre><code>import sys\n\nfrom maplibre import (\n    Layer,\n    LayerType,\n    Map,\n    MapContext,\n    MapOptions,\n    output_maplibregl,\n    render_maplibregl,\n)\nfrom maplibre.basemaps import Carto\nfrom maplibre.controls import ScaleControl\nfrom maplibre.sources import GeoJSONSource\nfrom shiny import App, reactive, ui\n\nSOURCE_ID = \"vancouver-blocks\"\nLAYER_ID_LINES = \"vancouver-blocks-lines\"\nLAYER_ID_FILL = \"vancouver-blocks-fill-extrusion\"\nMAX_FILTER_VALUE = 1000000\n\nvancouver_blocks_source = GeoJSONSource(\n    data=\"https://raw.githubusercontent.com/visgl/deck.gl-data/master/examples/geojson/vancouver-blocks.json\"\n)\n\nvancouver_blocks_lines = Layer(\n    type=LayerType.LINE,\n    id=LAYER_ID_LINES,\n    source=SOURCE_ID,\n    paint={\n        \"line-color\": \"white\",\n        \"line-width\": 2,\n    },\n)\n\nvancouver_blocks_fill = Layer(\n    type=LayerType.FILL_EXTRUSION,\n    id=LAYER_ID_FILL,\n    source=SOURCE_ID,\n    paint={\n        \"fill-extrusion-color\": {\n            \"property\": \"valuePerSqm\",\n            \"stops\": [\n                [0, \"grey\"],\n                [1000, \"yellow\"],\n                [5000, \"orange\"],\n                [10000, \"darkred\"],\n                [50000, \"lightblue\"],\n            ],\n        },\n        \"fill-extrusion-height\": [\"*\", 10, [\"sqrt\", [\"get\", \"valuePerSqm\"]]],\n        \"fill-extrusion-opacity\": 0.9,\n    },\n)\n\nmap_options = MapOptions(\n    style=Carto.DARK_MATTER,\n    center=(-123.13, 49.254),\n    zoom=11,\n    pitch=45,\n    bearing=0,\n)\n\n\ndef create_map() -&gt; Map:\n    m = Map(map_options)\n    m.add_control(ScaleControl(), position=\"bottom-left\")\n    m.add_source(SOURCE_ID, vancouver_blocks_source)\n    m.add_layer(vancouver_blocks_lines)\n    m.add_layer(vancouver_blocks_fill)\n    m.add_tooltip(LAYER_ID_FILL, \"valuePerSqm\")\n    return m\n\n\napp_ui = ui.page_fluid(\n    ui.panel_title(\"Vancouver Property Value\"),\n    ui.div(\n        \"Height of polygons - average property value per square meter of lot\",\n        style=\"padding: 10px;\",\n    ),\n    output_maplibregl(\"maplibre\", height=600),\n    ui.input_select(\n        \"filter\",\n        \"max property value per square meter\",\n        choices=[0, 1000, 5000, 10000, 50000, 100000, MAX_FILTER_VALUE],\n        selected=MAX_FILTER_VALUE,\n    ),\n    ui.input_checkbox_group(\n        \"layers\",\n        \"Layers\",\n        choices=[LAYER_ID_FILL, LAYER_ID_LINES],\n        selected=[LAYER_ID_FILL, LAYER_ID_LINES],\n    ),\n)\n\n\ndef server(input, output, session):\n    @render_maplibregl\n    def maplibre():\n        m = create_map()\n        return m\n\n    @reactive.Effect\n    @reactive.event(input.filter)\n    async def filter():\n        async with MapContext(\"maplibre\") as m:\n            filter_ = [\"&lt;=\", [\"get\", \"valuePerSqm\"], int(input.filter())]\n            m.set_filter(LAYER_ID_FILL, filter_)\n\n    @reactive.Effect\n    @reactive.event(input.layers)\n    async def layers():\n        visible_layers = input.layers()\n        async with MapContext(\"maplibre\") as m:\n            for layer in [LAYER_ID_FILL, LAYER_ID_LINES]:\n                m.set_visibility(layer, layer in visible_layers)\n\n\napp = App(app_ui, server)\n\nif __name__ == \"__main__\":\n    if len(sys.argv) == 2:\n        file_name = sys.argv[1]\n        m = create_map()\n        with open(file_name, \"w\") as f:\n            f.write(m.to_html())\n    else:\n        app.run()\n</code></pre> <p>Run example:</p> <pre><code>poetry run uvicorn docs.examples.vancouver_blocks.app:app --reload\n</code></pre>"},{"location":"examples/where_is_the_iss/","title":"Where is the ISS","text":"<pre><code>import requests\nfrom maplibre import (\n    Layer,\n    LayerType,\n    Map,\n    MapContext,\n    MapOptions,\n    output_maplibregl,\n    render_maplibregl,\n)\nfrom maplibre.sources import GeoJSONSource\nfrom shiny import App, reactive, ui\n\nMAX_FEATURES = 30\nSOURCE_ID_ISS_POSITION = \"iss_position\"\nSOURCE_ID_ISS_LAST_POSITIONS = \"iss-last-positions\"\n\n\ndef where_is_the_iss() -&gt; tuple:\n    r = requests.get(\"https://api.wheretheiss.at/v1/satellites/25544\").json()\n    return (r[\"longitude\"], r[\"latitude\"])\n\n\ndef create_feature(lng_lat: tuple) -&gt; dict:\n    return {\n        \"type\": \"Feature\",\n        \"geometry\": {\n            \"type\": \"Point\",\n            \"coordinates\": lng_lat,\n        },\n        \"properties\": {\"coords\": \", \".join(map(str, lng_lat))},\n    }\n\n\nlng_lat = where_is_the_iss()\nfeature = create_feature(where_is_the_iss())\nfeature_collection = {\"type\": \"FeatureCollection\", \"features\": [feature]}\n\napp_ui = ui.page_fluid(\n    ui.panel_title(\"Where is the ISS\"),\n    ui.div(\"Click on Update to get the current position of the ISS.\"),\n    ui.div(\n        \"The yellow dots show the positions before. Hover the blue dot to display the coordinates.\"\n    ),\n    output_maplibregl(\"mapylibre\", height=600),\n    ui.input_action_button(\"update\", \"Update\"),\n)\n\n\ndef server(input, output, session):\n    @render_maplibregl\n    def mapylibre():\n        m = Map(MapOptions(center=lng_lat, zoom=3))\n        m.set_paint_property(\"water\", \"fill-color\", \"darkblue\")\n        m.add_source(\n            SOURCE_ID_ISS_LAST_POSITIONS, GeoJSONSource(data=feature_collection)\n        )\n        m.add_layer(\n            Layer(\n                type=LayerType.CIRCLE,\n                source=SOURCE_ID_ISS_LAST_POSITIONS,\n                paint={\"circle-color\": \"yellow\", \"circle-radius\": 5},\n            ),\n        )\n        m.add_source(SOURCE_ID_ISS_POSITION, GeoJSONSource(data=feature))\n        m.add_layer(\n            Layer(\n                type=LayerType.CIRCLE,\n                id=\"iss-position\",\n                source=SOURCE_ID_ISS_POSITION,\n                paint={\"circle-color\": \"lightblue\", \"circle-radius\": 7},\n            )\n        )\n        m.add_tooltip(\"iss-position\", \"coords\")\n        return m\n\n    @reactive.Effect\n    @reactive.event(input.update)\n    async def update():\n        print(\"Fetching new position\")\n        lng_lat = where_is_the_iss()\n        print(lng_lat)\n        if len(feature_collection[\"features\"]) == MAX_FEATURES:\n            feature_collection[\"features\"] = []\n\n        async with MapContext(\"mapylibre\") as m:\n            feature = create_feature(lng_lat)\n            m.set_data(SOURCE_ID_ISS_POSITION, feature)\n            feature_collection[\"features\"].append(feature)\n            m.set_data(SOURCE_ID_ISS_LAST_POSITIONS, feature_collection)\n            m.add_call(\"flyTo\", {\"center\": lng_lat, \"speed\": 0.5})\n\n\napp = App(app_ui, server)\n</code></pre> <p>Run example:</p> <pre><code>poetry run uvicorn docs.examples.where_is_the_iss.app:app --reload\n</code></pre>"},{"location":"examples/wms/","title":"WMS","text":"<pre><code>import webbrowser\n\nfrom maplibre import Layer, LayerType, Map, MapOptions\nfrom maplibre.sources import RasterTileSource\n\nSOURCE_ID = \"wms-test-source\"\nLAYER_ID = \"wms-test-layer\"\n\nwms_source = RasterTileSource(\n    tiles=[\n        \"https://img.nj.gov/imagerywms/Natural2015?bbox={bbox-epsg-3857}&amp;format=image/png&amp;service=WMS&amp;version=1.1.1&amp;request=GetMap&amp;srs=EPSG:3857&amp;transparent=true&amp;width=256&amp;height=256&amp;layers=Natural2015\"\n    ],\n    tile_size=256,\n)\nwms_layer = Layer(type=LayerType.RASTER, source=SOURCE_ID, id=LAYER_ID)\n\nmap_options = MapOptions(zoom=8, center=(-74.5447, 40.6892))\n\nm = Map(map_options=map_options)\nm.add_source(SOURCE_ID, wms_source)\nm.add_layer(wms_layer)\n\ntemp_file = \"/tmp/pymaplibregl.html\"\n\nwith open(temp_file, \"w\") as f:\n    f.write(m.to_html(style=\"height: 800px;\"))\n\nwebbrowser.open(temp_file)\n</code></pre>"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"MapLibre for Python","text":"<p>MapLibre for Python provides Python bindings for MapLibre GL JS.</p> <p>It integrates seamlessly into Shiny for Python and Jupyter.</p>"},{"location":"#installation","title":"Installation","text":"<pre><code># Stable\npip install maplibre\n\npip install \"maplibre[all]\"\n\n# Dev\npip install git+https://github.com/eodaGmbH/py-maplibregl@dev\n</code></pre>"},{"location":"#basic-usage","title":"Basic usage","text":""},{"location":"#standalone","title":"Standalone","text":"<pre><code>import webbrowser\n\nfrom maplibre import Layer, LayerType, Map, MapOptions\nfrom maplibre.sources import GeoJSONSource\n\nvancouver_blocks = GeoJSONSource(\n    data=\"https://raw.githubusercontent.com/visgl/deck.gl-data/master/examples/geojson/vancouver-blocks.json\",\n)\n\nmap_options = MapOptions(\n    center=(-123.1256, 49.24658),\n    zoom=12,\n    hash=True,\n    pitch=35,\n)\n\nm = Map(map_options)\nm.add_layer(\n    Layer(\n        type=LayerType.LINE,\n        source=vancouver_blocks,\n        paint={\"line-color\": \"white\"},\n    )\n)\n\ntemp_file = \"/tmp/pymaplibregl.html\"\n\nwith open(temp_file, \"w\") as f:\n    f.write(m.to_html(style=\"height: 800px;\"))\n\nwebbrowser.open(temp_file)\n</code></pre>"},{"location":"#shiny-integration","title":"Shiny integration","text":"<pre><code>from maplibre import Map, MapContext, output_maplibregl, render_maplibregl\nfrom maplibre.controls import Marker\nfrom shiny import App, reactive, ui\n\napp_ui = ui.page_fluid(\n    output_maplibregl(\"maplibre\", height=600),\n    ui.div(\"Click on map to set a marker\"),\n)\n\n\ndef server(input, output, session):\n    @render_maplibregl\n    def maplibre():\n        m = Map()\n        return m\n\n    @reactive.Effect\n    @reactive.event(input.maplibre)\n    async def coords():\n        async with MapContext(\"maplibre\") as m:\n            print(input.maplibre())\n            lng_lat = tuple(input.maplibre()[\"coords\"].values())\n            marker = Marker(lng_lat=lng_lat)\n            m.add_marker(marker)\n            m.add_call(\"flyTo\", {\"center\": lng_lat})\n\n\napp = App(app_ui, server)\n\nif __name__ == \"__main__\":\n    app.run()\n</code></pre>"},{"location":"#jupyter-widget","title":"Jupyter widget","text":"<pre><code>from maplibre.ipywidget import MapWidget as Map\n\nm = Map()\nm\n</code></pre>"},{"location":"changelog/","title":"Changelog for MapLibre for Python","text":""},{"location":"changelog/#maplibre-v015","title":"maplibre v0.1.5","text":"<ul> <li>Update deprecated render function to support <code>shiny&gt;=0.7.0</code></li> </ul>"},{"location":"changelog/#maplibre-v014","title":"maplibre v0.1.4","text":"<ul> <li><code>anywidget&gt;=0.9.0</code> (#36)</li> </ul>"},{"location":"changelog/#maplibre-v013","title":"maplibre v0.1.3","text":"<ul> <li>Display all properties in popup and tooltip if <code>prop = None</code> (#26)</li> <li>Support mustache templates for popups and tooltips (#27)</li> </ul>"},{"location":"changelog/#maplibre-v012","title":"maplibre v0.1.2","text":"<ul> <li>Add <code>Map.set_data</code></li> <li>Add <code>Map.set_visibility</code></li> <li>Do not import <code>ipywidget.MapWidget</code> in <code>__init__</code> and skip tests for <code>MapWidget</code>, because it causes a <code>core dumped</code> error, see anywidget issue</li> <li>Remove <code>requests</code> dependency</li> <li>Remove dead code</li> <li>Add more examples</li> </ul>"},{"location":"changelog/#maplibre-v011","title":"maplibre v0.1.1","text":"<ul> <li>Initial PyPI release</li> </ul>"},{"location":"jupyter/","title":"Jupyter","text":"<p>Use <code>MapWidget</code> in your Juyper Notebook:</p> <pre><code>import ipywidgets as widgets\n\nfrom maplibre import Layer, LayerType\nfrom maplibre.sources import GeoJSONSource\nfrom maplibre.controls import ScaleControl, Marker\nfrom maplibre.ipywidget import MapWidget as Map\n\n# Create a source\nearthquakes = GeoJSONSource(\n    data=\"https://docs.mapbox.com/mapbox-gl-js/assets/earthquakes.geojson\"\n)\n\n# Create a layer\nlayer_id = \"earthquakes\"\n\nearthquake_circles = Layer(\n    type=LayerType.CIRCLE,\n    id=layer_id,\n    source=earthquakes,\n    paint={\"circle-color\": \"yellow\"}\n)\n\n# Render map\nm = Map()\nm.add_control(ScaleControl(), position=\"bottom-left\")\nm.add_layer(earthquake_circles)\nm.add_tooltip(layer_id, \"mag\")\nm.add_marker(Marker(lng_lat=(100.507, 13.745)))\nm\n\n# Change radius\n_ = widgets.interact(\n    lambda radius: m.set_paint_property(layer_id, \"circle-radius\", radius),\n    radius=(1, 8, 1)\n)\n\n# Change color\n_ = widgets.interact(\n    lambda color: m.set_paint_property(layer_id, \"circle-color\", color),\n    color=[\"green\", \"yellow\", \"orange\", \"red\"]\n)\n\n# Set filter on magnitude\n_ = widgets.interact(\n    lambda mag_min: m.set_filter(layer_id, [\"&gt;=\", [\"get\", \"mag\"], mag_min]),\n    mag_min=(1, 8, 1)\n)\n\n# Observe map-on-click event\nfrom IPython.display import clear_output\n\noutput = widgets.Output()\n\n\ndef log_lng_lat(lng_lat):\n    with output:\n        clear_output()\n        print(lng_lat.new)\n\n\nm.observe(log_lng_lat, names=\"lng_lat\")\noutput\n</code></pre>"},{"location":"layers/","title":"Layers","text":"<p>The <code>paint</code> and <code>layout</code> properties for the layers depend on the type of the layer. They are passed as a <code>dict</code> corresponding to the Layer Style Spec.</p> <p>For example, to set the radius and the color for a circle layer, the <code>paint</code> property looks like this:</p> <pre><code>paint = {\n    \"circle-radius\": 5,\n    \"circle-color\": \"yellow\"\n}\n</code></pre> <p>The value for any <code>layout</code> property, <code>paint</code> property, or <code>filter</code> may also be specified as an expression. For details see Expressions.</p> <p>For example, if the source of your layer has a <code>color</code> property that contains the color of the feature, you can use the following expression:</p> <pre><code>paint = {\n    \"circle-radius\": 5,\n    \"circle-color\": [\"get\", \"color\"]\n}\n</code></pre> <p>A more complex expression where the color depends on the <code>type</code> property of the layer's source might look like this:</p> <pre><code>paint={\n        \"circle-color\": [\n            \"match\",\n            [\"get\", \"type\"],\n            # darkred if type == \"mid\"\n            \"mid\",\n            \"darkred\",\n            # darkgreen if type == \"major\"\n            \"major\",\n            \"darkgreen\",\n            # else blue\n            \"darkblue\",\n        ]\n}\n</code></pre> <p>Filter features of a source according to its <code>magnitude</code> property:</p> <pre><code># Only show features where magnitude &gt;= 5\nfilter = [\"&gt;=\", [\"get\", \"magnitude\"], 5]\n</code></pre>"},{"location":"shiny/","title":"Shiny","text":""},{"location":"shiny/#input-and-output","title":"Input and output","text":"<p>Use <code>output_maplibregl</code> in the UI and <code>render_maplibregl</code> in the server section of your Shiny for Python app:</p> <pre><code>from shiny import App, ui\nfrom maplibre import output_maplibregl, render_maplibregl, Map\n\napp_ui = ui.page_fluid(\n    ui.panel_title(\"MapLibre\"),\n    output_maplibregl(\"maplibre\", height=600)\n)\n\n\ndef server(input, output, session):\n    @render_maplibregl\n    def maplibre():\n        m = Map()\n        return m\n\n\napp = App(app_ui, server)\n</code></pre>"},{"location":"shiny/#reactivity","title":"Reactivity","text":""},{"location":"shiny/#input-events","title":"Input events","text":"<p>MapLibre for Python provides the following reactive inputs:</p> <ul> <li><code>map-on-click</code> event: Sends the coordinates of the location that was clicked on. The name of the input event corresponds to the output id.     For <code>output_maplibregl(\"maplibre\")</code> you need to listen to <code>input.maplibre</code>.</li> <li><code>feature-on-click</code> event: Sends the properties of the feature that was clicked on. The name of the \u00ecnput is made up of the output id + <code>layer</code> + layer id.      For <code>output_maplibregl(\"maplibre\")</code> and a layer with <code>id=test</code> you need to listen to <code>input.maplibre_layer_test</code>.</li> </ul>"},{"location":"shiny/#map-updates","title":"Map updates","text":"<p>Use <code>MapContext</code> to update your <code>Map</code> object.</p>"},{"location":"shiny/#example","title":"Example","text":"<pre><code>from maplibre import (\n    Layer,\n    LayerType,\n    Map,\n    MapContext,\n    output_maplibregl,\n    render_maplibregl,\n)\nfrom maplibre.sources import GeoJSONSource\nfrom shiny import App, reactive, render, ui\n\nLAYER_ID = \"earthquakes\"\nCIRCLE_RADIUS = 5\n\napp_ui = ui.page_fluid(\n    #\n    # Render map\n    #\n    ui.panel_title(\"MapLibre\"),\n    output_maplibregl(\"maplibre\", height=600),\n    #\n    # Show coords\n    #\n    ui.div(\"Click on the map to print the coords.\", style=\"padding: 10px;\"),\n    ui.output_text_verbatim(\"coords\", placeholder=True),\n    #\n    # Show props of a feature\n    #\n    ui.div(\"Click on a feature to print its props.\", style=\"padding: 10px;\"),\n    ui.output_text_verbatim(\"props\", placeholder=True),\n    #\n    # Change radius\n    #\n    ui.input_slider(\"radius\", \"Radius\", value=CIRCLE_RADIUS, min=1, max=10),\n)\n\n\ndef server(input, output, session):\n    @render_maplibregl\n    def maplibre():\n        m = Map(zoom=3)\n        m.add_layer(\n            Layer(\n                type=LayerType.CIRCLE,\n                id=LAYER_ID,\n                source=GeoJSONSource(\n                    data=\"https://docs.mapbox.com/mapbox-gl-js/assets/earthquakes.geojson\"\n                ),\n                paint={\"circle-color\": \"yellow\"},\n            )\n        )\n        return m\n\n    @render.text\n    def coords():\n        return str(input.maplibre())\n\n    @render.text\n    def props():\n        return str(input.maplibre_layer_earthquakes())\n\n    @reactive.Effect\n    @reactive.event(input.radius)\n    async def radius():\n        async with MapContext(\"maplibre\") as m:\n            m.set_paint_property(LAYER_ID, \"circle-radius\", input.radius())\n\n\napp = App(app_ui, server)\n</code></pre> <p>Run this example:</p> <pre><code>poetry run uvicorn docs.examples.getting_started.reactivity:app --reload\n</code></pre>"},{"location":"api/basemaps/","title":"Basemaps","text":""},{"location":"api/basemaps/#maplibre.basemaps.Carto","title":"<code>maplibre.basemaps.Carto</code>","text":"<p>             Bases: <code>Enum</code></p> <p>Carto basemap styles</p> <p>Attributes:</p> <ul> <li> <code>DARK_MATTER</code>         \u2013          <p>dark-matter</p> </li> <li> <code>POSITRON</code>         \u2013          <p>positron</p> </li> <li> <code>VOYAGER</code>         \u2013          <p>voyager</p> </li> <li> <code>POSITRON_NOLABELS</code>         \u2013          <p>positron-nolabels</p> </li> <li> <code>DARK_MATTER_NOLABELS</code>         \u2013          <p>dark-matter-nolabels</p> </li> <li> <code>VOYAGER_NOLABELS</code>         \u2013          <p>voyager-nolabels</p> </li> </ul> <p>Examples:</p> <pre><code>&gt;&gt;&gt; from maplibre import Map, MapOptions\n&gt;&gt;&gt; from maplibre.basemaps import Carto\n</code></pre> <pre><code>&gt;&gt;&gt; map = Map(MapOptions(style=Carto.DARK_MATTER))\n</code></pre> Source code in <code>maplibre/basemaps.py</code> <pre><code>class Carto(Enum):\n    \"\"\"Carto basemap styles\n\n    Attributes:\n        DARK_MATTER: dark-matter\n        POSITRON: positron\n        VOYAGER: voyager\n        POSITRON_NOLABELS: positron-nolabels\n        DARK_MATTER_NOLABELS: dark-matter-nolabels\n        VOYAGER_NOLABELS: voyager-nolabels\n\n    Examples:\n        &gt;&gt;&gt; from maplibre import Map, MapOptions\n        &gt;&gt;&gt; from maplibre.basemaps import Carto\n\n        &gt;&gt;&gt; map = Map(MapOptions(style=Carto.DARK_MATTER))\n    \"\"\"\n\n    DARK_MATTER = \"dark-matter\"\n    POSITRON = \"positron\"\n    VOYAGER = \"voyager\"\n    POSITRON_NOLABELS = \"positron-nolabels\"\n    DARK_MATTER_NOLABELS = \"dark-matter-nolabels\"\n    VOYAGER_NOLABELS = \"voyager-nolabels\"\n</code></pre>"},{"location":"api/basemaps/#maplibre.basemaps.construct_basemap_style","title":"<code>maplibre.basemaps.construct_basemap_style(name='nice-style', sources={}, layers=[])</code>","text":"<p>Construct a basemap style</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>The name of the basemap style.</p> <code>'nice-style'</code> <code>sources</code> <code>dict</code> <p>The sources to be used for the basemap style.</p> <code>{}</code> <code>layers</code> <code>list</code> <p>The layers to be used for the basemap style.</p> <code>[]</code> Source code in <code>maplibre/basemaps.py</code> <pre><code>def construct_basemap_style(\n    name: str = \"nice-style\", sources: dict = {}, layers: list = []\n) -&gt; dict:\n    \"\"\"Construct a basemap style\n\n    Args:\n        name (str): The name of the basemap style.\n        sources (dict): The sources to be used for the basemap style.\n        layers (list): The layers to be used for the basemap style.\n    \"\"\"\n    layers = [\n        layer.to_dict() if isinstance(layer, Layer) else layer for layer in layers\n    ]\n    return {\"name\": name, \"version\": 8, \"sources\": sources, \"layers\": layers}\n</code></pre>"},{"location":"api/controls/","title":"Markers and controls","text":""},{"location":"api/controls/#maplibre.controls.Popup","title":"<code>maplibre.controls.Popup</code>","text":"<p>             Bases: <code>BaseModel</code></p> <p>Popup</p> <p>Attributes:</p> Name Type Description <code>text</code> <code>str</code> <p>The Text of the popup.</p> <code>options</code> <code>PopupOptions | dict</code> <p>Popup options.</p> Source code in <code>maplibre/controls.py</code> <pre><code>class Popup(BaseModel):\n    \"\"\"Popup\n\n    Attributes:\n        text: The Text of the popup.\n        options (PopupOptions | dict): Popup options.\n    \"\"\"\n\n    text: str\n    options: Union[PopupOptions, dict] = {}\n</code></pre>"},{"location":"api/controls/#maplibre.controls.PopupOptions","title":"<code>maplibre.controls.PopupOptions</code>","text":"<p>             Bases: <code>BaseModel</code></p> <p>Popup options</p> Source code in <code>maplibre/controls.py</code> <pre><code>class PopupOptions(BaseModel):\n    \"\"\"Popup options\"\"\"\n\n    anchor: str = None\n    close_button: bool = Field(False, serialization_alias=\"closeButton\")\n    close_on_click: bool = Field(None, serialization_alias=\"closeOnClick\")\n    close_on_move: bool = Field(None, serialization_alias=\"closeOnMove\")\n    max_width: int = Field(None, serialization_alias=\"maxWidth\")\n    offset: Union[int, list, dict] = None\n</code></pre>"},{"location":"api/controls/#maplibre.controls.Marker","title":"<code>maplibre.controls.Marker</code>","text":"<p>             Bases: <code>BaseModel</code></p> <p>Marker</p> <p>Attributes:</p> Name Type Description <code>lng_lat</code> <code>tuple | list</code> <p>Required. The longitude and latitude of the marker.</p> <code>popup</code> <code>Popup | dict</code> <p>The Popup that is displayed when a user clicks on the marker.</p> <code>options</code> <code>MarkerOptions | dict</code> <p>Marker options.</p> Source code in <code>maplibre/controls.py</code> <pre><code>class Marker(BaseModel):\n    \"\"\"Marker\n\n    Attributes:\n        lng_lat (tuple |list): **Required.** The longitude and latitude of the marker.\n        popup (Popup | dict): The Popup that is displayed when a user clicks on the marker.\n        options (MarkerOptions | dict): Marker options.\n    \"\"\"\n\n    lng_lat: Union[tuple, list] = Field(None, serialization_alias=\"lngLat\")\n    popup: Union[Popup, dict] = None\n    options: Union[MarkerOptions, dict] = {}\n</code></pre>"},{"location":"api/controls/#maplibre.controls.MarkerOptions","title":"<code>maplibre.controls.MarkerOptions</code>","text":"<p>             Bases: <code>BaseModel</code></p> <p>Marker options</p> Source code in <code>maplibre/controls.py</code> <pre><code>class MarkerOptions(BaseModel):\n    \"\"\"Marker options\"\"\"\n\n    anchor: str = None\n    color: str = None\n    draggable: bool = None\n    offset: Union[tuple, list] = None\n    pitch_alignment: str = Field(None, serialization_alias=\"pitchAlignment\")\n    rotation: int = None\n    rotation_alignment: str = Field(None, serialization_alias=\"rotationAlignment\")\n    scale: int = None\n</code></pre>"},{"location":"api/controls/#maplibre.controls.ControlPosition","title":"<code>maplibre.controls.ControlPosition</code>","text":"<p>             Bases: <code>Enum</code></p> <p>Control position</p> <p>Attributes:</p> <ul> <li> <code>TOP_LEFT</code>         \u2013          <p>top-left</p> </li> <li> <code>TOP_RIGHT</code>         \u2013          <p>top-right</p> </li> <li> <code>BOTTOM_LEFT</code>         \u2013          <p>bottom-left</p> </li> <li> <code>BOTTOM_RIGHT</code>         \u2013          <p>bottom-right</p> </li> </ul> Source code in <code>maplibre/controls.py</code> <pre><code>class ControlPosition(Enum):\n    \"\"\"Control position\n\n    Attributes:\n        TOP_LEFT: top-left\n        TOP_RIGHT: top-right\n        BOTTOM_LEFT: bottom-left\n        BOTTOM_RIGHT: bottom-right\n    \"\"\"\n\n    TOP_LEFT = \"top-left\"\n    TOP_RIGHT = \"top-right\"\n    BOTTOM_LEFT = \"bottom-left\"\n    BOTTOM_RIGHT = \"bottom-right\"\n</code></pre>"},{"location":"api/controls/#maplibre.controls.FullscreenControl","title":"<code>maplibre.controls.FullscreenControl</code>","text":"<p>             Bases: <code>Control</code></p> <p>Fullscreen control</p> <p>Examples:</p> <pre><code>&gt;&gt;&gt; from maplibre import Map\n&gt;&gt;&gt; from maplibre.controls import FullscreenControl, ControlPosition\n</code></pre> <pre><code>&gt;&gt;&gt; map = Map()\n&gt;&gt;&gt; map.add_control(FullscreenControl(), ControlPosition.BOTTOM_LEFT)\n</code></pre> Source code in <code>maplibre/controls.py</code> <pre><code>class FullscreenControl(Control):\n    \"\"\"Fullscreen control\n\n    Examples:\n        &gt;&gt;&gt; from maplibre import Map\n        &gt;&gt;&gt; from maplibre.controls import FullscreenControl, ControlPosition\n\n        &gt;&gt;&gt; map = Map()\n        &gt;&gt;&gt; map.add_control(FullscreenControl(), ControlPosition.BOTTOM_LEFT)\n    \"\"\"\n\n    # _name: str = ControlType.FULLSCREEN.value\n    pass\n</code></pre>"},{"location":"api/controls/#maplibre.controls.ScaleControl","title":"<code>maplibre.controls.ScaleControl</code>","text":"<p>             Bases: <code>Control</code></p> <p>Scale control</p> Source code in <code>maplibre/controls.py</code> <pre><code>class ScaleControl(Control):\n    \"\"\"Scale control\"\"\"\n\n    # _name: str = ControlType.SCALE.value\n    max_width: int = Field(None, serialization_alias=\"maxWidth\")\n    unit: Literal[\"imperial\", \"metric\", \"nautical\"] = \"metric\"\n</code></pre>"},{"location":"api/controls/#maplibre.controls.NavigationControl","title":"<code>maplibre.controls.NavigationControl</code>","text":"<p>             Bases: <code>Control</code></p> <p>Navigation control</p> Source code in <code>maplibre/controls.py</code> <pre><code>class NavigationControl(Control):\n    \"\"\"Navigation control\"\"\"\n\n    # _name: str = ControlType.NAVIGATION.value\n    show_compass: bool = Field(True, serialization_alias=\"showCompass\")\n    show_zoom: bool = Field(True, serialization_alias=\"showZoom\")\n    visualize_pitch: bool = Field(False, serialization_alias=\"visualizePitch\")\n</code></pre>"},{"location":"api/controls/#maplibre.controls.GeolocateControl","title":"<code>maplibre.controls.GeolocateControl</code>","text":"<p>             Bases: <code>Control</code></p> <p>Geolocate control</p> Source code in <code>maplibre/controls.py</code> <pre><code>class GeolocateControl(Control):\n    \"\"\"Geolocate control\"\"\"\n\n    # _name: str = ControlType.GEOLOCATE.value\n    position_options: dict = Field(None, serialization_alias=\"positionOptions\")\n    show_accuracy_circle: bool = Field(True, serialization_alias=\"showAccuracyCircle\")\n    show_user_heading: bool = Field(False, serialization_alias=\"showUserHeading\")\n    show_user_location: bool = Field(True, serialization_alias=\"showUserLocation\")\n    track_user_location: bool = Field(False, serialization_alias=\"trackUserLocation\")\n</code></pre>"},{"location":"api/layer/","title":"Layer","text":""},{"location":"api/layer/#maplibre.Layer","title":"<code>maplibre.Layer</code>","text":"<p>             Bases: <code>BaseModel</code></p> <p>Layer properties</p> Notes <p>See layers for more details on the <code>paint</code> and <code>layout</code> properties of the layers.</p> <p>Attributes:</p> Name Type Description <code>id</code> <code>str</code> <p>Required. The unique ID of the layer. Defaults to <code>str(uuid4())</code>.</p> <code>type</code> <code>str | LayerType</code> <p>Required. The type of the layer.</p> <code>filter</code> <code>list</code> <p>The filter expression that is applied to the source of the layer.</p> <code>layout</code> <code>dict</code> <p>The layout properties of the layer.</p> <code>max_zoom</code> <code>int</code> <p>The maximum zoom level for the layer.</p> <code>min_zoom</code> <code>int</code> <p>The minimum zoom level for the layer.</p> <code>paint</code> <code>dict</code> <p>The paint properties of the layer.</p> <code>source</code> <code>str | Source</code> <p>The name (unique ID) of a source or a source object to be used for the layer.</p> <code>source_layer</code> <code>str</code> <p>The layer to use from a vector tile source.</p> <p>Examples:</p> <pre><code>&gt;&gt;&gt; from maplibre.layer import Layer, LayerType\n</code></pre> <pre><code>&gt;&gt;&gt; layer = Layer(id=\"test-layer\", type=LayerType.CIRCLE, source=\"test-source\")\n</code></pre> Source code in <code>maplibre/layer.py</code> <pre><code>class Layer(BaseModel):\n    \"\"\"Layer properties\n\n    Notes:\n        See [layers](https://maplibre.org/maplibre-style-spec/layers/) for more details on the\n        `paint` and `layout` properties of the layers.\n\n    Attributes:\n        id (str): **Required.** The unique ID of the layer. Defaults to `str(uuid4())`.\n        type (str | LayerType): **Required.** The type of the layer.\n        filter (list): The filter expression that is applied to the source of the layer.\n        layout (dict): The layout properties of the layer.\n        max_zoom (int): The maximum zoom level for the layer.\n        min_zoom (int): The minimum zoom level for the layer.\n        paint (dict): The paint properties of the layer.\n        source (str | Source): The name (unique ID) of a source or a source object to be used for the layer.\n        source_layer (str): The layer to use from a vector tile source.\n\n    Examples:\n        &gt;&gt;&gt; from maplibre.layer import Layer, LayerType\n\n        &gt;&gt;&gt; layer = Layer(id=\"test-layer\", type=LayerType.CIRCLE, source=\"test-source\")\n    \"\"\"\n\n    id: str = Field(default_factory=lambda: str(uuid4()))\n    type: LayerType\n    filter: list = None\n    layout: dict = None\n    max_zoom: int = Field(None, serialization_alias=\"maxzoom\")\n    metadata: dict = None\n    min_zoom: int = Field(None, serialization_alias=\"minzoom\")\n    paint: dict = None\n    source: Union[str, Source, dict, None] = None\n    source_layer: str = Field(None, serialization_alias=\"source-layer\")\n\n    @field_validator(\"source\")\n    def validate_source(cls, v):\n        if isinstance(v, Source):\n            return v.to_dict()\n\n        return v\n\n    @field_validator(\"paint\", \"layout\")\n    def fix_paint(cls, v):\n        if isinstance(v, dict):\n            return fix_keys(v)\n\n        return v\n</code></pre>"},{"location":"api/layer/#maplibre.LayerType","title":"<code>maplibre.LayerType</code>","text":"<p>             Bases: <code>Enum</code></p> <p>Rendering type of layer</p> <p>Attributes:</p> <ul> <li> <code>CIRCLE</code>         \u2013          <p>A filled circle.</p> </li> <li> <code>FILL</code>         \u2013          <p>A filled polygon with an optional stroked border.</p> </li> <li> <code>FILL_EXTRUSION</code>         \u2013          <p>An extruded polygon.</p> </li> <li> <code>LINE</code>         \u2013          <p>A stroked line.</p> </li> <li> <code>SYMBOL</code>         \u2013          <p>An icon or a text label.</p> </li> <li> <code>RASTER</code>         \u2013          <p>Raster map textures such as satellite imagery.</p> </li> <li> <code>HEATMAP</code>         \u2013          <p>A heatmap.</p> </li> <li> <code>HILLSHADE</code>         \u2013          <p>A Client-side hillshading visualization based on DEM data.</p> </li> <li> <code>BACKGROUND</code>         \u2013          <p>A background color or pattern.</p> </li> </ul> Source code in <code>maplibre/layer.py</code> <pre><code>class LayerType(Enum):\n    \"\"\"Rendering type of layer\n\n    Attributes:\n        CIRCLE: A filled circle.\n        FILL: A filled polygon with an optional stroked border.\n        FILL_EXTRUSION: An extruded polygon.\n        LINE: A stroked line.\n        SYMBOL: An icon or a text label.\n        RASTER: Raster map textures such as satellite imagery.\n        HEATMAP: A heatmap.\n        HILLSHADE: A Client-side hillshading visualization based on DEM data.\n        BACKGROUND: A background color or pattern.\n    \"\"\"\n\n    CIRCLE = \"circle\"\n    FILL = \"fill\"\n    FILL_EXTRUSION = \"fill-extrusion\"\n    LINE = \"line\"\n    SYMBOL = \"symbol\"\n    RASTER = \"raster\"\n    HEATMAP = \"heatmap\"\n    HILLSHADE = \"hillshade\"\n    BACKGROUND = \"background\"\n</code></pre>"},{"location":"api/map/","title":"Map","text":""},{"location":"api/map/#maplibre.Map","title":"<code>maplibre.Map</code>","text":"<p>             Bases: <code>object</code></p> <p>Map</p> <p>Parameters:</p> Name Type Description Default <code>map_options</code> <code>MapOptions</code> <p>Map options.</p> <code>MapOptions()</code> <code>**kwargs</code> <p>Keyword arguments that are appended to the <code>MapOptions</code> object.</p> <code>{}</code> <p>Examples:</p> <pre><code>&gt;&gt;&gt; from maplibre.map import Map, MapOptions\n</code></pre> <pre><code>&gt;&gt;&gt; map_options = MapOptions(center=(9.5, 51.31667), zoom=8)\n&gt;&gt;&gt; map = Map(map_options)\n&gt;&gt;&gt; dict(map)\n{'mapOptions': {'center': (9.5, 51.31667), 'style': 'https://basemaps.cartocdn.com/gl/dark-matter-gl-style/style.json', 'zoom': 8}, 'calls': []}\n</code></pre> Source code in <code>maplibre/map.py</code> <pre><code>class Map(object):\n    \"\"\"Map\n\n    Args:\n        map_options (MapOptions): Map options.\n        **kwargs: Keyword arguments that are appended to the `MapOptions` object.\n\n    Examples:\n        &gt;&gt;&gt; from maplibre.map import Map, MapOptions\n\n        &gt;&gt;&gt; map_options = MapOptions(center=(9.5, 51.31667), zoom=8)\n        &gt;&gt;&gt; map = Map(map_options)\n        &gt;&gt;&gt; dict(map)\n        {'mapOptions': {'center': (9.5, 51.31667), 'style': 'https://basemaps.cartocdn.com/gl/dark-matter-gl-style/style.json', 'zoom': 8}, 'calls': []}\n    \"\"\"\n\n    MESSAGE = \"not implemented yet\"\n\n    def __init__(self, map_options: MapOptions = MapOptions(), **kwargs):\n        self.map_options = map_options.to_dict() | kwargs\n        self._message_queue = []\n\n    def __iter__(self):\n        for k, v in self.to_dict().items():\n            yield k, v\n\n    def to_dict(self) -&gt; dict:\n        return {\"mapOptions\": self.map_options, \"calls\": self._message_queue}\n\n    \"\"\"\n    @property\n    def sources(self) -&gt; list:\n        return [item[\"data\"] for item in self._calls if item[\"name\"] == \"addSource\"]\n\n    @property\n    def layers(self) -&gt; list:\n        return [item[\"data\"] for item in self._calls if item[\"name\"] == \"addLayer\"]\n    \"\"\"\n\n    # TODO: Rename to add_map_call\n    def add_call_(self, func_name: str, params: list) -&gt; None:\n        self._message_queue.append(\n            {\"name\": \"applyFunc\", \"data\": {\"funcName\": func_name, \"params\": params}}\n        )\n\n    def add_call(self, method_name: str, *args) -&gt; None:\n        \"\"\"Add a method call that is executed on the map instance\n\n        Args:\n            method_name (str): The name of the map method to be executed.\n            *args (any): The arguments to be passed to the map method.\n        \"\"\"\n        # TODO: Pass as dict? {\"name\": method_name, \"args\": args}\n        call = [method_name, args]\n        self._message_queue.append(call)\n\n    def add_control(\n        self,\n        control: Control,\n        position: [str | ControlPosition] = ControlPosition.TOP_RIGHT,\n    ) -&gt; None:\n        \"\"\"Add a control to the map\n\n        Args:\n            control (Control): The control to be added to the map.\n            position (str | ControlPosition): The position of the control.\n        \"\"\"\n        self.add_call(\n            \"addControl\",\n            control.type,\n            control.to_dict(),\n            ControlPosition(position).value,\n        )\n\n    def add_source(self, id: str, source: [Source | dict]) -&gt; None:\n        \"\"\"Add a source to the map\"\"\"\n        if isinstance(source, Source):\n            source = source.to_dict()\n\n        self.add_call(\"addSource\", id, source)\n\n    def add_layer(self, layer: [Layer | dict]) -&gt; None:\n        \"\"\"Add a layer to the map\n\n        Args:\n            layer (Layer | dict): The Layer to be added to the map.\n        \"\"\"\n        if isinstance(layer, Layer):\n            layer = layer.to_dict()\n\n        self.add_call(\"addLayer\", layer)\n\n    def add_marker(self, marker: Marker) -&gt; None:\n        \"\"\"Add a marker to the map\n\n        Args:\n            marker (Marker): The marker to be added to the map.\n        \"\"\"\n        self.add_call(\"addMarker\", marker.to_dict())\n\n    def add_popup(self, layer_id: str, prop: str = None, template: str = None) -&gt; None:\n        \"\"\"Add a popup to the map\n\n        Args:\n            layer_id (str): The layer to which the popup is added.\n            prop (str): The property of the source to be displayed. If `None`, all properties are displayed.\n            template (str): A mustache template. If supplied, `prop` is ignored.\n        \"\"\"\n        self.add_call(\"addPopup\", layer_id, prop, template)\n\n    def add_tooltip(\n        self, layer_id: str, prop: str = None, template: str = None\n    ) -&gt; None:\n        \"\"\"Add a tooltip to the map\n\n        Args:\n            layer_id (str): The layer to which the tooltip is added.\n            prop (str): The property of the source to be displayed. If `None`, all properties are displayed.\n            template (str): A mustache template. If supplied, `prop` is ignored.\n\n        Examples:\n            &gt;&gt;&gt; map = Map()\n            &gt;&gt;&gt; # ...\n            &gt;&gt;&gt; map.add_tooltip(\"test-layer\", template=\"Name: {{ name }}\")\n        \"\"\"\n        self.add_call(\"addTooltip\", layer_id, prop, template)\n\n    def set_filter(self, layer_id: str, filter_: list):\n        \"\"\"Update the filter of a layer\n\n        Args:\n            layer_id (str): The name of the layer to be updated.\n            filter_ (list): The filter expression that is applied to the source of the layer.\n        \"\"\"\n        self.add_call(\"setFilter\", layer_id, filter_)\n\n    def set_paint_property(self, layer_id: str, prop: str, value: any) -&gt; None:\n        \"\"\"Update the paint property of a layer\n\n        Args:\n            layer_id (str): The name of the layer to be updated.\n            prop (str): The name of the paint property to be updated.\n            value (any): The new value of the paint property.\n        \"\"\"\n        self.add_call(\"setPaintProperty\", layer_id, prop, value)\n\n    def set_layout_property(self, layer_id: str, prop: str, value: any) -&gt; None:\n        \"\"\"Update a layout property of a layer\n\n        Args:\n            layer_id (str): The name of the layer to be updated.\n            prop (str): The name of the layout property to be updated.\n            value (any): The new value of the layout property.\n        \"\"\"\n        self.add_call(\"setLayoutProperty\", layer_id, prop, value)\n\n    def set_data(self, source_id: str, data: dict) -&gt; None:\n        \"\"\"Update the data of a GeoJSON source\n\n        Args:\n            source_id (str): The name of the source to be updated.\n            data (dict): The data of the source.\n        \"\"\"\n        self.add_call(\"setSourceData\", source_id, data)\n\n    def set_visibility(self, layer_id: str, visible: bool = True) -&gt; None:\n        \"\"\"Update the visibility of a layer\n\n        Args:\n            layer_id (str): The name of the layer to be updated.\n            visible (bool): Whether the layer is visible or not.\n        \"\"\"\n        value = \"visible\" if visible else \"none\"\n        self.add_call(\"setLayoutProperty\", layer_id, \"visibility\", value)\n\n    def to_html(self, **kwargs) -&gt; str:\n        \"\"\"Render to html\n\n        Args:\n            **kwargs (Any): Additional keyword arguments that are passed to the template.\n                Currently, `style` is the only supported keyword argument.\n\n        Examples:\n            &gt;&gt;&gt; from maplibre import Map\n\n            &gt;&gt;&gt; map = Map()\n            &gt;&gt;&gt; with open(\"/tmp/map.html\", \"w\") as f:\n            ...     f.write(map.to_html(style=\"height: 800px;\") # doctest: +SKIP\n        \"\"\"\n        js_lib = read_internal_file(\"srcjs\", \"index.js\")\n        js_snippet = Template(js_template).render(data=json.dumps(self.to_dict()))\n        output = Template(html_template).render(\n            js=\"\\n\".join([js_lib, js_snippet]), **kwargs\n        )\n        return output\n</code></pre>"},{"location":"api/map/#maplibre.Map.add_call","title":"<code>add_call(method_name, *args)</code>","text":"<p>Add a method call that is executed on the map instance</p> <p>Parameters:</p> Name Type Description Default <code>method_name</code> <code>str</code> <p>The name of the map method to be executed.</p> required <code>*args</code> <code>any</code> <p>The arguments to be passed to the map method.</p> <code>()</code> Source code in <code>maplibre/map.py</code> <pre><code>def add_call(self, method_name: str, *args) -&gt; None:\n    \"\"\"Add a method call that is executed on the map instance\n\n    Args:\n        method_name (str): The name of the map method to be executed.\n        *args (any): The arguments to be passed to the map method.\n    \"\"\"\n    # TODO: Pass as dict? {\"name\": method_name, \"args\": args}\n    call = [method_name, args]\n    self._message_queue.append(call)\n</code></pre>"},{"location":"api/map/#maplibre.Map.add_control","title":"<code>add_control(control, position=ControlPosition.TOP_RIGHT)</code>","text":"<p>Add a control to the map</p> <p>Parameters:</p> Name Type Description Default <code>control</code> <code>Control</code> <p>The control to be added to the map.</p> required <code>position</code> <code>str | ControlPosition</code> <p>The position of the control.</p> <code>TOP_RIGHT</code> Source code in <code>maplibre/map.py</code> <pre><code>def add_control(\n    self,\n    control: Control,\n    position: [str | ControlPosition] = ControlPosition.TOP_RIGHT,\n) -&gt; None:\n    \"\"\"Add a control to the map\n\n    Args:\n        control (Control): The control to be added to the map.\n        position (str | ControlPosition): The position of the control.\n    \"\"\"\n    self.add_call(\n        \"addControl\",\n        control.type,\n        control.to_dict(),\n        ControlPosition(position).value,\n    )\n</code></pre>"},{"location":"api/map/#maplibre.Map.add_layer","title":"<code>add_layer(layer)</code>","text":"<p>Add a layer to the map</p> <p>Parameters:</p> Name Type Description Default <code>layer</code> <code>Layer | dict</code> <p>The Layer to be added to the map.</p> required Source code in <code>maplibre/map.py</code> <pre><code>def add_layer(self, layer: [Layer | dict]) -&gt; None:\n    \"\"\"Add a layer to the map\n\n    Args:\n        layer (Layer | dict): The Layer to be added to the map.\n    \"\"\"\n    if isinstance(layer, Layer):\n        layer = layer.to_dict()\n\n    self.add_call(\"addLayer\", layer)\n</code></pre>"},{"location":"api/map/#maplibre.Map.add_marker","title":"<code>add_marker(marker)</code>","text":"<p>Add a marker to the map</p> <p>Parameters:</p> Name Type Description Default <code>marker</code> <code>Marker</code> <p>The marker to be added to the map.</p> required Source code in <code>maplibre/map.py</code> <pre><code>def add_marker(self, marker: Marker) -&gt; None:\n    \"\"\"Add a marker to the map\n\n    Args:\n        marker (Marker): The marker to be added to the map.\n    \"\"\"\n    self.add_call(\"addMarker\", marker.to_dict())\n</code></pre>"},{"location":"api/map/#maplibre.Map.add_popup","title":"<code>add_popup(layer_id, prop=None, template=None)</code>","text":"<p>Add a popup to the map</p> <p>Parameters:</p> Name Type Description Default <code>layer_id</code> <code>str</code> <p>The layer to which the popup is added.</p> required <code>prop</code> <code>str</code> <p>The property of the source to be displayed. If <code>None</code>, all properties are displayed.</p> <code>None</code> <code>template</code> <code>str</code> <p>A mustache template. If supplied, <code>prop</code> is ignored.</p> <code>None</code> Source code in <code>maplibre/map.py</code> <pre><code>def add_popup(self, layer_id: str, prop: str = None, template: str = None) -&gt; None:\n    \"\"\"Add a popup to the map\n\n    Args:\n        layer_id (str): The layer to which the popup is added.\n        prop (str): The property of the source to be displayed. If `None`, all properties are displayed.\n        template (str): A mustache template. If supplied, `prop` is ignored.\n    \"\"\"\n    self.add_call(\"addPopup\", layer_id, prop, template)\n</code></pre>"},{"location":"api/map/#maplibre.Map.add_source","title":"<code>add_source(id, source)</code>","text":"<p>Add a source to the map</p> Source code in <code>maplibre/map.py</code> <pre><code>def add_source(self, id: str, source: [Source | dict]) -&gt; None:\n    \"\"\"Add a source to the map\"\"\"\n    if isinstance(source, Source):\n        source = source.to_dict()\n\n    self.add_call(\"addSource\", id, source)\n</code></pre>"},{"location":"api/map/#maplibre.Map.add_tooltip","title":"<code>add_tooltip(layer_id, prop=None, template=None)</code>","text":"<p>Add a tooltip to the map</p> <p>Parameters:</p> Name Type Description Default <code>layer_id</code> <code>str</code> <p>The layer to which the tooltip is added.</p> required <code>prop</code> <code>str</code> <p>The property of the source to be displayed. If <code>None</code>, all properties are displayed.</p> <code>None</code> <code>template</code> <code>str</code> <p>A mustache template. If supplied, <code>prop</code> is ignored.</p> <code>None</code> <p>Examples:</p> <pre><code>&gt;&gt;&gt; map = Map()\n&gt;&gt;&gt; # ...\n&gt;&gt;&gt; map.add_tooltip(\"test-layer\", template=\"Name: {{ name }}\")\n</code></pre> Source code in <code>maplibre/map.py</code> <pre><code>def add_tooltip(\n    self, layer_id: str, prop: str = None, template: str = None\n) -&gt; None:\n    \"\"\"Add a tooltip to the map\n\n    Args:\n        layer_id (str): The layer to which the tooltip is added.\n        prop (str): The property of the source to be displayed. If `None`, all properties are displayed.\n        template (str): A mustache template. If supplied, `prop` is ignored.\n\n    Examples:\n        &gt;&gt;&gt; map = Map()\n        &gt;&gt;&gt; # ...\n        &gt;&gt;&gt; map.add_tooltip(\"test-layer\", template=\"Name: {{ name }}\")\n    \"\"\"\n    self.add_call(\"addTooltip\", layer_id, prop, template)\n</code></pre>"},{"location":"api/map/#maplibre.Map.set_data","title":"<code>set_data(source_id, data)</code>","text":"<p>Update the data of a GeoJSON source</p> <p>Parameters:</p> Name Type Description Default <code>source_id</code> <code>str</code> <p>The name of the source to be updated.</p> required <code>data</code> <code>dict</code> <p>The data of the source.</p> required Source code in <code>maplibre/map.py</code> <pre><code>def set_data(self, source_id: str, data: dict) -&gt; None:\n    \"\"\"Update the data of a GeoJSON source\n\n    Args:\n        source_id (str): The name of the source to be updated.\n        data (dict): The data of the source.\n    \"\"\"\n    self.add_call(\"setSourceData\", source_id, data)\n</code></pre>"},{"location":"api/map/#maplibre.Map.set_filter","title":"<code>set_filter(layer_id, filter_)</code>","text":"<p>Update the filter of a layer</p> <p>Parameters:</p> Name Type Description Default <code>layer_id</code> <code>str</code> <p>The name of the layer to be updated.</p> required <code>filter_</code> <code>list</code> <p>The filter expression that is applied to the source of the layer.</p> required Source code in <code>maplibre/map.py</code> <pre><code>def set_filter(self, layer_id: str, filter_: list):\n    \"\"\"Update the filter of a layer\n\n    Args:\n        layer_id (str): The name of the layer to be updated.\n        filter_ (list): The filter expression that is applied to the source of the layer.\n    \"\"\"\n    self.add_call(\"setFilter\", layer_id, filter_)\n</code></pre>"},{"location":"api/map/#maplibre.Map.set_layout_property","title":"<code>set_layout_property(layer_id, prop, value)</code>","text":"<p>Update a layout property of a layer</p> <p>Parameters:</p> Name Type Description Default <code>layer_id</code> <code>str</code> <p>The name of the layer to be updated.</p> required <code>prop</code> <code>str</code> <p>The name of the layout property to be updated.</p> required <code>value</code> <code>any</code> <p>The new value of the layout property.</p> required Source code in <code>maplibre/map.py</code> <pre><code>def set_layout_property(self, layer_id: str, prop: str, value: any) -&gt; None:\n    \"\"\"Update a layout property of a layer\n\n    Args:\n        layer_id (str): The name of the layer to be updated.\n        prop (str): The name of the layout property to be updated.\n        value (any): The new value of the layout property.\n    \"\"\"\n    self.add_call(\"setLayoutProperty\", layer_id, prop, value)\n</code></pre>"},{"location":"api/map/#maplibre.Map.set_paint_property","title":"<code>set_paint_property(layer_id, prop, value)</code>","text":"<p>Update the paint property of a layer</p> <p>Parameters:</p> Name Type Description Default <code>layer_id</code> <code>str</code> <p>The name of the layer to be updated.</p> required <code>prop</code> <code>str</code> <p>The name of the paint property to be updated.</p> required <code>value</code> <code>any</code> <p>The new value of the paint property.</p> required Source code in <code>maplibre/map.py</code> <pre><code>def set_paint_property(self, layer_id: str, prop: str, value: any) -&gt; None:\n    \"\"\"Update the paint property of a layer\n\n    Args:\n        layer_id (str): The name of the layer to be updated.\n        prop (str): The name of the paint property to be updated.\n        value (any): The new value of the paint property.\n    \"\"\"\n    self.add_call(\"setPaintProperty\", layer_id, prop, value)\n</code></pre>"},{"location":"api/map/#maplibre.Map.set_visibility","title":"<code>set_visibility(layer_id, visible=True)</code>","text":"<p>Update the visibility of a layer</p> <p>Parameters:</p> Name Type Description Default <code>layer_id</code> <code>str</code> <p>The name of the layer to be updated.</p> required <code>visible</code> <code>bool</code> <p>Whether the layer is visible or not.</p> <code>True</code> Source code in <code>maplibre/map.py</code> <pre><code>def set_visibility(self, layer_id: str, visible: bool = True) -&gt; None:\n    \"\"\"Update the visibility of a layer\n\n    Args:\n        layer_id (str): The name of the layer to be updated.\n        visible (bool): Whether the layer is visible or not.\n    \"\"\"\n    value = \"visible\" if visible else \"none\"\n    self.add_call(\"setLayoutProperty\", layer_id, \"visibility\", value)\n</code></pre>"},{"location":"api/map/#maplibre.Map.to_html","title":"<code>to_html(**kwargs)</code>","text":"<p>Render to html</p> <p>Parameters:</p> Name Type Description Default <code>**kwargs</code> <code>Any</code> <p>Additional keyword arguments that are passed to the template. Currently, <code>style</code> is the only supported keyword argument.</p> <code>{}</code> <p>Examples:</p> <pre><code>&gt;&gt;&gt; from maplibre import Map\n</code></pre> <pre><code>&gt;&gt;&gt; map = Map()\n&gt;&gt;&gt; with open(\"/tmp/map.html\", \"w\") as f:\n...     f.write(map.to_html(style=\"height: 800px;\")\n</code></pre> Source code in <code>maplibre/map.py</code> <pre><code>def to_html(self, **kwargs) -&gt; str:\n    \"\"\"Render to html\n\n    Args:\n        **kwargs (Any): Additional keyword arguments that are passed to the template.\n            Currently, `style` is the only supported keyword argument.\n\n    Examples:\n        &gt;&gt;&gt; from maplibre import Map\n\n        &gt;&gt;&gt; map = Map()\n        &gt;&gt;&gt; with open(\"/tmp/map.html\", \"w\") as f:\n        ...     f.write(map.to_html(style=\"height: 800px;\") # doctest: +SKIP\n    \"\"\"\n    js_lib = read_internal_file(\"srcjs\", \"index.js\")\n    js_snippet = Template(js_template).render(data=json.dumps(self.to_dict()))\n    output = Template(html_template).render(\n        js=\"\\n\".join([js_lib, js_snippet]), **kwargs\n    )\n    return output\n</code></pre>"},{"location":"api/map/#maplibre.MapOptions","title":"<code>maplibre.MapOptions</code>","text":"<p>             Bases: <code>BaseModel</code></p> <p>Map options</p> Note <p>See MapOptions for more details.</p> Source code in <code>maplibre/map.py</code> <pre><code>class MapOptions(BaseModel):\n    \"\"\"Map options\n\n    Note:\n        See [MapOptions](https://maplibre.org/maplibre-gl-js/docs/API/types/MapOptions/) for more details.\n    \"\"\"\n\n    model_config = ConfigDict(\n        validate_assignment=True, extra=\"forbid\", use_enum_values=False\n    )\n    antialias: bool = None\n    attribution_control: bool = Field(None, serialization_alias=\"attributionControl\")\n    bearing: int = None\n    bearing_snap: int = Field(None, serialization_alias=\"bearingSnap\")\n    bounds: tuple = None\n    box_zoom: bool = Field(None, serialization_alias=\"boxZoom\")\n    center: tuple = None\n    click_tolerance: int = Field(None, serialization_alias=\"clickTolerance\")\n    custom_attribution: bool = Field(None, serialization_alias=\"customAttribution\")\n    double_click_zoom: bool = Field(None, serialization_alias=\"doubleClickZoom\")\n    fade_duration: int = Field(None, serialization_alias=\"fadeDuration\")\n    fit_bounds_options: dict = Field(None, serialization_alias=\"fitBoundsOptions\")\n    hash: Union[bool, str] = None\n    interactive: bool = None\n    keyword: bool = None\n    max_bounds: tuple = Field(None, serialization_alias=\"maxBounds\")\n    max_pitch: int = Field(None, serialization_alias=\"maxPitch\")\n    max_zoom: int = Field(None, serialization_alias=\"maxZoom\")\n    min_pitch: int = Field(None, serialization_alias=\"minPitch\")\n    min_zoom: int = Field(None, serialization_alias=\"minZoom\")\n    pitch: int = None\n    scroll_zoom: bool = Field(None, serialization_alias=\"scrollZoom\")\n    style: Union[str, Carto, dict] = construct_carto_basemap_url(Carto.DARK_MATTER)\n    zoom: int = None\n\n    @field_validator(\"style\")\n    def validate_style(cls, v):\n        if isinstance(v, Carto):\n            return construct_carto_basemap_url(v)\n\n        return v\n</code></pre>"},{"location":"api/map/#maplibre.MapContext","title":"<code>maplibre.MapContext</code>","text":"<p>             Bases: <code>Map</code></p> <p>MapContext</p> <p>Use this class to update a <code>Map</code> instance in a Shiny app. Must be used inside an async function.</p> <p>See <code>maplibre.Map</code> for available methods.</p> <p>Parameters:</p> Name Type Description Default <code>id</code> <code>string</code> <p>The id of the map to be updated.</p> required <code>session</code> <code>Session</code> <p>A Shiny session. If <code>None</code>, the active session is used.</p> <code>None</code> Source code in <code>maplibre/mapcontext.py</code> <pre><code>class MapContext(Map):\n    \"\"\"MapContext\n\n    Use this class to update a `Map` instance in a Shiny app.\n    Must be used inside an async function.\n\n    See `maplibre.Map` for available methods.\n\n    Args:\n        id (string): The id of the map to be updated.\n        session (Session): A Shiny session.\n            If `None`, the active session is used.\n    \"\"\"\n\n    def __init__(self, id: str, session: Session = None) -&gt; None:\n        self.id = id\n        self._session = require_active_session(session)\n        self.map_options = {}\n        self._message_queue = []\n\n    async def __aenter__(self):\n        return self\n\n    async def __aexit__(self, exc_type, exc_val, exc_tb):\n        await self.render()\n\n    async def render(self):\n        await self._session.send_custom_message(\n            f\"pymaplibregl-{self.id}\", {\"id\": self.id, \"calls\": self._message_queue}\n        )\n</code></pre>"},{"location":"api/map/#maplibre.ipywidget.MapWidget","title":"<code>maplibre.ipywidget.MapWidget</code>","text":"<p>             Bases: <code>AnyWidget</code>, <code>Map</code></p> <p>MapWidget</p> <p>Use this class to display and update maps in Jupyter Notebooks.</p> <p>See <code>maplibre.Map</code> for available methods.</p> <p>Examples:</p> <pre><code>&gt;&gt;&gt; from maplibre import MapOptions\n&gt;&gt;&gt; from maplibre.ipywidget import MapWidget as Map\n&gt;&gt;&gt; m = Map(MapOptions(center=(-123.13, 49.254), zoom=11, pitch=45))\n&gt;&gt;&gt; m\n</code></pre> Source code in <code>maplibre/ipywidget.py</code> <pre><code>class MapWidget(AnyWidget, Map):\n    \"\"\"MapWidget\n\n    Use this class to display and update maps in Jupyter Notebooks.\n\n    See `maplibre.Map` for available methods.\n\n    Examples:\n        &gt;&gt;&gt; from maplibre import MapOptions\n        &gt;&gt;&gt; from maplibre.ipywidget import MapWidget as Map\n        &gt;&gt;&gt; m = Map(MapOptions(center=(-123.13, 49.254), zoom=11, pitch=45))\n        &gt;&gt;&gt; m # doctest: +SKIP\n    \"\"\"\n\n    _esm = join(Path(__file__).parent, \"srcjs\", \"ipywidget.js\")\n    _css = join(Path(__file__).parent, \"srcjs\", \"maplibre-gl.css\")\n    _use_message_queue = False\n    _rendered = traitlets.Bool(False, config=True).tag(sync=True)\n    map_options = traitlets.Dict().tag(sync=True)\n    calls = traitlets.List().tag(sync=True)\n    height = traitlets.Union([traitlets.Int(), traitlets.Unicode()]).tag(sync=True)\n    lng_lat = traitlets.Dict().tag(sync=True)\n\n    def __init__(self, map_options=MapOptions(), **kwargs) -&gt; None:\n        self.calls = []\n        AnyWidget.__init__(self, **kwargs)\n        Map.__init__(self, map_options, **kwargs)\n\n    @traitlets.default(\"height\")\n    def _default_height(self):\n        return \"400px\"\n\n    @traitlets.validate(\"height\")\n    def _validate_height(self, proposal):\n        height = proposal[\"value\"]\n        if isinstance(height, int):\n            return f\"{height}px\"\n\n        return height\n\n    @traitlets.observe(\"_rendered\")\n    def _on_rendered(self, change):\n        self.send({\"calls\": self._message_queue, \"msg\": \"init\"})\n        self._message_queue = []\n\n    def use_message_queue(self, value: bool = True) -&gt; None:\n        self._use_message_queue = value\n\n    def add_call(self, method_name: str, *args) -&gt; None:\n        call = [method_name, args]\n        if not self._rendered:\n            if not self._use_message_queue:\n                self.calls = self.calls + [call]\n                return\n\n            self._message_queue.append(call)\n            return\n\n        self.send({\"calls\": [call], \"msg\": \"custom call\"})\n</code></pre>"},{"location":"api/sources/","title":"Sources","text":""},{"location":"api/sources/#maplibre.sources","title":"<code>maplibre.sources</code>","text":""},{"location":"api/sources/#maplibre.sources.GeoJSONSource","title":"<code>GeoJSONSource</code>","text":"<p>             Bases: <code>Source</code></p> <p>GeoJSON Source</p> <p>Examples:</p> <pre><code>&gt;&gt;&gt; from maplibre.sources import GeoJSONSource\n</code></pre> <pre><code>&gt;&gt;&gt; source = GeoJSONSource(data=\"https://docs.mapbox.com/mapbox-gl-js/assets/earthquakes.geojson\")\n</code></pre> Source code in <code>maplibre/sources.py</code> <pre><code>class GeoJSONSource(Source):\n    \"\"\"GeoJSON Source\n\n    Examples:\n        &gt;&gt;&gt; from maplibre.sources import GeoJSONSource\n\n        &gt;&gt;&gt; source = GeoJSONSource(data=\"https://docs.mapbox.com/mapbox-gl-js/assets/earthquakes.geojson\")\n    \"\"\"\n\n    data: Union[str, dict]\n    attribution: str = None\n    buffer: int = None\n    cluster: bool = None\n    cluster_max_zoom: int = Field(None, serialization_alias=\"clusterMaxZoom\")\n    cluster_min_points: int = Field(None, serialization_alias=\"clusterMinPoints\")\n    cluster_properties: dict = Field(None, serialization_alias=\"clusterProperties\")\n    cluster_radius: int = Field(None, serialization_alias=\"clusterRadius\")\n    filter: list = None\n    generate_id: bool = Field(None, serialization_alias=\"generateId\")\n    line_metrics: bool = Field(None, serialization_alias=\"lineMetrics\")\n    maxzoom: int = None\n    promote_id: Union[str, dict] = Field(None, serialization_alias=\"promoteId\")\n    tolerance: float = None\n\n    @computed_field\n    @property\n    def type(self) -&gt; str:\n        return SourceType.GEOJSON.value\n</code></pre>"},{"location":"api/sources/#maplibre.sources.RasterTileSource","title":"<code>RasterTileSource</code>","text":"<p>             Bases: <code>Source</code></p> <p>Raster tile source</p> <p>Examples:</p> <pre><code>&gt;&gt;&gt; from maplibre.sources import RasterTileSource\n&gt;&gt;&gt; raster_source = RasterTileSource(\n...     tiles=[\"https://tile.openstreetmap.org/{z}/{x}/{y}.png\"],\n...     tile_size=256,\n...     min_zoom=0,\n...     max_zoom=19,\n... )\n</code></pre> Source code in <code>maplibre/sources.py</code> <pre><code>class RasterTileSource(Source):\n    \"\"\"Raster tile source\n\n    Examples:\n        &gt;&gt;&gt; from maplibre.sources import RasterTileSource\n        &gt;&gt;&gt; raster_source = RasterTileSource(\n        ...     tiles=[\"https://tile.openstreetmap.org/{z}/{x}/{y}.png\"],\n        ...     tile_size=256,\n        ...     min_zoom=0,\n        ...     max_zoom=19,\n        ... )\n    \"\"\"\n\n    attribution: str = None\n    bounds: tuple = None\n    max_zoom: int = Field(None, serialization_alias=\"maxzoom\")\n    min_zoom: int = Field(None, serialization_alias=\"minzoom\")\n    scheme: str = None\n    tile_size: int = Field(None, serialization_alias=\"tileSize\")\n    tiles: Union[tuple, list] = None\n    url: str = None\n    volatile: bool = None\n\n    @computed_field\n    @property\n    def type(self) -&gt; str:\n        return SourceType.RASTER.value\n</code></pre>"},{"location":"api/sources/#maplibre.sources.SourceType","title":"<code>SourceType</code>","text":"<p>             Bases: <code>Enum</code></p> <p>Source types</p> Source code in <code>maplibre/sources.py</code> <pre><code>class SourceType(Enum):\n    \"\"\"Source types\"\"\"\n\n    RASTER = \"raster\"\n    VECTOR = \"vector\"\n    RASTER_DEM = \"raster-dem\"\n    GEOJSON = \"geojson\"\n    IMAGE = \"image\"\n    VIDEO = \"video\"\n</code></pre>"},{"location":"examples/3d_indoor_mapping/","title":"3D Indoor mapping","text":"<pre><code>import sys\nimport webbrowser\n\nfrom maplibre import Layer, LayerType, Map, MapOptions\nfrom maplibre.basemaps import background\nfrom maplibre.sources import GeoJSONSource, RasterTileSource\n\nfile_name = \"/tmp/pymaplibregl_temp.html\"\n\nFLOORPLAN_SOURCE_ID = \"floorplan\"\n\nraster_source = RasterTileSource(\n    tiles=[\"https://tile.openstreetmap.org/{z}/{x}/{y}.png\"],\n    tile_size=256,\n    min_zoom=0,\n    max_zoom=19,\n)\n\nraster_layer = Layer(type=LayerType.RASTER, source=raster_source)\n\nfloorplan_source = GeoJSONSource(\n    data=\"https://maplibre.org/maplibre-gl-js/docs/assets/indoor-3d-map.geojson\"\n)\n\nfloorplan_layer = Layer(\n    type=LayerType.FILL_EXTRUSION,\n    id=\"floorplan\",\n    source=FLOORPLAN_SOURCE_ID,\n    paint={\n        \"fill-extrusion-color\": [\"get\", \"color\"],\n        \"fill-extrusion-height\": [\"get\", \"height\"],\n        \"fill-extrusion-base\": [\"get\", \"base_height\"],\n        \"fill-extrusion-opacity\": 0.5,\n    },\n)\n\nmap_options = MapOptions(\n    style=background(\"yellow\"),\n    center=(-87.61694, 41.86625),\n    zoom=17,\n    pitch=40,\n    bearing=20,\n    antialias=True,\n)\n\n\ndef create_map():\n    m = Map(map_options)\n    m.add_layer(raster_layer)\n    m.add_source(FLOORPLAN_SOURCE_ID, floorplan_source)\n    m.add_layer(floorplan_layer)\n    return m\n\n\nif __name__ == \"__main__\":\n    m = create_map()\n    if len(sys.argv) == 2:\n        file_name = sys.argv[1]\n\n    with open(file_name, \"w\") as f:\n        f.write(m.to_html())\n\n    webbrowser.open(file_name)\n</code></pre> <p>Run example:</p> <pre><code>poetry run python docs/examples/3d_indoor_mapping/app.py\n</code></pre>"},{"location":"examples/airports/","title":"Airport markers","text":"<pre><code>import sys\n\nimport pandas as pd\nfrom maplibre import (\n    Layer,\n    LayerType,\n    Map,\n    MapOptions,\n    output_maplibregl,\n    render_maplibregl,\n)\nfrom maplibre.basemaps import Carto\nfrom maplibre.controls import Marker, MarkerOptions, Popup, PopupOptions\nfrom maplibre.sources import GeoJSONSource\nfrom maplibre.utils import GeometryType, df_to_geojson\nfrom shiny import App, ui\n\nBOUNDS = (-8.92242886, 43.30508298, 13.76496714, 59.87668996)\n\nairports_data = pd.read_json(\n    \"https://github.com/visgl/deck.gl-data/raw/master/examples/line/airports.json\"\n)\n\n\ndef get_color(airport_type: str) -&gt; str:\n    color = \"darkblue\"\n    if airport_type == \"mid\":\n        color = \"darkred\"\n    elif airport_type == \"major\":\n        color = \"darkgreen\"\n\n    return color\n\n\ngeojson = df_to_geojson(\n    airports_data,\n    \"coordinates\",\n    GeometryType.POINT,\n    properties=[\"type\", \"name\", \"abbrev\"],\n)\n\nairport_circles = Layer(\n    type=LayerType.CIRCLE,\n    source=GeoJSONSource(data=geojson),\n    paint={\n        \"circle-color\": [\n            \"match\",\n            [\"get\", \"type\"],\n            \"mid\",\n            \"darkred\",\n            \"major\",\n            \"darkgreen\",\n            \"darkblue\",\n        ],\n        \"circle_radius\": 10,\n        \"circle-opacity\": 0.3,\n    },\n)\n\nmap_options = MapOptions(\n    style=Carto.POSITRON,\n    bounds=BOUNDS,\n    fit_bounds_options={\"padding\": 20},\n    hash=True,\n)\n\npopup_options = PopupOptions(close_button=False)\n\n\ndef create_map() -&gt; Map:\n    m = Map(map_options)\n    m.add_layer(airport_circles)\n    for _, r in airports_data.iterrows():\n        marker = Marker(\n            lng_lat=r[\"coordinates\"],\n            options=MarkerOptions(color=get_color(r[\"type\"])),\n            popup=Popup(\n                text=r[\"name\"],\n                options=popup_options,\n            ),\n        )\n        m.add_marker(marker)\n    return m\n\n\napp_ui = ui.page_fluid(\n    ui.panel_title(\"Airports\"),\n    output_maplibregl(\"maplibre\", height=600),\n)\n\n\ndef server(input, output, session):\n    @render_maplibregl\n    def maplibre():\n        return create_map()\n\n\napp = App(app_ui, server)\n\nif __name__ == \"__main__\":\n    if len(sys.argv) == 2:\n        with open(sys.argv[1], \"w\") as f:\n            f.write(create_map().to_html())\n    else:\n        app.run()\n</code></pre> <p>Run example:</p> <pre><code>poetry run uvicorn docs.examples.airports.app:app --reload\n</code></pre>"},{"location":"examples/custom_basemap/","title":"Custom basemap","text":"<pre><code>import sys\nimport webbrowser\n\nfrom maplibre import Layer, LayerType, Map, MapOptions\nfrom maplibre.basemaps import construct_basemap_style\nfrom maplibre.sources import GeoJSONSource\n\nfile_name = \"/tmp/pymaplibregl_temp.html\"\n\nbg_layer = Layer(\n    type=LayerType.BACKGROUND,\n    id=\"background\",\n    source=None,\n    paint={\"background-color\": \"darkblue\", \"background-opacity\": 0.8},\n)\n\ncountries_source = GeoJSONSource(\n    data=\"https://d2ad6b4ur7yvpq.cloudfront.net/naturalearth-3.3.0/ne_110m_admin_0_countries.geojson\"\n)\n\nlines_layer = Layer(\n    type=LayerType.LINE,\n    source=\"countries\",\n    paint={\"line-color\": \"white\", \"line-width\": 1.5},\n)\n\npolygons_layer = Layer(\n    type=LayerType.FILL,\n    source=\"countries\",\n    paint={\"fill-color\": \"darkred\", \"fill-opacity\": 0.8},\n)\n\ncustom_basemap = construct_basemap_style(\n    layers=[bg_layer, polygons_layer, lines_layer],\n    sources={\"countries\": countries_source},\n)\n\n\nmap_options = MapOptions(\n    style=custom_basemap,\n    center=(0, 0),\n    zoom=2,\n)\n\n\ndef create_map():\n    m = Map(map_options)\n    m.add_layer(\n        Layer(\n            type=LayerType.CIRCLE,\n            id=\"earthquakes\",\n            source=GeoJSONSource(\n                data=\"https://docs.mapbox.com/mapbox-gl-js/assets/earthquakes.geojson\"\n            ),\n            paint={\"circle-color\": \"yellow\", \"circle-radius\": 5},\n        )\n    )\n    m.add_popup(\"earthquakes\", \"mag\")\n    return m\n\n\nif __name__ == \"__main__\":\n    m = create_map()\n    if len(sys.argv) == 2:\n        file_name = sys.argv[1]\n\n    with open(file_name, \"w\") as f:\n        f.write(m.to_html())\n\n    webbrowser.open(file_name)\n</code></pre> <p>Run example:</p> <pre><code>poetry run python docs/examples/custom_basemap/app.py\n</code></pre>"},{"location":"examples/earthquake_clusters/","title":"Earthquake clusters","text":"<pre><code>import sys\n\nfrom maplibre import (\n    Layer,\n    LayerType,\n    Map,\n    MapOptions,\n    output_maplibregl,\n    render_maplibregl,\n)\nfrom maplibre.basemaps import Carto\nfrom maplibre.sources import GeoJSONSource\nfrom shiny import App, reactive, ui\n\nEARTHQUAKE_SOURCE = \"earthquakes\"\nEARTHQUAKE_CIRCLES = \"earthquake-circles\"\nEARTHQUAKE_CLUSTERS = \"earthquake-clusters\"\nEARTHQUAKE_LABELS = \"earthquake-labels\"\n\nCENTER = (-118.0931, 33.78615)\n\nearthquakes_source = GeoJSONSource(\n    data=\"https://docs.mapbox.com/mapbox-gl-js/assets/earthquakes.geojson\",\n    cluster=True,\n    cluster_radius=50,\n    cluster_min_points=2,\n    cluster_max_zoom=14,\n    cluster_properties={\n        \"maxMag\": [\"max\", [\"get\", \"mag\"]],\n        \"minMag\": [\"min\", [\"get\", \"mag\"]],\n    },\n)\n\nearthquake_circles = Layer(\n    type=LayerType.CIRCLE,\n    id=EARTHQUAKE_CIRCLES,\n    source=EARTHQUAKE_SOURCE,\n    paint={\"circle-color\": \"darkblue\"},\n    filter=[\"!\", [\"has\", \"point_count\"]],\n)\n\nearthquake_clusters = Layer(\n    type=LayerType.CIRCLE,\n    id=EARTHQUAKE_CLUSTERS,\n    source=EARTHQUAKE_SOURCE,\n    filter=[\"has\", \"point_count\"],\n    paint={\n        \"circle-color\": [\n            \"step\",\n            [\"get\", \"point_count\"],\n            \"#51bbd6\",\n            100,\n            \"#f1f075\",\n            750,\n            \"#f28cb1\",\n        ],\n        \"circle-radius\": [\"step\", [\"get\", \"point_count\"], 20, 100, 30, 750, 40],\n    },\n)\n\nearthquake_labels = Layer(\n    type=LayerType.SYMBOL,\n    id=\"text\",\n    source=EARTHQUAKE_SOURCE,\n    filter=[\"has\", \"point_count\"],\n    layout={\n        \"text-field\": [\"get\", \"point_count_abbreviated\"],\n        \"text-size\": 12,\n    },\n)\n\nmap_options = MapOptions(style=Carto.POSITRON, center=CENTER, zoom=3, hash=True)\n\n\ndef create_map() -&gt; Map:\n    m = Map(map_options)\n    m.add_source(EARTHQUAKE_SOURCE, earthquakes_source)\n    m.add_layer(earthquake_clusters)\n    m.add_layer(earthquake_circles)\n    m.add_tooltip(EARTHQUAKE_CLUSTERS, \"maxMag\")\n    m.add_layer(earthquake_labels)\n    return m\n\n\napp_ui = ui.page_fluid(\n    ui.panel_title(\"Earthquakes Cluster\"),\n    output_maplibregl(\"maplibre\", height=500),\n)\n\n\ndef server(input, output, session):\n    @render_maplibregl\n    def maplibre():\n        return create_map()\n\n    @reactive.Effect\n    @reactive.event(input.maplibre)\n    async def result():\n        print(f\"result: {input.maplibre()}\")\n\n\napp = App(app_ui, server)\n\nif __name__ == \"__main__\":\n    if len(sys.argv) == 2:\n        file_name = sys.argv[1]\n        with open(file_name, \"w\") as f:\n            f.write(create_map().to_html())\n    else:\n        app.run()\n</code></pre> <p>Run example:</p> <pre><code>poetry run uvicorn docs.examples.earthquake_clusters.app:app --reload\n</code></pre>"},{"location":"examples/every_person_in_manhattan/","title":"Every person in manhattan","text":"<pre><code>import json\nimport sys\n\nimport pandas as pd\nimport shapely\nfrom maplibre import (\n    Layer,\n    LayerType,\n    Map,\n    MapContext,\n    MapOptions,\n    output_maplibregl,\n    render_maplibregl,\n)\nfrom maplibre.basemaps import Carto\nfrom maplibre.controls import ScaleControl\nfrom maplibre.sources import GeoJSONSource\nfrom maplibre.utils import df_to_geojson\nfrom shiny import App, reactive, ui\n\nMALE_COLOR = \"rgb(0, 128, 255)\"\nFEMALE_COLOR = \"rgb(255, 0, 128)\"\nLAYER_ID = \"every-person-in-manhattan-circles\"\nCIRCLE_RADIUS = 2\n\npoint_data = pd.read_json(\n    \"https://raw.githubusercontent.com/visgl/deck.gl-data/master/examples/scatterplot/manhattan.json\"\n)\n\npoint_data.columns = [\"lng\", \"lat\", \"sex\"]\n\nevery_person_in_manhattan_source = GeoJSONSource(\n    data=df_to_geojson(point_data, properties=[\"sex\"]),\n)\n\nbbox = shapely.bounds(\n    shapely.from_geojson(json.dumps(every_person_in_manhattan_source.data))\n)\n\nevery_person_in_manhattan_circles = Layer(\n    type=LayerType.CIRCLE,\n    id=LAYER_ID,\n    source=every_person_in_manhattan_source,\n    paint={\n        \"circle-color\": [\"match\", [\"get\", \"sex\"], 1, MALE_COLOR, FEMALE_COLOR],\n        \"circle-radius\": CIRCLE_RADIUS,\n    },\n)\n\nmap_options = MapOptions(\n    style=Carto.POSITRON,\n    bounds=tuple(bbox),\n    fit_bounds_options={\"padding\": 20},\n)\n\n\ndef create_map() -&gt; Map:\n    m = Map(map_options)\n    m.add_control(ScaleControl(), position=\"bottom-left\")\n    m.add_layer(every_person_in_manhattan_circles)\n    return m\n\n\napp_ui = ui.page_fluid(\n    ui.panel_title(\"Every Person in Manhattan\"),\n    output_maplibregl(\"maplibre\", height=600),\n    ui.input_slider(\"radius\", \"Radius\", value=CIRCLE_RADIUS, min=1, max=5),\n)\n\n\ndef server(input, output, session):\n    @render_maplibregl\n    def maplibre():\n        return create_map()\n\n    @reactive.Effect\n    @reactive.event(input.radius, ignore_init=True)\n    async def radius():\n        async with MapContext(\"maplibre\") as m:\n            m.set_paint_property(LAYER_ID, \"circle-radius\", input.radius())\n\n\napp = App(app_ui, server)\n\nif __name__ == \"__main__\":\n    if len(sys.argv) == 2:\n        file_name = sys.argv[1]\n        with open(file_name, \"w\") as f:\n            f.write(create_map().to_html())\n    else:\n        app.run()\n</code></pre> <p>Run example:</p> <pre><code>poetry run uvicorn docs.examples.every_person_in_manhattan.app:app --reload\n</code></pre>"},{"location":"examples/geopandas/","title":"GeoPandas","text":"<pre><code>import sys\nimport webbrowser\n\nfrom maplibre import Layer, LayerType, Map, MapOptions\nfrom maplibre.sources import GeoJSONSource\nfrom maplibre.utils import geopandas_to_geojson\n\nimport geopandas as gpd\n\nfile_name = \"/tmp/pymaplibregl_temp.html\"\nLAYER_ID = \"wilderness\"\n\ndf_geo = gpd.read_file(\n    \"zip+https://github.com/Toblerity/Fiona/files/11151652/coutwildrnp.zip\"\n)\n\nwilderness_source = GeoJSONSource(data=geopandas_to_geojson(df_geo))\n\nwilderness_layer = Layer(\n    type=LayerType.FILL,\n    id=LAYER_ID,\n    source=wilderness_source,\n    paint={\"fill-color\": \"darkred\", \"fill-opacity\": 0.5},\n)\n\nmap_options = MapOptions(bounds=df_geo.total_bounds)\n\n\ndef create_map():\n    m = Map(map_options)\n    m.add_layer(wilderness_layer)\n    m.add_tooltip(LAYER_ID, \"NAME\")\n    return m\n\n\nif __name__ == \"__main__\":\n    m = create_map()\n    if len(sys.argv) == 2:\n        file_name = sys.argv[1]\n\n    with open(file_name, \"w\") as f:\n        f.write(m.to_html())\n\n    webbrowser.open(file_name)\n</code></pre> <p>Run example:</p> <pre><code>poetry run python docs/examples/geopandas/app.py\n</code></pre>"},{"location":"examples/road_safety/","title":"H3 Grid UK Road Safety","text":"<pre><code>import sys\nimport webbrowser\n\nimport h3\nimport pandas as pd\nfrom maplibre import (\n    Layer,\n    LayerType,\n    Map,\n    MapContext,\n    MapOptions,\n    output_maplibregl,\n    render_maplibregl,\n)\nfrom maplibre.sources import GeoJSONSource\nfrom maplibre.utils import df_to_geojson\nfrom shiny import App, reactive, ui\n\nRESOLUTION = 7\nCOLORS = (\n    \"lightblue\",\n    \"turquoise\",\n    \"lightgreen\",\n    \"yellow\",\n    \"orange\",\n    \"darkred\",\n)\n\nroad_safety = pd.read_csv(\n    \"https://raw.githubusercontent.com/visgl/deck.gl-data/master/examples/3d-heatmap/heatmap-data.csv\"\n).dropna()\n\n\ndef create_h3_grid(res=RESOLUTION) -&gt; dict:\n    road_safety[\"h3\"] = road_safety.apply(\n        lambda x: h3.geo_to_h3(x[\"lat\"], x[\"lng\"], resolution=res), axis=1\n    )\n    df = road_safety.groupby(\"h3\").h3.agg(\"count\").to_frame(\"count\").reset_index()\n    df[\"hexagon\"] = df.apply(\n        lambda x: [h3.h3_to_geo_boundary(x[\"h3\"], geo_json=True)], axis=1\n    )\n    df[\"color\"] = pd.cut(\n        df[\"count\"],\n        bins=len(COLORS),\n        labels=COLORS,\n    )\n    return df_to_geojson(\n        df, \"hexagon\", geometry_type=\"Polygon\", properties=[\"count\", \"color\"]\n    )\n\n\nsource = GeoJSONSource(data=create_h3_grid())\n\nmap_options = MapOptions(\n    center=(-1.415727, 52.232395),\n    zoom=7,\n    pitch=40,\n    bearing=-27,\n)\n\nh3_layer = Layer(\n    id=\"road-safety\",\n    type=LayerType.FILL_EXTRUSION,\n    source=source,\n    paint={\n        \"fill-extrusion-color\": [\"get\", \"color\"],\n        \"fill-extrusion-opacity\": 0.7,\n        \"fill-extrusion-height\": [\"*\", 100, [\"get\", \"count\"]],\n    },\n)\n\n\ndef create_map() -&gt; Map:\n    m = Map(map_options)\n    m.add_layer(h3_layer)\n    m.add_tooltip(\"road-safety\", \"count\")\n    return m\n\n\napp_ui = ui.page_fluid(\n    ui.panel_title(\"Road safety in UK\"),\n    output_maplibregl(\"mapylibre\", height=700),\n    ui.input_slider(\"res\", \"Resolution\", min=4, max=8, step=1, value=RESOLUTION),\n)\n\n\ndef server(input, output, session):\n    @render_maplibregl\n    def mapylibre():\n        return create_map()\n\n    @reactive.Effect\n    @reactive.event(input.res, ignore_init=True)\n    async def resolution():\n        async with MapContext(\"mapylibre\") as m:\n            with ui.Progress() as p:\n                p.set(message=\"H3 calculation in progress\")\n                m.set_data(\"road-safety\", create_h3_grid(input.res()))\n                p.set(1, message=\"Calculation finished\")\n\n\napp = App(app_ui, server)\n\nif __name__ == \"__main__\":\n    filename = sys.argv[1] if len(sys.argv) == 2 else \"/tmp/road_safety.html\"\n    with open(filename, \"w\") as f:\n        m = create_map()\n        f.write(m.to_html(style=\"height: 700px;\"))\n\n    webbrowser.open(filename)\n</code></pre> <p>Run example:</p> <pre><code>poetry run uvicorn docs.examples.road_safety.app:app --reload\n</code></pre>"},{"location":"examples/vancouver_blocks/","title":"Vancouver property value","text":"<pre><code>import sys\n\nfrom maplibre import (\n    Layer,\n    LayerType,\n    Map,\n    MapContext,\n    MapOptions,\n    output_maplibregl,\n    render_maplibregl,\n)\nfrom maplibre.basemaps import Carto\nfrom maplibre.controls import ScaleControl\nfrom maplibre.sources import GeoJSONSource\nfrom shiny import App, reactive, ui\n\nSOURCE_ID = \"vancouver-blocks\"\nLAYER_ID_LINES = \"vancouver-blocks-lines\"\nLAYER_ID_FILL = \"vancouver-blocks-fill-extrusion\"\nMAX_FILTER_VALUE = 1000000\n\nvancouver_blocks_source = GeoJSONSource(\n    data=\"https://raw.githubusercontent.com/visgl/deck.gl-data/master/examples/geojson/vancouver-blocks.json\"\n)\n\nvancouver_blocks_lines = Layer(\n    type=LayerType.LINE,\n    id=LAYER_ID_LINES,\n    source=SOURCE_ID,\n    paint={\n        \"line-color\": \"white\",\n        \"line-width\": 2,\n    },\n)\n\nvancouver_blocks_fill = Layer(\n    type=LayerType.FILL_EXTRUSION,\n    id=LAYER_ID_FILL,\n    source=SOURCE_ID,\n    paint={\n        \"fill-extrusion-color\": {\n            \"property\": \"valuePerSqm\",\n            \"stops\": [\n                [0, \"grey\"],\n                [1000, \"yellow\"],\n                [5000, \"orange\"],\n                [10000, \"darkred\"],\n                [50000, \"lightblue\"],\n            ],\n        },\n        \"fill-extrusion-height\": [\"*\", 10, [\"sqrt\", [\"get\", \"valuePerSqm\"]]],\n        \"fill-extrusion-opacity\": 0.9,\n    },\n)\n\nmap_options = MapOptions(\n    style=Carto.DARK_MATTER,\n    center=(-123.13, 49.254),\n    zoom=11,\n    pitch=45,\n    bearing=0,\n)\n\n\ndef create_map() -&gt; Map:\n    m = Map(map_options)\n    m.add_control(ScaleControl(), position=\"bottom-left\")\n    m.add_source(SOURCE_ID, vancouver_blocks_source)\n    m.add_layer(vancouver_blocks_lines)\n    m.add_layer(vancouver_blocks_fill)\n    m.add_tooltip(LAYER_ID_FILL, \"valuePerSqm\")\n    return m\n\n\napp_ui = ui.page_fluid(\n    ui.panel_title(\"Vancouver Property Value\"),\n    ui.div(\n        \"Height of polygons - average property value per square meter of lot\",\n        style=\"padding: 10px;\",\n    ),\n    output_maplibregl(\"maplibre\", height=600),\n    ui.input_select(\n        \"filter\",\n        \"max property value per square meter\",\n        choices=[0, 1000, 5000, 10000, 50000, 100000, MAX_FILTER_VALUE],\n        selected=MAX_FILTER_VALUE,\n    ),\n    ui.input_checkbox_group(\n        \"layers\",\n        \"Layers\",\n        choices=[LAYER_ID_FILL, LAYER_ID_LINES],\n        selected=[LAYER_ID_FILL, LAYER_ID_LINES],\n    ),\n)\n\n\ndef server(input, output, session):\n    @render_maplibregl\n    def maplibre():\n        m = create_map()\n        return m\n\n    @reactive.Effect\n    @reactive.event(input.filter)\n    async def filter():\n        async with MapContext(\"maplibre\") as m:\n            filter_ = [\"&lt;=\", [\"get\", \"valuePerSqm\"], int(input.filter())]\n            m.set_filter(LAYER_ID_FILL, filter_)\n\n    @reactive.Effect\n    @reactive.event(input.layers)\n    async def layers():\n        visible_layers = input.layers()\n        async with MapContext(\"maplibre\") as m:\n            for layer in [LAYER_ID_FILL, LAYER_ID_LINES]:\n                m.set_visibility(layer, layer in visible_layers)\n\n\napp = App(app_ui, server)\n\nif __name__ == \"__main__\":\n    if len(sys.argv) == 2:\n        file_name = sys.argv[1]\n        m = create_map()\n        with open(file_name, \"w\") as f:\n            f.write(m.to_html())\n    else:\n        app.run()\n</code></pre> <p>Run example:</p> <pre><code>poetry run uvicorn docs.examples.vancouver_blocks.app:app --reload\n</code></pre>"},{"location":"examples/where_is_the_iss/","title":"Where is the ISS","text":"<pre><code>import requests\nfrom maplibre import (\n    Layer,\n    LayerType,\n    Map,\n    MapContext,\n    MapOptions,\n    output_maplibregl,\n    render_maplibregl,\n)\nfrom maplibre.sources import GeoJSONSource\nfrom shiny import App, reactive, ui\n\nMAX_FEATURES = 30\nSOURCE_ID_ISS_POSITION = \"iss_position\"\nSOURCE_ID_ISS_LAST_POSITIONS = \"iss-last-positions\"\n\n\ndef where_is_the_iss() -&gt; tuple:\n    r = requests.get(\"https://api.wheretheiss.at/v1/satellites/25544\").json()\n    return (r[\"longitude\"], r[\"latitude\"])\n\n\ndef create_feature(lng_lat: tuple) -&gt; dict:\n    return {\n        \"type\": \"Feature\",\n        \"geometry\": {\n            \"type\": \"Point\",\n            \"coordinates\": lng_lat,\n        },\n        \"properties\": {\"coords\": \", \".join(map(str, lng_lat))},\n    }\n\n\nlng_lat = where_is_the_iss()\nfeature = create_feature(where_is_the_iss())\nfeature_collection = {\"type\": \"FeatureCollection\", \"features\": [feature]}\n\napp_ui = ui.page_fluid(\n    ui.panel_title(\"Where is the ISS\"),\n    ui.div(\"Click on Update to get the current position of the ISS.\"),\n    ui.div(\n        \"The yellow dots show the positions before. Hover the blue dot to display the coordinates.\"\n    ),\n    output_maplibregl(\"mapylibre\", height=600),\n    ui.input_action_button(\"update\", \"Update\"),\n)\n\n\ndef server(input, output, session):\n    @render_maplibregl\n    def mapylibre():\n        m = Map(MapOptions(center=lng_lat, zoom=3))\n        m.set_paint_property(\"water\", \"fill-color\", \"darkblue\")\n        m.add_source(\n            SOURCE_ID_ISS_LAST_POSITIONS, GeoJSONSource(data=feature_collection)\n        )\n        m.add_layer(\n            Layer(\n                type=LayerType.CIRCLE,\n                source=SOURCE_ID_ISS_LAST_POSITIONS,\n                paint={\"circle-color\": \"yellow\", \"circle-radius\": 5},\n            ),\n        )\n        m.add_source(SOURCE_ID_ISS_POSITION, GeoJSONSource(data=feature))\n        m.add_layer(\n            Layer(\n                type=LayerType.CIRCLE,\n                id=\"iss-position\",\n                source=SOURCE_ID_ISS_POSITION,\n                paint={\"circle-color\": \"lightblue\", \"circle-radius\": 7},\n            )\n        )\n        m.add_tooltip(\"iss-position\", \"coords\")\n        return m\n\n    @reactive.Effect\n    @reactive.event(input.update)\n    async def update():\n        print(\"Fetching new position\")\n        lng_lat = where_is_the_iss()\n        print(lng_lat)\n        if len(feature_collection[\"features\"]) == MAX_FEATURES:\n            feature_collection[\"features\"] = []\n\n        async with MapContext(\"mapylibre\") as m:\n            feature = create_feature(lng_lat)\n            m.set_data(SOURCE_ID_ISS_POSITION, feature)\n            feature_collection[\"features\"].append(feature)\n            m.set_data(SOURCE_ID_ISS_LAST_POSITIONS, feature_collection)\n            m.add_call(\"flyTo\", {\"center\": lng_lat, \"speed\": 0.5})\n\n\napp = App(app_ui, server)\n</code></pre> <p>Run example:</p> <pre><code>poetry run uvicorn docs.examples.where_is_the_iss.app:app --reload\n</code></pre>"},{"location":"examples/wms/","title":"WMS","text":"<pre><code>import webbrowser\n\nfrom maplibre import Layer, LayerType, Map, MapOptions\nfrom maplibre.sources import RasterTileSource\n\nSOURCE_ID = \"wms-test-source\"\nLAYER_ID = \"wms-test-layer\"\n\nwms_source = RasterTileSource(\n    tiles=[\n        \"https://img.nj.gov/imagerywms/Natural2015?bbox={bbox-epsg-3857}&amp;format=image/png&amp;service=WMS&amp;version=1.1.1&amp;request=GetMap&amp;srs=EPSG:3857&amp;transparent=true&amp;width=256&amp;height=256&amp;layers=Natural2015\"\n    ],\n    tile_size=256,\n)\nwms_layer = Layer(type=LayerType.RASTER, source=SOURCE_ID, id=LAYER_ID)\n\nmap_options = MapOptions(zoom=8, center=(-74.5447, 40.6892))\n\nm = Map(map_options=map_options)\nm.add_source(SOURCE_ID, wms_source)\nm.add_layer(wms_layer)\n\ntemp_file = \"/tmp/pymaplibregl.html\"\n\nwith open(temp_file, \"w\") as f:\n    f.write(m.to_html(style=\"height: 800px;\"))\n\nwebbrowser.open(temp_file)\n</code></pre>"}]}
\ No newline at end of file
diff --git a/sitemap.xml.gz b/sitemap.xml.gz
index 8c69acd2c4b8177139aeeb0b3cf57fb49aac6454..4386b7a33dc8450198c2f47a41ea0d228d2a2ef8 100644
GIT binary patch
delta 13
Ucmb=gXP58h;CPVbH<7&p03H<tXaE2J

delta 13
Ucmb=gXP58h;7E}4oycAR02zD(mH+?%