Skip to content

Instantly share code, notes, and snippets.

@jjclavijo
Last active November 11, 2021 15:48
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save jjclavijo/8cfd861a7911f0a7503de42be1770daf to your computer and use it in GitHub Desktop.
Save jjclavijo/8cfd861a7911f0a7503de42be1770daf to your computer and use it in GitHub Desktop.
Geocoding con Nominatim + contextily
Display the source blob
Display the rendered blob
Raw
{
"nbformat": 4,
"nbformat_minor": 5,
"metadata": {
"jupytext": {
"cell_metadata_filter": "-all",
"main_language": "python",
"notebook_metadata_filter": "-all"
},
"colab": {
"name": "Geocoding con Nominatim + contextily",
"provenance": [],
"collapsed_sections": [],
"include_colab_link": true
},
"language_info": {
"name": "python"
},
"kernelspec": {
"name": "python3",
"display_name": "Python 3"
}
},
"cells": [
{
"cell_type": "markdown",
"metadata": {
"id": "view-in-github",
"colab_type": "text"
},
"source": [
"<a href=\"https://colab.research.google.com/gist/jjclavijo/8cfd861a7911f0a7503de42be1770daf/geocode.ipynb\" target=\"_parent\"><img src=\"https://colab.research.google.com/assets/colab-badge.svg\" alt=\"Open In Colab\"/></a>"
]
},
{
"cell_type": "markdown",
"metadata": {
"id": "fba1eb41"
},
"source": [
"\n",
"# Ejemplo de geocoding con nominatim\n",
"\n",
"nominatim es un servicio de geocoding que utiliza openstreetmap, existe una \n",
"instancia de acceso publico, para uso limitado (por ejemplo para hacer alguna\n",
"prueba en el formato de una consulta, etc.). Es importante tener en cuenta \n",
"[la politica de uso](https://operations.osmfoundation.org/policies/nominatim/).\n",
"\n",
"En caso de necesitar utilizar nominatim para geocoding a gran escala, puede\n",
"instalarse una instancia local del servicio y utilizarla sin restricciones."
],
"id": "fba1eb41"
},
{
"cell_type": "code",
"metadata": {
"id": "eb149968"
},
"source": [
"# Primero instalamos algunos paquetes para poder ver los resultados.\n",
"_= !pip install geopandas contextily"
],
"id": "eb149968",
"execution_count": 1,
"outputs": []
},
{
"cell_type": "markdown",
"metadata": {
"id": "4668d254"
},
"source": [
"# La sintaxis de la consulta es sencilla\n",
"\n",
"Se trata de una API que funciona a través de la web, d emodo que se construye\n",
"una URL de consulta. Utilizaremos el servidor 'https://nominatim.openstreetmap.org/',\n",
"y en este caso haremos una consulta directa, es decir con un texto buscaremos\n",
"la ubicación geográfica.\n",
"\n",
"En [este link](https://nominatim.org/release-docs/develop/api/Overview/) se puede ver en mas detalle"
],
"id": "4668d254"
},
{
"cell_type": "code",
"metadata": {
"id": "b0b06596",
"outputId": "5000f472-a04a-488e-b4ac-6a36e037880a",
"colab": {
"base_uri": "https://localhost:8080/"
}
},
"source": [
"a=\"Argentina, Buenos Aires, Olavarría, Villa Alfredo Fortabat\".replace(' ','+')\n",
"\n",
"query=f'https://nominatim.openstreetmap.org/search?q={a}&format=geojson'\n",
"\n",
"print(query)"
],
"id": "b0b06596",
"execution_count": 2,
"outputs": [
{
"output_type": "stream",
"name": "stdout",
"text": [
"https://nominatim.openstreetmap.org/search?q=Argentina,+Buenos+Aires,+Olavarría,+Villa+Alfredo+Fortabat&format=geojson\n"
]
}
]
},
{
"cell_type": "code",
"metadata": {
"id": "51ac98ee",
"outputId": "1b2159ec-9ffd-495c-a474-84221e8e93b9",
"colab": {
"base_uri": "https://localhost:8080/"
}
},
"source": [
"%%bash -s {query}\n",
"rm -f geocoded.geojson\n",
"touch geocoded.geojson\n",
"\n",
"echo $1\n",
"curl \"$1\" \\\n",
" -H 'authority: nominatim.openstreetmap.org' \\\n",
" -H 'upgrade-insecure-requests: 1' \\\n",
" -H 'user-agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) QtWebEngine/5.15.2 Chrome/87.0.4280.144 Safari/537.36' \\\n",
" -H 'accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,image/apng,*/*;q=0.8,application/signed-exchange;v=b3;q=0.9' \\\n",
" -H 'dnt: 1' \\\n",
" -H 'accept-language: en-US,en;q=0.9' \\\n",
" -H 'sec-fetch-site: cross-site' \\\n",
" -H 'sec-fetch-mode: navigate' \\\n",
" -H 'sec-fetch-user: ?1' \\\n",
" -H 'sec-fetch-dest: document' \\\n",
" -H 'referer: https://nominatim.org/' >> geocoded.geojson"
],
"id": "51ac98ee",
"execution_count": 7,
"outputs": [
{
"output_type": "stream",
"name": "stdout",
"text": [
"https://nominatim.openstreetmap.org/search?q=Argentina,+Buenos+Aires,+Olavarría,+Villa+Alfredo+Fortabat&format=geojson\n"
]
},
{
"output_type": "stream",
"name": "stderr",
"text": [
" % Total % Received % Xferd Average Speed Time Time Time Current\n",
" Dload Upload Total Spent Left Speed\n",
"\r 0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0\r 0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0\r100 597 0 597 0 0 1267 0 --:--:-- --:--:-- --:--:-- 1264\n"
]
}
]
},
{
"cell_type": "code",
"metadata": {
"id": "c8470f88",
"outputId": "8be256e0-53e9-4da1-8e76-7716a10795f8",
"colab": {
"base_uri": "https://localhost:8080/",
"height": 441
}
},
"source": [
"import geopandas as gpd\n",
"import contextily as cx\n",
"import matplotlib.pyplot as plt\n",
"\n",
"gcd = gpd.read_file('geocoded.geojson').to_crs(epsg=3857)\n",
"\n",
"ax = gcd.plot(figsize=(10,10))\n",
"\n",
"# Geopandas cuando sólo tiene un punto que representar elije una zona un tanto\n",
"# Grande, la vamos a dividir por 6.\n",
"\n",
"k = 6\n",
"X,x = ax.get_xlim()\n",
"Y,y = ax.get_ylim()\n",
"\n",
"xm = (x+X)/2\n",
"xr = (x-X)/(2*k)\n",
"\n",
"ym = (y+Y)/2\n",
"yr = (y-Y)/(2*k)\n",
"\n",
"ax.set_xlim(xm-xr,xm+xr)\n",
"ax.set_ylim(ym-yr,ym+yr)\n",
"\n",
"# Agregamos un mapa de base con dos capas de Stamen: Toner a zoom 12,\n",
"# y las etiquetas del zoom 9\n",
"\n",
"cx.add_basemap(ax,crs=gcd.crs,source=cx.providers.Stamen.TonerBackground,zoom=12)\n",
"cx.add_basemap(ax,crs=gcd.crs,source=cx.providers.Stamen.TonerLabels,zoom=9)"
],
"id": "c8470f88",
"execution_count": 24,
"outputs": [
{
"output_type": "display_data",
"data": {
"image/png": "iVBORw0KGgoAAAANSUhEUgAAAmEAAAGoCAYAAAAO+jKqAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4yLjIsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy+WH4yJAAAgAElEQVR4nOy9e4wk2V3v+T35qHzXM6uysiqrMrO6enpmemYMdsssGGMzvrbhjwUkaxe8LKsrXS5YaHe1CBYhkFYrsfvP6iKzd+8agZARCHytC0isx7KxDX7CeMbT42Gmp3u6p7srn5X1flflO+LsH9Un5uSpiMjIzMjMyKrzkUqZFRlxXnEe3/j9TpxDKKWQSCQSiUQikQwW17ATIJFIJBKJRHIVkSJMIpFIJBKJZAhIESaRSCQSiUQyBKQIk0gkEolEIhkCUoRJJBKJRCKRDAEpwiQSiUQikUiGwMiKMELI5wkh24SQty2e/98SQu4RQu4SQr7Q7/RJJBKJRCKRmEFGdZ0wQshPATgF8JeU0ufanHsdwH8B8CKl9IAQMkcp3R5EOiUSiUQikUj0GFlLGKX0uwD2+WOEkGuEkH8ghLxOCPkeIeTpJz/9ewD/L6X04Mm1UoBJJBKJRCIZKiMrwgz4UwD/E6X0AwB+G8Dnnhx/CsBThJB/IYS8Qgj5maGlUCKRSCQSiQSAZ9gJsAtCSBjATwD4G0IIO+x78ukBcB3ARwEkAHyXEPI8pfRw0OmUSCQSiUQiAS6RCMO5Ve+QUvojOr8VAbxKKW0AyBBC3sW5KHttkAmUSCQSiUQiYVwadySl9BjnAuu/AQByzvue/Pz3OLeCgRASxbl7cm0Y6ZRIJBKJRCIBRliEEUL+M4DvA7hBCCkSQv4dgF8G8O8IIW8CuAvg55+c/jUAe4SQewC+BeB/pZTuDSPdEolEIpFIJMAIL1EhkUgkEolEMsqMrCVMIpFIJBKJZJSRIkwikUgkEolkCIzk25HRaJSmUqlhJ0MyYiiKgkajgbGxMbhc8vlDIpFcXqrVKnw+H7glmyQDhI037B68/vrru5TSWfG8kRRhqVQKt2/fHnYyRhI2B5BSqjXOq9JIKaUol8vI5/OYm5vD9PT0SOedUjoS93EU0im2i27TOAp5HQZXuVxY3gH0VLc6jTOfz2N8fBxTU1N9jaef91VVVdMys2s84/PRax4opTg5OcH6+jrS6TT8fj9LV07vfGkOuGKwSkYI0Soe30lcZgghCAaDuHbtGvb391EqlaCq6rCT1TX8fQTg2Hs4CunkO/Bu28NVFhpmiOV51cqFH9gH1dcSQhCJRHByctLX+PrZtq2EJbbbbtJgtwA7OzvD+vo6UqkUfD5f22ukCLuiiGIMcObgaDeEEIyNjWFlZQXNZhPZbBbNZnPYyeqaUbmHo5BOvQcUq0gBps8wrEBOZBhCLBwOo1wu9z2uYbdtp4xllFJUKhXk83ksLy/D7/dbqu9ShF1hjKxiVwG3243l5WWEQiE8fvwY1Wp1ZPPuhA7ICqOYTitpvOqWHiP0ys6p93wQDFqIeb1eeDweVCqVvsYDXGzbdofdTRo6abt2PCBUq1Vks1ksLy8jGAxaDk+KMMmVFWOEEMzNzSEWi2FtbQ1nZ2cjm+9RFDiAc9MJWHNNiuJLCrBz9ObYjcI97ze9WFu7iYu5JK8Kw6prTIAlEgmEQqGO+gEpwiQA9OfEXIXOkhCCiYkJJJNJ5PP5vs+h6CejMtiNQjqtzBGzazL/ZUOvXEbhng8KO+YfWmUQ88KAi+74YWK1rtllBavX68hms4jH44hEIh2HJUWYRIPvLAFcGTHGJuynUimsr6/j6OhoZPM8KoPdKKTTbLCUAkwfs3IZhXs+KAYlxPx+v7ZUQr/ox3zIXkVdu7pmR3lTStFoNJDJZDA3N4eJiYmu0itFmOQCV/HJlQmxdDqNzc1N7O/vj2yeR+XejUI62wkxKcAuYlYuo3DPB8UghBjr105PT/sSvpNfSLEixHppv4qiIJPJYGZmBlNTU12HI0WYRBcj9+Rl7zR9Ph9WVlawu7uL3d3dkc3vqAx2o5BOo7bgpAHHCVh174zCPR8U/RZihBCMj4/j6OgIgP1l3S8BZtcDjt5cZzvKmb1ZPzExgZmZmZ7SKUWYxBC9+RyXXYwRQuD1erGysoLDw0NsbW2NbF5HZbAbhXTyAw2/tpwUYud0KkxH4Z4Pin4LsXA4jEqlAkVRANhb1vw9tIt+CFF+ig377FbkKYqCfD6PUCiEubm5nvsAKcIkbblqYowJsXQ6jbOzM2xsbIz8oq5Ov0+jMCiLT/xSgJ3TrUtqFO75oDCyttqB2+2Gz+drWYanH0LMrnlW/YAXXL305aqqIp/Pw+fzYX5+3pY+QIowiWXMxNhlxOPxIJVKoVarYX19fWSF2KjMXRqlQdnpZTkoep0TNEr3vN/ozcW1K1z2lqTdZd0PK16/+is+zG7CVlUVhUIBHo8H8XjctvRJESbpmKskxtxuN5LJpNYAmUl/FLA6R8dJOHlQdlJanIBdk7KdfM+Hgdiv2gG/Xli/hJhd4fULVp4ul6vlf6vs7+9DURQsLi5qYdiBFGGSrhGfggBnN8JucblcWFpagtvtRj6fd7wQG/XJ404elEdN1PYLu9+Kc/I9HxZ2PuD6/X6oqop6vW77wzN/vV3tot/ti58jZiX/lFLs7+9jfn7eVgEGSBEm6ZGrYhFzuVxYXFyEz+dz9H6T4sRTYDRdZ04blEfRqtgvxDZu58DrpHs+TOx+wCWEIBwO4/T0VPu/UyGihx0T3QeB2H47zX+5XAYhBIFAwPa0SREmsYWrIMYIIYjH4wiHw1hbW+vrAoi9MOoCjCEHZechiq9+zduR99z+9RrF1fN7FWL9EGCDtN7rjVlGaTo4OOhpLTAzbBFhhJDfIoRQQkjU5JxxQkiREPKfuGMfIITcIYQ8IoT8RzLKI4bkSrgnCTnfb3Jqagpra2uo1WrDTpKG3tPeqOOEQVlawc4ZlNXDCffcSdhVHqFQCJVK5cISK90IsX4JsH5g1n6tvFigKApOTk4wMTHRl/T1LMIIIUsAPgEg3+bUPwDwXeHYHwP49wCuP/n7mV7TIxkuV8UiFo1GMTs7i0wm0/Lq97AY5Tlg7ZCD8vAZtNtJ3vNW7CgPtlRFuVzWDdvqywCj4oK0ipkQY1awYDAIj8fTl/jtsIR9FsDvADC8c4SQDwCIAfg6dywOYJxS+go9z/VfAvgFG9IjcQCXXYwRQjA1NYX5+XlkMhlUKpWhWmkuiwvSiGENytIKNrxBVwqxVnotD0LOl6o4Pj7W/Y19tnPNsc9+1QU7w7TafvXyTynFyckJdnd3bVsTTI+eRBgh5OcBrFNK3zQ5xwXgDwH8tvDTIoAi93/xyTGjcH6NEHKbEHJ7Z2enh1RLBsVld08SQjAxMYHFxUXkcjmUy+WB5u+yTMK3yqAH5ctsXbTKsK0eUoi10mt5RCIRw30kOxFi/agLw25rYv7L5TKKxSKSySTGxsb6Fm9b+xoh5B8BzOv89PsAfg/nrkgzfgPAVyilxV4KmFL6pwD+FABu3bp1tVviCMHfc3FS72WAPV0uLy8jl8shkUggEokMLH9XzUrDz19hneUg8n5VylePYdexYd1zp8KXh3isHT6fDwBQq9Xg9/t1w+bLWYxv2HWhE7pJL8t3tVpFNptFMplEIBDoa37bijBK6b/RO04IeR5AGsCbTxKYAPBDQsgHKaWb3Kk/DuDDhJDfABAGMEYIOQXwfz+5hpEAsN5VLiSO5zKLMUIIgsEg0uk0stks4vE4JiYm+pq3q2ylGcSgPGoDTj9wUh2TQqwVURjxx9oRDodxcnKiK8JYOKIQY3H1q8ydZOGs1WrI5XJYWlpCMBjse3xdzzSjlN4BMMf+J4RkAdyilO4K5/0yd86/fXLO7z75/5gQ8l8BeBXA/wDg/+k2PRLnIzbuy9SZEkLg9/s1Iaaqat9eab4Kc8CsoqoqXC7XpalHTsGJdUwKsVb0hBh/3OiaSCSC3d1dRKNRw3PNLGKjUObdPkTV63XtQToSiWhhMTrNuxVx2Zd1wgghtwghf2bh1N8A8GcAHgF4DOCr/UiPxDmwRiFOgLwM8EJsZ2cHu7u7tufNiYPjoOHrDBNg7LidXGUrGI+TykDOEWvFqD81K5dQKIRqtdp2L9xB9TFOsTo3Gg1kMhnMzs62eDI6qW/iPbByP8goVuJbt27R27dvDzsZkh4Z9qTfftJoNJDNZjE+Po65uTlb8iYF2EX3Cz/42FkuqqpeujrZCaxM7d6ixS5kW7iIKBSM6i+lFNlsFtPT05bWvup3P223COsmvGaziUwmg8nJSV0LodX6ZuQefpKW1ymlt8RrnNnCJFcC8UljFB8IjPB6vUin0zg9PcXGxkbbp852yEFHX4Dx3+2yjlymetgNTpoLZoTePb9sfUin6LUHvfIghGB8fLxl9Xwr4QLnDyd2lrET6pqiKMjlcohEIpZctIB+HyGKP/7PDCnCJEPlMgsxj8eDVCqFWq2GUqnUtRCTAsxYgDGkm+rqYeSGu8r3Xnw4MSoTfh/JdvDXMve/HeUsXj8MK5iqqsjn8/D7/YjFYqYCjH2KfQxfHt300VKESYaOlU5jVHG73VheXkaj0ehKiEkB1l6AMewWYle5rEfFFatndbhM/Ue3tJvPNDY2BpfLhWq1ahqOnivSbqvzsOqaqqooFArweDyIx+Nt02CW/176aCnCJI5Ar9O4LDAh1mw2sb6+blmISQFmXYAx7BokrmJZjyqi20cKsXPMRAMhRFuqwgijuWB2tLF+iP1OwqSUolQqgVKKxcXFjuY+svBVVdXcs1Zdj3pIESZxDJf5aZYJMVVVUSwW2woxKcA6F2CMXgeJy1TvumFUrGB6SCF2EaP2YDYvTK/t8N9H2f1PKcXm5ibq9TqWlpY6fvlEb+5XL0gRJnEkl9E16XK5sLS0BEqpqRCTAqx7AcbodpC4LHWtGy5LW7vM0xu6Ra89BAIB1Ot1NJvNlnP1LGB67agXITYsKxilFNvb2zg7O0MymYTb7e44Drtds1KESRxHP+YeOAUmxACgUChcEGJSgPUuwBiXtQ5J2tNuTtSoYKeAFNuDy+VCMBjE2dlZS3zsU2+uHX+OXpi9uCa7pZMHrL29PRwdHXUkwHjxJfbNouemm3xIESZxLJd1EHW5XEgkEiCEIJ/Pa0JMCjD7BBij2zp01cq+H3N0ho1dg+Sw6acQi0QiF+aF6dUDu4WYWMfsEGJmdZdSisPDQ+zt7SGVSsHr9VoOVwzfqGy6zYcUYRJHcxk6UT2YEHO73cjn81AURQowmwUYo5NBgr8HksuBKMbYZOpR6Uvsnt/Gl0UoFMLZ2VlLmRi1PbuEmF5e+jmHj1KK4+NjbG5uIpVKYWxszNI1Ru5HPXoRYlKESRxPr08aTsXlcmFxcRFutxu5XE6ziF1FEdAvAcawMkhclnrVDZfNCiYiupDEQdap975fLxqwcvB6vXC5XKhUKpYeQPrhmuwlj+2EI6UUp6enKJVKSKfTHQuwduJLzEc345QUYZKRQM+1cBkghGBhYQFer1d3jthVoN8CjHFZ3du9clXKQXQn8QMm/+k09ESKHWllZRAKhbC5uXnBCm8UF7tOz6Jo5rlg/yuKYimP7Wh3DqUU5XIZxWIRyWQSPp/PtG8R09yJAOPz0akQkyJMMjL066lwWLA8MIvY2NgYcrmcbid1WRmUAGNIISYBLgoyp9cHse8D7EtrJBLB2toatra2tGNWLMZGYsNMiCiKogk4Zn0T89iJ0DSyglFKUa1Wkc/nkUgkEAgETOeLdWv90qNTg4EUYZKR4rIIMb7BA+euyYWFBfh8visjxAYtwBhWXCpXhXbunKvAqMw75Qd3/mWebmF5DYVCiMfjODw8xObmZku7EOuF0W9WhBh/TbPZxMOHD7G3t9cSJnsotdq/G9Xber2ObDaLhYUFhMNhUwEm5seOttDJOCVFmGTkGHUhJgow/nNhYQF+vx/ZbPZSC7FhCTCGnhAbtXoksY9u5/MMGr7v6MUixofjcrkQDocRi8VQqVS0XT30rEvs08itqyfEGo0Gtra2NCsYIQT1eh0nJycolUraS0kiZv272T2q1+vIZDKYn5/H+Pi44VwxURyyOO1Cz3qphxRhkpFkVIVYu0ZPCEE8HkcgEEA2m72wkOJlYNgCjCEKsauGtIK14nQhZjT3SvzNSjhiH+T1ekEpRTKZRL1ex/r6ess5ZtYxMVw+Lc1mE9lsFgcHBygUCtpvlUoFiqLA6/Vqlj094SdaKNkfP3eWj09VVeRyOUSjUUxOThqmU8xLP9qA1XsiRZhkZNETYk7rOHmsPnUxIRYMBi+dEHOKAGN0MndDcvlxqhAzEw6dCDGjPohvk8lkEpRS7UUhK+5JANr2PywOJsCmp6dx48YN+Hw+be5ZLpcDpRQ+n68lfEVRLljGxAclPh2iODs7O4PL5cLMzIyuJa8X65eeGNQTh/yeklbqkBRhkpHGqsl32HTa8AkhmJ+fRzgcvnRCDHCGAGPouVWuEk65D07BaULMTAR1IsTM+iBehLFdPVwul7aYtJkAE4Uh8J4FLBKJIBqNanNeI5EIcrkc6vU6CCHaG4sulwtut/tCPvhweUFoJEQrlQqCwWDHrlSxjNqJKvFPvB/8n8vlMt2fUoowycgjNkYndJw83T55EUIQi8UQDoeRyWQunRBzEr24d0YRsU5KWnGKELPiBrRSd/XEAv+bqqqaUGDCYXFxER6PB9ls9oKr0ChdLB35fB7BYBCxWKwl/rm5OW23kEAggFAo1BKux+MxFHt6+RfjbTQaLavhG1m/xN+MrFdmoor/0zvP6oOmFGGSS4XTBlKzzs8KTIiNj48jk8mg0WjYncSB41T331UTYhJz9B7uBokVAcYwewg1mwJgJFDYuXrzU83SpaoqCoUCfD4f4vG4dq6qqlAUBc1mE9FoFNeuXcPY2Bj8fv8FLwZvNRLjMrMGEkJwcnKiLX2hl04jK5ae0OpWVHWKFGGSS4Oea3KYA6lZ59cJhBDMzc1hfHwc2Wx2pIWYeI+cJnSughDjB11pCTNnWPW1EwHG0LPeWRFgenlkfy6XC/F4XLPGs77HSIAVi0XN9cjjcrlaym56ehrz8/NYW1vTXJMsDXppsZp/Sil2d3ext7d3oRz5MuAtWoMQWmZIESa5VIhPr8BwBlK7BBiDCbGJiYmRt4hJISYZJYYpxMwsV0Zp1XOjmrky2bni+lx8vmOxmNb3MNEkpqtUKkFVVc3dKLr7+DxRSjE9PY1oNIrHjx+jVqtpv4v55NNo1pey31dXV7G7u4vt7e2Wa4YptMyQIkxyKRnmQGq3AGMQQjA7O4upqSkpxPrMZRdiThuInM4g62s7S2W7Oim63swEGH+untjh8z07O4vp6WnNGs8LrFKphEqlgqWlJS08RVG0eVbikhIs7MnJSczPz+Pdd9/F6empdi47h1nQrFjD6vU6KKUIBoO4du0ajo6OsLu7q6XfqUgRJrm02DmQ6pn3zc7j47cTQgii0Simp6fx+PFjreMaRaQQGzxOLOdRod/1VbT+mAknszop9j9W0som3jOLmB6EEMzMzGB2dhZra2uo1WpQFAUbGxs4OzvD4uKiNvdLtILxaeYtboScr1FWrVbx6NEjnJ2dXXBN8t+N+lNVVbG+vo6ZmRm4XC54vV6srKzg5OQEW1tbjq7zUoRJLjV2DKSiidwonH4LMAbrDBcXF1EsFrG1tTWyG3/ruVqcxGUUYpLuGYQQs5IGozrJHzNyTerFyfdb/Kde3FNTU4jFYshkMiiVSjg9PUUymYTH42lZ54uPm+3+IZZbrVZDNpvFysoK0uk0crkcTk9PW9YcsyLACoUCvF4votGodp7H40EqlcLZ2Rk2NjYc23alCJNcenoZSPU6NaPObxACjEEIQSQSwerqKur1Oh4/foxqterYjqYdTnYXXBYh1s7KIrFGv4SY3jyrducaPSDqzYEySyv/ENeubjA3ot/vx927dzE3N3dhDhifB6M612g0kM1mtZeOgsEgkskkCoUCTk5OdAWYGAelFOvr6wCAxcXFC1Y8JsSq1aq2HZPTIKPYody6dYvevn172MmQjBidCqV2T5V6HeYwBjhKqbb57tzcHKanp0dmkDUqYyci3ncnp1UPKcLspV91t5N6Jp5rlJZ2fdn29jbq9bo2p8uMZrOJUqmEu3fvwuv14vj4GDMzM/D7/fD5fFhZWdEWYeXj5GECLBqNYmpqCgC0txWr1Sqy2Szi8TgmJycBnC/C+ujRo5YHTUrP1wWbnZ3F9evX4Xa7DctIVVXk83l4PB5dsTYICCGvU0pvicc9A0+JRDIk9EzzRh1Ouw6Wn9MwTAHG4p2cnEQwGESxWMTx8TESiYS28KFTGSUBBuDCoKI3uDgVKcDsR68PYMd7DRewVs/EPo3Nt7KaVvZ9bm4Ojx49wvHxseGm1+z87e1trK2tIZlMYmVlRVsclQmlfD6P5eVlbQ0wEX47I/bAyOcxEAggnU4jm82CUopAIIC9vT1twr3f7wdwLuTeeOMNBINBKIqiK8L4vplZ2QqFgrYjgBNwRiokkgFhxeRvRYCJ7oBhD26EnG8Bkk6nEQqFtA7VqZbuURNgjMvimpTYg+iaBOypE1brmSj+zFyORm5UQs7fQkwkEtjY2DDcmYNSiuPjY9y/fx+xWAyLi4tQFAW7u7vY39+HqqpYWlrC2dkZ7t69q5sWRVGQzWYxOTmJaDR6YeNu9sksatvb27h//z6Oj48xNTWlWf339vZAKcW1a9ewt7eH4+Njw7JhfQy/HVMul9PmqQ0baQmTXDnMnjQ7EQdG1wwTl8uF2dlZhMNhFItFnJycIB6PG5rqh8GoCjDGKFvERiWdo4T4UGdXnWhXz/T6nXZWfj4ctlURb4GamJjAxsbGBbckpeebY9+/fx/j4+OYn5/HwcEBXnvtNXz7298GIQQf+9jH8FM/9VO4ceMGvve972FjYwORSARnZ2fahP319XWEQiEEAgHk83nNVUjI+VuShBBtJX2/36/tnbu6uopgMIhXXnkF3/3ud7G7u4vPfOYzuH79Ovb397V1xozKhuWFbcdUKpWQy+WQTCaH3jdKESa5kujNV+hGHDhxQCaEaKb7zc1NPHr0CEtLSwgEAkNP26gLMIYT77sRenMYJfZjNgfKrjD1hJhoRbIqxPhV7Nl5bPmJ4+NjTExMaOFVKhXkcjmtD/H5fHjnnXfw93//9/jCF74A4HydrmvXruHmzZuIxWJ49OgRfD6fFs7h4SHGxsbg8/lwenqqpYfNBePXHuPzt7y8jKmpKXg8Hrz55pv4whe+gMePH+Nnf/Zn8cwzz8Dr9epOuDfqY5gQ29jYQDab1d7sHBZShEmuNHpzJDoVB04dkN1uNxYWFnBycoJcLodoNNryCveguSwCjOHU+y4ZLv2cI8ajJ8CsCjExHPbpdruRSCSQy+UQDAbh8Xi0ifJLS0u4e/cuUqkUvF4v7ty5g7feeksL591338Wrr76Kp59+GnNzc4jFYpifn28790ovfeIct07K0MpDByHn+2JubW0hk8loeRoGUoRJrix6cy66FQdGA7LVjrBfEPLeUha5XA7NZhPz8/MDT89lE2CMURBil63MnYzY9vvhmhT7FL05qwy9/kfPjcnPywoEApiamsLGxgbm5uaQzWaxuLioWYvC4TAODg7w4MEDHB0d4dlnn8XGxgby+Tx+8IMf4NOf/jSmp6c1S9udO3eQy+VweHh4IV9utxs//uM/jkAggFdffRX1eh03b97ECy+8AADIZrN4/Pgxtra28KM/+qM4OTmxVD5GZSNeE4vF4HK5kMlkkE6nhyLEpAiTXGnsdCHoDchOGJTZfAv2xtHm5uZAhdhlFWAMJwsx+eLA4BmEEBOPtUsDf4yFwdqi6JoEzt+WfPfdd3Hv3j2k02mEw2Gsr68jEAhAVVW89dZbyGazCAQC+Mmf/Encv38f+Xwe7777LtbW1pBOpxEMBnF6eoq7d+/i+9//PnK5nDYXjW1p5PP5MD8/j8nJSbz00kuayGIiLJfL4Tvf+Q7u3LmDUCjU4sYUEV2ZVqeTzM7OghCipZvNTRsUUoRJrjz9EmL8/07A7XYjmUwim81ia2sLsVis7+m77AKM4WQhJhk8evO2+m0R0ztXFGJ8eszSSgjB3Nwctra2MDk5iWazif39fUQiERwfH+Pb3/42NjY2EI/H8fGPfxzz8/P4h3/4B2xsbOD73/8+JiYmEIlEoKoqjo+Psb29rW3wvb29jcPDQ6iqioWFBRwdHUFRFLz88ss4ODjArVvvLaW1vb2NN998E//8z/+Mj33sY6hUKrp5FR94O+l/CTnfCs7lcmlCzOfztb3OLuQSFRIJWl8J79V6wMLi/5wCW0H69PS073uqXRUBxuDrEDB8KxQ/MDmt7NlbccMuo37TjzrB3892/RXvlhPrg54bkz8vEokAQMt+kHNzczg6OsK3v/1t7O3tIZFI4EMf+hBefPFFpNNpHBwc4Gtf+xo2NzcBAJFIBJ/+9Kfx2c9+Fl/4whfwJ3/yJ7h16xYCgQBmZ2fxmc98Bs8//3zPZaInLDvpywkhmJ6eRiwWw9raGqrVas9psooUYRIJh91CzIkwIXZycoLt7e2+DIRXTYAxnCbEnIhT3PSDop9CzEp/ZVWwied7PB643W4cHR3h4OAA4XAY5XIZDx48QD6fB3C+QOtrr72GfD6PSqWCs7Mz3L59G/l8Hqenp3C73ZienkY8HgelFF/96leRzWaRSCTwC7/wC/jEJz6BxcXFnspCnAOmJzytQMj5otfxeByZTAaVSmUg7dcWEUYI+S1CCCWERE3OGSeEFAkh/4k79n8SQgqEEGNHr0QyIMRB4TIPoB6PB+l0GsfHx9jZ2bE1r1dVgDGcIMScagXrZOL0ZaJfQox9mokN/k1DNvfL6Hxe3KmqimAwiO3tbRwdHWnzwl5//XUcHh5qWw/9zd/8Db7+9a8jm82iXq+jUCjgwYMH2qbZlFLkcjl861vfwl//9V/j7OwMt27dwqc+9Sk8/fTTmsWNTyd63kEAACAASURBVCuDLebarhzEvHRbvwghmJiYwOLi4sCEWM8ijBCyBOATAPJtTv0DAN8Vjr0E4IO9pkEisQuxs7zMMIvY4eEhdnd3bcnzVRdgDCcIMafRzcTpy8QwhJjesXb9Gz+fKhQKoVQqIRgMIhKJIJPJ4OWXX0a9Xsfx8THeeustfPGLX8QXv/hF3Lt3TwvjjTfewNtvvw3gfJuir3/96/iLv/gLrK2t4Ud+5Efwcz/3c/jIRz4Cn8/XEh8TXcxVXa/X0Wg0LJWDXv3qpg8i5PyN8qWlJWSzWZTL5b62Xzsm5n8WwO8A+P+MTiCEfABADMA/ANBm3VFKX3nyuw3JkEjswcmT6+2GvTWZyWRACMHMzEzX+ZUCrJVhT9Z30j0QJ5I7JV2Dph91Qm8CvpEo488VV8xn6eLT5/V6US6XMT09jWazicePH+PBgweYmZnBr/zKr+CDH3zPhlKtVnHnzh380R/9Ed588028//3vx0c/+lF8+ctfxpe//GVtU242J/Ub3/gGAGB1dRWKoiAcDmNzcxPr6+t48OABpqencffuXaytrXVUDux7LxBCEA6HkUwmkcvlsLS0hHA43Jd625MII4T8PIB1SumbRokjhLgA/CGA/x7Av+klPolkkNjZqJ0ME2Jra2vaBNVO8ysFmD7DEGJOm3MlBVgr4kMef6yXMEUhJtYBvTckmRDj4Y+dnJyAUopgMIg33ngDDx8+RLVaxY/92I/hox/9KD784Q9r19XrdUSjUbz00kvY2trCw4cPcf/+fXzzm9/EvXv3cHh4iEgkgrfeegvFYlG77pd+6ZcQiUTwvve9D8ViEa+99ho+97nPYWpqCo8fP7ZUNqJFkD/WLYSc7zySSqWQy+WwsLBgurl5t7QVYYSQfwQwr/PT7wP4PZy7Is34DQBfoZQWe0k8IeTXAPwaACwvL3cdjkRiBT23wWUePNgcsUwmAwAdCTEpwMwZtkVsmOi5hySdLTXBaCfaRCuXKEz0LGWiEGNzx9h5x8fH8Pv9oJRifX0diqLgmWeewYsvvohUKqUtOREKhRAOh5FOp/HTP/3TeP311wEAhUIBZ2dn2rZDwPnaX7lcTkv3Rz/6USSTSXz84x9HoVDA2toavvKVryAcDuP555/HCy+8gGw2i4mJCUSjUSSTSU0gieVnd9sihCAQCCCVSiGbzYJSiomJCXvj6NbXSQh5HsA/ASg/OZQAUALwQUrpJnfeXwP4MAAVQBjAGIDPUUp/lzvnlFIathr3rVu36O3bt7tKt0TSCVdpIjGbg5HJZDA3N4epqSnLA4MUYO0ZRF1y0oR8WTfaY9VKaDTfqZPw+An54r6R/HGGoij45je/iUAggA996EPaQs+NRgPpdBrRaBRvv/225qYjhGB5eRnFYhGbm5vwer2IRqPY3d3F2dkZms2mbt6uX7+O+fl5qKqKd955B4VCAbVaDaurq5iYmEClUsHe3h6uX7+Os7Mz7O7uolwu4/3vf782T4291dgvKKWo1WrIZDLa4rJdzDV7nVJ6SzzetTuSUnoHwBwXQRbALUrprnDeL3Pn/Nsn5/wuJJIRoB+uAyfC8ifOETPrbOQg2xmsfJjl4TJbxGTdsIYVi5go3o3OtSLA2HFmKePPEc9nlq9qtYpyuYxoNIqpqSkAQDAYxOPHj9FsNrGwsIB6vY5sNoujoyMsLi5idnYWwHl/Mjs7q60zpkcwGNQ24b5x4waWlpagKAomJibg8XigKAqWlpYQDAYxPT2N+fl5KIqCSCSCUqmEer2OUCjU1z6akPNNy1dWVpDJZKCqalfTNvToy4r5hJBbAD5DKf3VNuf9XwD+OwBBQkgRwJ9RSv/3fqRJIukWo3kVl2VgEQfMsbGxFiGmZ36Xg2z3iO4hu8rOKVYwWTc6w0xcmVlP9SxZzJplJMDEONnv/AMCAOzv7+Pw8BAf+tCHsL6+jjt37mjb+RwdHeH4+Bgejwc3btxAMBhEIBBAKBRCoVCA2+3WlsMQ88HHdXp6CkopQqEQFEVBs9mE3+/X4tnb29PSo+dabTabUFUVqVQKgUDgQl7sRk+IRaPR3ueedeuOHCbSHSkZBnoTXkd9gDEaMHnzezwebxFicpDtDj2Lhp31yAkiTNaN7qGUXrBQmVm22KfRXC/+XN7VKIouMb79/X3s7OwgmUzC4/FoYZbLZdy/fx+VSgXPPvssjo+PQQhBIpEAIUQTX41GQ7N8sXQxyy+zAm9tbaFarSKZTMLr9WrxVCoV1Go1AIDP54Pb7dauY7C0er1euN1u7bje2579otFoaG5QtvdkO2x3R0okVw0ji5j426hgNmASQuD3+1ssYuPj4y3XykHWOnpzethxKcAkekKJoVeWvNgShZSepVUUauxcfvFWADg6OtIEGFvDixCCRqOBR48eoVar4ebNm5icnMTMzAxKpRKKxSISiYSWNrbSPp9Wtu4XpRQ7OztoNBq4du0aPB5Pi3Dy+Xyaa5JN5Dd6+GMCjR0blAAD3pu2kc1moapqT/vwym2LJJIOYZ0Y37GNmkXZ6oDp9/uRSqVQKpVwcnJi6RpJK0ZzdS5j+cm60TlG7sJ2ZckLKf4YP+9LPM7HyR9nG21vbGxgeXkZY2NjmtBRFAWPHz9GvV7Hs88+i+npabhcLrjdbiQSCfh8PhQKhZZ88C5J9ud2u3F4eIizszNcu3ZNi4PH7XbD4/HA6/Vqwoq/nv/k8zKM+saEWLlcRi6Xs7SorB5ShEkkXSAKMdHS4WQ6tViwV7SLxaLmgpCDrDXMJkuzY3bVnWHfFynAOkdvzpeRlUoP0frF1zU9ocKLM77fKpfLWF9f1wQYsyopioJsNouZmRl84AMf0KYluFwuLZzFxUWEQiFtCQc+PuA9N+HBwQEODg6wsrLSYuXi083nlVm69KyC/HX8sUHDdh0JBAJ49OgRtra20Gw2O2rPUoRJJD0wamKsW5cRs4itr69rE2ol5rQTYIxehZgT6tyw4x9F9AQYw0hctbter87xbZ53U/ICrFgsIp1OaxPc2dZBhUIB4XAYsVgMY2NjmngC0PKGbzwe15aLYEtR8Gne39/H9vY20uk0vF6vaR6N8sSH54Q6z3C5XJibm8PKygoajQYePnyIra0tNBoNS2mUIkwi6ZF2HYZT6GXODiGkxSJ2dnbmyDw6hU4EGPvstN7wdU1an0YLMwHG6ESI8deI9cLIasQEWD6fx9LSEvx+v2blYr9PTExgfn5eC5u3sPFz2AAgFoshEokgm81CURTtnJOTE2xtbWkCTEyvmG6xTPSEpJU+bJB9MSHnb04uLi7i2rVrUFUVjx49wsbGBur1umkapAiTSGxANIk7TYx10nkZwYTY8vIy8vk8zs7O+pDS0ceqAGN0I8SMrAbDxglpcDpWBBijXd3gBYqeaGH/67nB6/U6crkcFhcXEQwGteNMhLlcLkxOTuqKJr00UkoRi8UwNTWFtbU1NJtNzc2ZTqc1kacnHPlyEfOiZ9HTc9/ydNKO7OynCTlf4icej2N1dRWEEDx+/BilUsnwGvl2pERiI3yH0K7zGhSdigIzCDnfLoRtbJtMJhEMBuXg+4Ruy5oNMnqDql4c7NNJc7CGkY52ZeU0OhFgDL26YXRcr/8RHw4JIahWq8hms0gkEgiHwxfOE69vJ5r466PRKFwuF9555x24XC6srKy0CDAxvSwc8c1QPfesuB2TWRmL15qdx6fNDgg53/x8fn4es7Oz2NvbMzxXWsIkEpvhn96G7aK0U4AxmBBbXl5GLpdDpVJxjMVvmPRa1lbdT+zTScJjmPffSRZnM6yKAz2MXHNmdcbINcmv/8c2pOaFFbuWX3BVzyXI50vMTzAYhKqq2kr3Ri5GPXe6Xp+pd14796xZG9QTYEZh9gIhBB6PB3Nzc4bnSBEmkfQJow5nGAOG3RYTQghCoRCWlpakEIN9YtdsUNWzgDlBiA37vnfixm1Hv9qnHfXDimvOSIixcxuNBnK5HObm5jA+Pt5Sl4z6J6PwRUHEjtdqNWSzWaysrGBiYuJCuHx4omXLSGyKdV5PNHUiwNqVqd2Y3W8pwiSSPqJnFQOGM3D14ykvHA4jkUggl8uhWq0OfUDulW6Est3WRiPxzuJyivhyAlash53Szwclu+pHOyEmns8EWCaTwczMDKanpw3TZSbExDDFvo3tITk/P68t7mwmmpgLUrSEicLQ6De99FoRYGI7Gmb/LEWYRDIARMvFoKxi/e5cmBBbXFxENptFtVq1Nfxh0ElZ6T2l24GZ+0kKsFacLsTEOmIH7YQYv0I9pRTNZhOZTAZTU1OYmZlpK7qMrLD8/6KLsdlsYm1tDbOzs5icnDR9ANW73gjRDamXf/68TgWYXpiD9FhIESaRDJBhuSjtFmJ8ugkhiEQiWFhY0ITYqFrEOhGtnQ4m3aSFIW5N40SGmTa7hJiZFaYbBmFVE+sqq5P8//l8HhMTE4hGoy3niELM7EGRD1d0LSqKglwuh+npaUxNTRmm12qb4eNg65HxeRTz3659WH2QaSdO+4EUYRLJgBm0i1Ivrl4wcleMj49jYWEBmUwGtVrtUguxfgswMd5B7ovXDU5Jm57VpFPsEnR2u6nFcPnwecsXIe9NqldVFdlsFqFQSNvfUE+QGKVVz9LGwmbXMAEWiUS0zaz1XITss115WnE/6v0u/iaGZ9UaOWghJpeokEiGBN8Z6ImafsUnPsV2gpn4YEKMUopsNot0Oq27P5yTMCoLvqzYAKBnNdC71s50jYIL0g7hY0ca7Lwn/D3vpr3YJcD03IBiOvn0iucWCgWMjY0hFou1nC9atfS2SBItV2IchJxva5TP5xEIBFpEnt65vIjTa1dm5WZWfnoCzEhEWr0Pg6zP0hImkQwZPRdIP5++un3CtzLQEUIwMTGBWCyGTCaDer1uS5r7Qbv86z2BO1GADcptYhS307ByT6yUWbcWMSPx0S16woRZu0SrOoNtOeTxeLC4uNgSlujGE9NqZikT+6pisagtTiq2iXbWK/E3MyuWmHcRM+tVtw8yZvHZiRRhEokDEDvTfomxXgYWq+KDEILJyUnMzc05VohZLV+jgYn91o908fE4WYA5DSvtptN21Wl76YcFU+wb2gkRVVVRLBYBnG+uzW9DxKdR73qGOMdKzD+Lw+VyYWFhwdCS3I0Q07O6dVJOLBxRODoVKcIkEgfRrvPqRxxWBpZOxQchBFNTU44UYp26ivjBjT/WaXxs3o6V80dNgA17kLPSbvSEdDdhmwk8Pny7BVg7KKXaVkSKoiCRSLSkXU+k8qvUm7ki+WOqqmJjYwOqqiKRSLTsHymmnU8b/2mUpnZCsx38dfwaZE5GzgmTSByGXuel91uvcYhzN/TC7sX9xoQYpRSZTEabI9Zv9OaG8L91IsD4a8T70sm1YtqMru1GgDn9SX9Q8HVaVdWWuUeMXuqyWXsxE2Dt7rkdqKqK/f197OzsYHZ2VlsHTK+OsLrDv+wh1iczNjc3Ua1WkUqlDAUYHyYfB1+ODP5+icd7QS8uJyJFmETiULoZ9DsNv93A0qv7jRCC6elpUPreZH2v12tPBkzQKy+7BVi7e6I3sHUy2FkNd9iDzLDjZ/BCSJz8zY73Ul567YWPWxQcYrpYGHZCKUWtVsP6+joIIVhZWdFehhGtXu3EYbt0Ukqxu7uLs7MzLC8vdyTA9IQYf65db/8atVejPDkBKcIkEgfT787ESIjZIcD4OGZmZlosYv0UYmYCrJP8GLljABhaWsRr2XVmVpNO8+YkAeYUS4OR0LIqmK1iJsSMjokix67yUlUVu7u72NvbQywWw9TUlK4lyajOGD0kGLG/v4/Dw0Ok02m4XC4oigK3291yjl7ejIQY/70fAsyqtX/YSBEmkYwQgxJidgkwPo5oNDoQIWZHfow6dH7QMBrgzYRSL+LATmFsN04QY+KAbtXCYzVsve8ivHVIT3jz6ewF9vajqqq4du0avF6vqQDqRIiJUEpxcHCA/f19pFIpuN1uKIoCj8cDRVFACDG1iumlic2v7JcFbJSEmJyYL5GMAEbWFDvDZ5/dTkC3Egfb0iSbzaLZbNoWthhPPwWYURz8tfw5VtLHf1pNkxPQs/4MGlEc83TTbng3HqX0whZALExR8IlLRuilw8q9bgd7M5EQgmQy2XYtPj5NevVT7wGDL4ujoyPs7OwgmUxeEHtut7slTDFeHj7v4ny0XmjXNvTasZOQIkwiGRHEjrwf9NuiwYTY+Pj4QIQY/4aUnQKMj6MTASamb5QFmBMQy0aPdmVtJrj469sJrXbY0X6ZAKOUmr6ZqBc3+9SzfhkJlHK5jK2tLSSTSXg8Ht0ydLvdLeXG51VPiIniTwyvE6y2DScLMemOlEhGCPHp0a4BWW8w65f5nhCCubk5UHo+WT+VSsHjsbcrYvlhg5TdAozPC7uWP2YlPivXOlmAWRFAg4y/nRBj14hh6J3XLjw+/k7opf2qqor19XWoqtp2YrxR3Hr3iz/Op4sJvoWFBc31yNoUE10sDcxFadTe9CxtRvXfKmL5t7vWKJ/DRlrCJJIRxM4nunbzKfrx1EgIQSwWQygU0tY1sotuhEs3AowhDixWB29xwLMjH4Ni2GmzEr/oVuStLqy8u7VydWL11KPTtqWqKkqlEhRF6UqA8fGaHefTdXR0hLGxMQSDQRBC4PV64fV64Xa7WzbVZjBxBlycA2ck1vmy66Q8ui1/vXwO2yomRZhEMmLoPWV2i5kAY5/9FGLz8/MIBAK2CbFBCzAG716xUlZMCKiqqlkYeJEwbJFjxrDTZmS15V2KZm5FcQX5TkVUN1ZPnk7bFqUUGxsbaDQaWFpa6lqA8fEbCSL+c2dnB3Nzc1p8zLXPNvDm08c+2Rwx9r+VutKpELNDALNPPq3DQoowiWQEYZ2POBejE6y62qwMFt0+VRJCEI/H4fP5ehZiwxJgPHpP2EZi4ODgANvb2wCgDWz8NU4WYIxhCTDxf3HAN7NwdWt9Yeezz24EAMNq26KUolQqoVarYXl5+cKSEHbD8lQul0EI0axgvBBjeefTzS+2KrYBK/XY6j3pVQCL1zpBiI3snDAj86ZEchVgHRUbuDsdGEWRYOam4DtdvfCthGMGIQQLCwsolUrI5/NdDTZOEmB6ZcaHSSnFzs4OHj16BADwer2YmZnRfu/0ZYJBMSzXDR8n70bkP8Xv7dAb8Ntdb5cA49Ng1raYBaxWqyGZTPYswFhem80marUams0mvF4vgsHgBcvW0dERJiYmWsqZ9TXsQYmvr/zbjuJxMV9m5cGnU6882Kcd5S/GOay2NtIiDHBWJyWRDAIjoSAKAKvXtxuIzAYLOy0D8XhcE2LJZNKy28UJAky0wrBj7JPlRVEU7O7uIpvN4ubNm/B6vcjn83C5XNoWT50MXIOi0zpjR3x638UFcnuJu5O89EMAsPj02halFJubm6hUKkilUqYCjF2nKAoajQbq9Tqq1SoajQaq1Srq9bp2jOWVLWvRaDQAAOl0GnNzc1rcx8fHSKfTF9IKvDf3i1ni9dppt/VYT3TpPczYXef4OMR09JuRFWGAFGKSq0c7oSBaKvR+NxJwVoSYXhx2dYwulwsLCwtYX1/XLGLthJgTBJiqqtjc3MT+/j6SySTC4XDLb7y1cnNzE8ViEc888wxCoRAAYHl5GdlsFgAwNTXVcfz9pts602kcet/5eiUO0FYeONphJS+DEgB8PSyXy2g2m0gmkyCEaEKqVqtpgor9z6xaiqLA6/XC4/HA5/PB7/djbGwMkUgEPp8PY2NjGBsbu+A2PDk5wbvvvovt7W1cv35dWwlfb59XUYgxcWhmSe+1PBiDKn876lVH8Q/DvNwrt27doq+99lpLo3FSpyWR9AMrQkHP/SUONEaDmpX2JJ7Xj46RXwvJbCKyEwQYpe/N2ZmdnUWxWEQikUA4HNbCZS60nZ0dFAoF3Lx5E4FAoOW3er2OQqGAeDze4gYaNnbUGbOw9b7z4bSrh3ZYxPj4zayZdtZzFq6qqpr1qlaroVKpIJfLIZfLaYujNhoNbc5gIBDA2NhYi8hiAsvr9XZtRVUUBdlsFrlcDl6vF6urq4jH423TbxQXs5T1Ul7iQ98gxnm76xUPIeR1Sukt8fjIWsIGZRaXSJyA1c7ByFrA/693fScWMXaeOBfELlwuFxKJBAqFgjYYiULMKQKsWCyiXq8jlUrB5XIhmUwim80ikUggEolo4TEB9txzzyEYDAIAms2mFncwGEQ6nUYmkwEARwixdmXTTR+sZ001snaZwcdtl0VMz/rCx2E1fFYezWbT1IJVr9c1ER4IBOD1euHz+bCwsICVlRVNcI2NjcHj8fRVhLjdbqysrKBWq+FLX/oSFhcXDV2NQPv7ZEc6ze5Jv7C7XllhZEUYIIWY5GrQjVAw60zaCTgrrhn2W7/aHSEEgUAAjx49gtvtblkd3AkCjK3bVCwWsbS0pA2QgUAAqVQK2WwWS0tLCIfDODo6wv7+Pp5//nkEAgEtLo/Hg2azCbfbDUII/H6/JsQIIRgfHx9af9ap6LdSZ5joYC4xMYxOGYQQo/S9LXbYMTb3irkC9dyDiqJAVVX4/X54PB74/X74fD4Eg0FMT09rFixmvXLCuMV2r/jVX/1VnJ6eanW42z1e7RAww3ARDlqIjbQIA6QQk1xuehEK7NxO3rYza096FrV+tDtKKXZ3d3F4eIgPfOAD2NjYwPr6OhYXFy0LSjE8uwXY+vo6isUims2m5sKZnZ3VXEapVAq5XA6hUAjlchnXrl3D2NhYS8dOKdV2CmDx+3y+FovYMIRYp2XTrs4cHx/jwYMHqNVq8Pv9UFUViUQC8XjcljWvWDziMavwbuNGo6EJrHq9jkql0iK4Go1Gy9wr3j0YiURa3INMXHeTpkFDKcX6+jpmZma0v93dXTx+/BipVAo+n6+rPNglYAYlwBiDFGIjL8IAKcQkl5Ne5yeI17NjnQyq/Cd/vRimne2u2WyiUCjgmWeegc/nw9LSEgqFAkqlUsvAPSwXJC/AFEWBoijIZDJwuVyIRqOaRSyZTGJ3dxfpdBo+n68lDD5ePn5CCHw+n2ZNI4S0uDX7TbdlY1Rntra2sLa2hqeeegqTk5Nwu90ol8t4+PAhjo6OcOPGDdvXvuLToKoqms2mJqT4z2q1imaziWq1qp3n8Xjgdrs1IeXz+RAOhzE9Pa0JLnZOJ+XjZCil2N/fh6IomJ2d1fIUjUbh9XqRyWSQSqXg9/uH/kAwSOwQ+JbiGZSv1U5u3bpFb9++feG4OBhchgYiuZr0U4B1OrdFfCrUczfZ2e4opdje3sbJyQlSqZS2b102m4XP59MsYp2m324LmLiw7MTEBFZWVjA+Pq7Fb1ReDLP4K5WKNr8sHA7b2p/pieZe6xwfBgBsb28jk8nghRde0Bb9ZCiKgvv376PRaODpp59usbTw5cNWv2d/jUZDm0unqirq9brmRmPWK+YOrFar2pupvFuQvT3I5mB5vV7NcqUnri77uFKtVpHJZLCystLysACc5/3k5ATr6+tIJpMIBAKW89/r5Hw76qMd2HX/icHEfFtEGCHktwD8BwCzlNJdg3PGAdwD8PeU0v+REBIE8DcArgFQALxEKf1dK/EZiTDg8jcYyeXHbgEmWoo7FWJs8rDZ3JV+CLGtrS2cnp4ilUppr8Tn83n4/X7E43HTODoRYFaseIqiIJ/PY2NjQ7N+6eH3+3Hz5k2EQiFbyqFcLiOXy9kqxPTcyuL/vcRD6fkio4VCAS+88II2D06E3c9isQi/369ZOGu1Gg4PD+H1ehEIBNBsNkHI+Zw5t9sNVVU14cTSysQU++OFlh1zri7ruKIoCh4/foy5uTlMTk7qnkMpxenpKQqFApLJ5AVBbUSv1vFu+qt+Ycf9NxJhPbsjCSFLAD4BIN/m1D8A8F3h2H+glH6LEDIG4J8IIT9LKf1qj+kBYNzRSCROhm/sgH0CjA/PaudoZC3Ru87uKQGEnG/wTSlFNptFKnW+YGUymUQul8PGxoahEOtUgLE/o8GaWcAIOV9QtlAoGKY7GAxq87zsgLk1+yHE+LmCLP9Ab24YSt9bC+3555+H3+83rDPsbdLFxUWcnZ1p4orNpSKEtCy7oBcXu7d695r9b0d52V2/nQC7V4FAABMTE4bnEUIQDoeRTCaRz+c7qoe9llUn/VU/6ef9t2PvyM8C+B0AhiY1QsgHAMQAfJ0do5SWKaXfevK9DuCHABI2pEdreHwHKw5uEonT6HXwsCLA2Ge79iA+xPCdodF1fJrtam9zc3MIBALI5/Pa4pDJZBKVSgWbm5sX4ujGBcn2w2Of4m+lUgmKomBpaQlLS0tYXFzUFQZTU1NYXV3V5s7YUQaEnM8vW15eRqFQwNnZWVdh8n0gf4/YBuKi66jdvTaKY2NjQxNgbC20duF4PB6Mj49jcnIS4XAYgUBAe5uQLwcxfXr3WLSc2Nnv9yvcYcDcjKenp22tysB53oPBIJLJJIrFIk5OTvqefzFNwy7vft3/nkQYIeTnAaxTSt80OccF4A8B/LbJOZMA/msA/9RLeoQwL4gxicSp2PX03s6dZEWI6QmwboSY2Xnt4K1TCwsL8Pl8yOfz2mreyWQSZ2dn2NraaklTpwIMgGZ5YfOOWHjMAtZsNrX9LD0eDxKJhLbaPYMJMH7OjJ1CjA2A+Xy+JyHGPvmN3wkhF5b/6NQVxARYqVTSBJjew7BResT6Bbw3p0jvYZovY7009rP/H3ULGHD+8sv6+jqWlpYsW27ZA0EqlcL6+jqOj48HIsTEejFM+iHE2oowQsg/EkLe1vn7eQC/B+B/axPEbwD4CqW0aBC+B8B/BvAfKaVrJun4NULIbULI7Z2dnXbJZtdoHYyTbqREwmOnALNyvZlI0BsYxfCtCrFurCnsfHGgXVhY0PZZZEIslUrh9PQU29vbE/85iQAAIABJREFUXQswPasY+1tfX4eiKBc2FGdv0rHrJycnsbq62jJXpt9CrFwuX7hvRlZBUeTwdc3tdmsCjFnFFEVpKbd2UHq+a0CpVMJzzz0Hv99veq74qSf0eQHGC2O9+2lUvnbfAz4PvbTTYUMpRaFQQDQaNZyvZwQh761nt7GxgcPDQ9N+wA6cZkyxW+B3PTGfEPI8zi1X5SeHEgBKAD5IKd3kzvtrAB8GoAIIAxgD8Dn6ZBI+IeTzAE4ppf+z1bjNJuYb0emTnUTCw7cTO+uPXQLMjrj542ZpsSJuOjnP6jXMNdhsNrUFUtk6XeFwGLFYrKVzbDQa2kKT7dKoKIpmDaOUaq5Ovf0rm80mMpkMSqUSxsfHcf36dW0ivl747NOO+0spxdnZmbbJORN+VkQoAO2FAv44e/GCwYSZ1XtcKpWwubmJ5557TtsYmv3GhyGmRa9MROHIvrvdbt12YqV87boH3dRnp0Hp+Rp8JycnSKfTPZVFvV5HJpPB7OwspqenTcvejnrvtPG703pFDCbmd+2OpJTeoZTOUUpTlNIUgCKA9/MC7Ml5v0wpXX5yzm8D+EtOgP0fACYA/C/dpqOLdDtCTUtGj24tO2bhDUuAiXHqWU3aXWe3RazdIMdck263G4VCQVv/aXx8HMfHx9je3tbC2d/fx4MHD3B6eto2Pl6EUHq+DhilFIlEQrccPB4P5ufnEY1Gsbq6aijA+DzYaRELhUJYXl5GLpdDpVJpqUNiWYvHeJerXnp4z0G7e8fKanNzEzdv3mzZ8FnvXvJlYCbAWBrY/3x6xHPZd7M6a8c9uAwCDDhfjmJ3d9ewbluFkPM3UldWVrC7u4u9vT3DcrWjv3SaNQywr23bMTH/AoSQW4SQP2tzTgLA7wN4FsAPCSH/Sgj51X6k50l8I9twJMOnU0HRjmELMIYoxKymxW4hZjbIiYIhFotBURSsra0hm81qc8QODw+xvb2Nvb09PHz4UPvUm0PFh8fWhyKEYGNjA263W3NB6nWulFKEQiE89dRTlt4S65cQW1paQjabRaVS0Y7zZW10jC9Pvg6yMhBFkt69o/R838zt7W0899xz8Pl8LeeZCRbRImZ0Ddu02kjI8WFZvQdG4tOMyyLAKKXY2dnB3Nxci2DuhbGxMaTTaezv72NnZ6evQsyJ2NG2L9VirWZ02mglEj3s6JCdIsB4us2X1eusiCyjMJj1hrkF2Wrnr7zyCuLxOJ555hm4XC5Uq1W8/vrr8Pl8qFarWhlPTEzgqaeeuuC6460sqqqiUCiA0vdckHp9Ri/9iN19EKXn6zcVi0WkUiltfo+epYnSc5cryxdbe4v9zgQPnz7A2K1ZKBSwt7fXYgETy5Vdr5d3MTy9+8+3ETHf4v2zUlZ8HFbvwWURYMC5K/rdd9/F9evXbV1GBThvk9lsFuPj45ibm7sgeu3q58T65RSstG1itztyFJECTNIrvVrEnCjAgO7z1atFzGiQE601/LXNZhP5fB7ve9/7EAqFUCqV0Gg0UCgUsLq6inA4DK/Xq4XF9gPUs/5QSjUBRgjB0tKSFr/RU263/Ug/LGLhcBiLi4uGFjH+j71c4HK5tK13mPWLd/kZiU0WTj6fvyDAzNALSy8Ovoz4fOiFxX63Uo56dczKtZdJgAHA2dkZfD6f7dtEAYDX60U6ncbJyUnL0jH9KjOnGY96adtXRoQ57aZJRpduBYs4gDitUx+GEDMTYPzcJfbm3tnZGd555x3EYjFMT08jkUigXq/jlVdeweTkJGKxGK5du4aJiQl4vV6EQiHcuHFDW4ySzf/i05LL5UAIQSKRaHnCNrMIdXvv9CyAvUDI+d6SvBATRaZePngLkjgom4mkXC6H/f190zlgohWRD0MUWfx8vE6sr6KVz6gc2wkpvbXhrFw3ipyenvZ1H1KPx4NUKoVyuYxSqdTS1q4C3QqxKyPCxM5PIukFK8JDtETYbZrvJ6wD7acQ41ds1xtQ2VZF7I/tpeh2uzWx0Ww2Ua/XEQqFcHJygmazCa/Xi5mZGTSbTUxPTyMYDOpuM8Q2Cne5XNp+lO3ujd33zmpnbXYeE2ILCwvIZrOo1Wq61/H5E8WomCfxfqqqimw2i6OjIzz77LPwer2mYlq0xBlZtayUuRHthJiZyGfwLwC0ezgYZSg9d12Hw+G+xsOEWL1ebxFiduH0vlNPiLVr31dKhHXzlC+RGGFViOld40REAdQvi1i7+NkfW8kdON9PMJfLIR6P4+mnn0a1WkWxWEQ2m8XMzAyef/55VKtVlEol7O3tIZvNwuVyYXt7G/v7+9raXryLkndB6lm6jNxyvWAURzu3mLiQrAghBOPj44jH48hkMtom1uw3vQeBdrD0KYqChw8f4vT0VFuGwqpg0Ss3PWHYKXrizoqQ0rPuWbHOjjq1Wg2UUtM13OyCvdjSbDZRLBZN62232GFF7hdG/YcRV0aEAVKISezHrE7xVgenW8CMLCZ2CzEzt5UovNixarWKN954A6qqanNa4vE4Hj58CEVRMDU1BZfLhevXr6PRaGBtbQ31eh3NZlPbJPrg4EALX1EUFItFeDweTYDplYOZAOtmENATYKzMjMLjLYZ8XTIq+4mJCcTjcdy7d0+zFoplzN+ndqiqinv37qFcLuPZZ5+Fx+O5IB6tWprE37ppD3qiS0/QivHwcYvXtLPOXgaOjo4wPj4+sDwxIQacv8Rht0VsFBD7QiOulAgDpBCT2I9RndITNU7EaHC22omImJWHOGjzAydbqZ0NhpTSFgvY3t4eisUiarUaCoUCXnjhBfh8Pm3FfJfLhbm5ORweHsLj8WByclJbTHV7exvZbBabm5u4e/cuCDlfhV9Ms1geZgJMHOz1jom/mdUBvfB4AWZFiAHQXJP37t3T3hIVtymyUicVRcGdO3egKAqef/75FtHMp5GVn1gGRiKzlwcSsa7qxSW6Wvl0GsWt9+BxWaCU4ujoyHST7n7gcrmQSCTgdru1nS7swKoF2Sm0q1NXToQBUohJ7MdMeDhdgDHMBqdOOzy98tCzmpiVW6VSQS6XQzAYRK1Ww82bN7G7u4tXX30VMzMziEajWF5eRrlcxvb2NlRVxebmJt73vvdhamoKwWAQ165dQzgcxvz8PL761a/ij//4j3F8fKwNDsD53DAjMaEnzvh8iMLL6H+j+W/sU8+SoyfA9KxNYrwulwuzs7NYXl7GvXv3tDlivPWx3b1sNpt46623QAjBCy+8cGENMZZmcU6VmUjr1SIsCjD2Kd4TcfkCq23RSIiPOswV2ekWRXbA5luOjY0hl8vZJsRGBSsPO1dShAFSiEnsR28gdbIA42mXzl6FmJmbhw3mfBqYBSwYDOLs7AzxeByhUAjhcBiKomh7J7KFWnd3d/H9738ffr8f09PTSCaTqFQqODg40Cwje3t7uHbtGp566qmW+Pn1sfi88rD/rYgp9l08zosr3uonWh/58mLfeUuWWIZ68TOrYCKRwL1791rmw7W7l0yAud1uPPvssxcWTGVbPPH3T0wbb5GyYgVsh174ZkKsW+ubaBEb9XGBPZhMTU0NLQ2EEMTjcfj9fmSzWW3f1V7DHKV7JEWYAVKISfrJKAgwK09qVgdvq/EB+q47JjgqlQoymQxCoRDK5TIWFxfh8/mQy+WwuLiIn/iJn8DGxgZKpRIIOd8/0u12IxwOY2xsTFsH66mnnsLx8TFKpRIePHiAj3zkI/jUpz6F3d3dllX0ecsJEzu8MNMTU3zZ8b/pWVP44+xtznq9jmq1esFNyNLAvjPLAS/c9BYoFeNhwjYWiyGZTCKXy6HRaLS9l0yAeb1e3Lx5Ex6P50IZ8G5JUQyK8Yv3vps6pCfA+DDF/PDHurG+2VnfhwmlFFtbW6CUIhqNDrUvYkIsFAohk8mg0WgMLS1Ow95lc0cQsRPt9YlNcnXhO+tREGCdoGcdaocoQkTBtbu7i+3tbZTLZbjdbm3A39/fBwBsb28jGo2iXq/j9u3b8Pv9ODs7AyHnW+y89dZbePz4sbYWmN/vRy6XAwBEo1G43W4kEgm89NJLiEQiePHFFzXLWT6fByGkZbKyOHlYz8LD54s/xn8X73uz2cTBwQHW1tbg9/s1N6iiKKjVapiamsLi4iKCwSBUVdW2S2o2m/B4PC3HzMrY6Pjs7CxcLhcymQxWVla05SVEQckE2NjYmGYB0zuPj4P/NBNnTDiahdcOozZlFG6vDwu9pHXYUEpxcHCAk5MTrKysOGKFeUIIYrGYVhfT6TS8Xm9P4QEX5yWOGldehAFSiEl6p1O3xyjSaacnWiXYsWq1irW1NVSrVYTDYdy4cUMTG81mE9evX0e9Xsfx8TEODw9x+/ZtTE9PI51Oa0/0lFKUy2W8/PLLqNfr2vpHyWQS2WwWADA5OYn79+9jdXUV9XodGxsbSCQS8Pl8SKVSyGazSCQSGB8fvyBm+PvIb5kkloFRX8Ef29jYwP7+PtLpNILBIOr1OlRVRSQSweHhITY2NlAul1tWM2cCTHS78XGblbFoOZqZmQGAlsGP7++azSbu3LkDn8+nbQPFrtcLj13Lz1vjz+fTKYoz0bpkpa1YsdaKokm0aFqNyyzMUWjXlJ6vCba1tYWVlRXbtyjqBfZQQAjB2toa0um0bftYjuq47Zy7M2SkEJN0y1UQYIxOhJjeIFatVrG1tQUASKVS8Pl8ODg4wN7eHo6OjlCtVhEKhTAzM4Pp6Wmsrq5q57lcLuzv7+Po6Ag+nw+xWAw/8zM/g7/9279FJpNBLBYDpRRzc3PIZDL44Q9/iFgshhs3bqDZbOLtt9+Goii4fv06vF4vFhcX8a//+q+Yn59HIpHQRI84Z8vtdsPr9WqWukajgWazqVmyPB6PNtCxQV9VVW1C/ObmJtLpNEKhENbW1rC+vg6/349nn30Ws7OzqNfrODw8xNjYmGbx8vv9F/ohM1FgJsDY95mZGVBKLwixZrOJH/zgB5iammoRYHx4ophh30VLoFVx1ok46sSNyMfP50O0jHUT5qgIMbYEy/Lysm0Cx04IIYhGo3C5XC1CrJtyFcftUUSKMA4pxJwLmytUr9cBnK/M7PP5WvYIHAZXSYDxWBmU9KxKxWIRjUYDCwsLaDQa+N73vofPf/7zePDgAQ4PD7Vzl5aW8OEPfxi/+Iu/iNXVVXi9XmxsbOCv/uqv8LWvfQ3pdBq/+Zu/idXVVTz11FN49913cXh4qFm1Njc3cXh4iGQyiYODAyiKAo/Hg7t37yISiWB+fl4TGF/60pfw4osvYmlpCR6PB9VqFdVqVZuP5fP5EA6HEQqFoKoqjo6OUKvVtD/mSnW5XJolq9FooF6vg5DztbsikQh2dnbw53/+5/iXf/kXfPKTn8TCwgKmp6fh9/txenqKjY0NEELg8/m043rWML25T6ycjeZOsWPRaBSUUmSzWaTTaVBK8dZbb2FychI3bty44EY0Elp695i/zqiumIkjO9qOKPZEy103fXuvrs1Bwtz8kUhkKG9DWoUQgunpac01mUqlul5IdtTdklKECUgh5hwopajX69jd3cXx8TG8Xi98Ph+Ac3cNe/WaHef/vF6v7gRmu9PHPq+iALM6gLLzKpUKTk9PkUgkQAjB1772Nfzd3/0dfvCDH2BiYgLpdBoTExPY29vD5uYmXnrpJayvr+PXf/3X8cILL6DZbOLw8BDr6+sIh8Oo1+uglCIejyMYDOL09BQAUKlUEIvFsLi4iNPTU+3tQp/Ph6WlJbz55pt45513EAgEEAqF8MlPfhJHR0fI5/MYGxuDx+OB1+vVBFWtVsPh4aE2sd3v92uWsYmJCW1hWOC9if1erxeTk5OglMLn82nCZ2xsDO9///vxyU9+UnOtRiIRVCoVbaHaWq2GR48eQVEUzM/PY2FhQUsLb5kS3XpmAoy/F7Ozs6CU4tGjRzg+Psbk5CRWV1cviA0jocdbmvTqAnBxkVa9uqPnuuy1DRlZ7noRYnpi1Kmw+Yerq6sAnC1MCCGYnJwEIaRFiHWb1lGyVvJIEaaDFGKd0e4puNOyY+JrZ2cHJycnmluKWQX4eBRFQb1e16wSh4eH2pYtbrf7gjhjLh87Onv2eZUEGMNo8NWzvrDzDg4O4Ha7MT4+jjt37uAb3/gGXn75ZYyPj+NjH/sYnnvuOUxNTWFnZwff+c538Prrr+Oll17C9evXMTExgfHxcd20BAIBVKtV1Go1NBoNBAIBhMNhxGIxqKqK09NTHBwcIBKJaG9QstX0y+Uyjo+P/3/23jRGluu8+/ufXqeX2adnX3qWe6+ou3AbX0qyTMkWTVmOYUKJ8kKxrEBIHDkQ9CWW4SgyEgQQ4A95LTgxjMRQDESQLQUxHVuWbEayZO0SKV6KyyXFS1Lkna1nX3t63+rkw9xTPFNT1WtVV1X38wMGM1NdXXXq1Klz/vU8z3kOxsbG0NfXp7o8T09PkcvlwBhDKBTCzMyM+rkIeK5UKggEAshkMiiXy2r5RILUQCCAw8NDnJ6eIhAI4OTkBGNjY1haWsIDDzyAYDCIbDaL4+NjpNNptc2Gw2FMT0/j4OAAR0dHiEQi6O3tVd2helYxub5rtUXGGAYHB/Hqq69iYmICS0tLVYPw9Sxh1eK85JcfrXWu2jbxu9lnqR7LnbytGQHm9Of8+PgYfX195+LAnCJM9OpcWIoZY1hdXcXc3BxCoVDDZa32AuF0SIQZQELsfMcoYmQURUEmk0E6nVYtEUZv5MCZ2zAQCKgCSI67KRQKKBaLqgVA/uGcY2hoCJcuXdIVTeJ/EY8TDofPnV9RFJRKJVWcpdNpHB4eolQqwePxqGWSf0THVes+d7MAE9deLpeRzWaRzWaRyWRQqVQwNzeHYDBoKMSOj48RjUaRzWbxrW99C7dv30Y0GsUTTzyBP/zDP8Ti4iIURYHP58PVq1fxla98BV/+8pfx1FNPYX5+Ho8++uiF8pTLZbz55pu4desW7ty5g1KphP7+fiwtLeHxxx9HpVLBm2++iWeeeQb33Xcfbty4gaWlJQSDQayvr+P27dt45ZVX8OCDD+K+++6D3+/Hj3/8Y7z66qs4ODiAx+PB5OQkHn30Udy4cQOhUAh37tzBq6++inQ6jeXlZTz//PPIZDK4ceMGKpUKdnZ2UCwWsby8jJ/+9Kcol8vqmouRSAQAcHR0hMHBQWxsbOCZZ57BnTt3kM1mEQ6HMTMzg8cffxxzc3Pw+XxIJpPw+XyIRqO6YkDM6qzX8lssFvHyyy9jdnYW8/PzF4LwtfdOi54A17M+iX3rza3WCtVctEb9d61zu02Acc6RyWQwPDyse/2AM6+BMaa+4KytrWF2dhbhcLgpIQa4S4ABJMKq4tab2ihCZAmLkshjJNwslUrlXDLNcDiM/v5+dcA1+hFCSBw3m82qgsvj8SAYDCIcDqvxNIyd5RbyeDyqO7EZGDtLYeD1es/FGYiOSBZn+XweyWRSFZSBQOCCQBNBo9pBp5oAk/fT+3EblUoFuVxOFV6KoqjuvImJCRQKBTXOSLiMZRhjyOfzGB4eRrFYxKuvvor9/X3MzMzgd3/3dxGLxfD666+jUCjg8uXLuHbtGh5++GF8+ctfxltvvYWdnZ0LKSRyuRy+/e1v46mnnsKzzz6r5ggTwfKvvvoqPvShD+Hw8BB/+7d/i8XFRfz+7/++6qr52c9+hq997Wt45ZVXsLi4iDt37uDFF1/EV7/6VTDGVFGeSqXw4osv4nd+53fw0Y9+FC+99BKeeuop/PKXv8TExAT29/cxNTWF/v5+JBIJvPjii1hdXcXExAS2t7fVrP3JZBI//elP4ff78eCDD+KFF17Ad7/7XXz7299WLbSlUgn5fB537tzBRz7yETz00EM4PT1V43xEXQIXRUKtgVZYmF9++WV1tqnRy02t48nPgjbOS3xXz2pW7Xh612R0HdpyGIkl7fUYfaZ3DjcJMODtmcdyLJieYG73teiJe719otEoZmZmVCEWiURaEmLy/06GRFgd1HK5uAHRqciiSPwIAeL3+1UBItw2IvalGYuPSJrplABRUX4htMSgBrwtROV6OT4+RrFYVK1nQhjWElhad4vckbvVcubxeNDT04NoNIrR0dELs5nEm6vIRaU3K6tSqSAUCqnT59PpNCKRCN7xjncgEokgkUigv78f29vbmJiYwNjYGMLhMFKpFE5PT9V2KhCDTiAQwKVLl3Dz5k14vV48++yz+O53v4sf/ehHeOSRR9Db24tgMIhf/OIXeO2111QX38svv4zbt2+jUqlgeHgYHo8HlUoFQ0NDePDBBzE+Po5kMom/+7u/wwsvvICZmRl89KMfxcnJCba2trC1tYWxsTE88sgjuHr1KhYWFvDmm29ic3MT29vbGB8fx6/+6q/i+vXriMfjeOaZZ7C1tQW/349CoYBcLqcudHzz5k1EIhG89tprePLJJ/HMM8/goYcewiOPPIKenh5ks9kLgqIeN5/Ynk6nsb+/j93dXUxNTV1YuFym0YFb3l8ui544k78j06hlTC5fPWJJb3CuJlbdJsAA4PT09JxFX+AEIVYPjDFEIhE1j9/U1BR6e3ubKqubvFckwmqgbcBuurkCzs8yJx8dHcHr9apCq6enB/39/efchG66LjMRlg+fz6e6jIDz4rVSqahLtogf2UKo/ZGP3QnUGohFILpIgSALMVGPIgVDPp9Xc2FFIhF1huHh4SE454jFYuoM2Fwup6aFkPH5fJiensbNmzdRKpXw6KOPolgsIpVK4fvf/z62trZQKBRw5coVvPe978XXvvY13L17F7/85S8xPj6ON954A+l0Go888ghmZ2fh8XiQTCYBAO9+97sxOjqK1dVV/Mu//Av29vawt7d37vzRaBTvfe978eEPfxj33XcfcrkcfvKTnwAA+vv78f73vx9PPPEElpaWcHp6ipdeeunc98fHx/Hggw9iZmYGjz76qHq9X/va17C3t4fj42P1JUaUS65LUe9G4iyTyWB/fx8HBwcAzhLYPvDAA3UFP9cauPWscEb7abdpaVSAGVk76v1utfO5VYBxzrG/v4/x8fGqlks3CLFwOKyu8jA5OXkuoXK9xzDb3W0lJMLqQM+k7YabC5yVd3t7G7lcDpcuXToX3E7URgxysqCg+tOHsbOAb60Qk61X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\n",
"text/plain": [
"<Figure size 720x720 with 1 Axes>"
]
},
"metadata": {
"needs_background": "light"
}
}
]
},
{
"cell_type": "markdown",
"metadata": {
"id": "nN7BUT4XoXGT"
},
"source": [
"\n",
"\n",
"# La librería que utilizamos para el mapa base se llama contextily\n",
"\n",
"En este link: https://geopandas.org/en/stable/gallery/plotting_basemap_background.html \n",
"\n",
"Hay algunos ejemplos.\n"
],
"id": "nN7BUT4XoXGT"
}
]
}
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment