Overview
========

In this lesson, we will continue to learn how to manipulate and analyse spatial data using Geopandas, Shapely and other
relevant Python packages. First, we will learn how to geocode addresses, i.e. convert addresses into coodrinates.
Next, we will focus on spatial queries and we will learn how to join data based on spatial information. Finally, we will conduct
nearest neighbor analysis between a set of points.

Learning goals
--------------

After this weeks' lesson you should be able to:

 - Geocode data, i.e. transform addresses into coordinates
 - Conduct point-in-polygon queries
 - Make spatial joins
 - Conduct nearest neighbour analysis (finding the closest point).

Sources
-------

Lesson materials are partly based on documentation of `Geopandas <http://geopandas.org/geocoding.html>`__, `geopy <https://geopy.readthedocs.io/en/stable/#>`__,  `Pandas <http://pandas.pydata.org/>`__,
`Shapely <https://shapely.readthedocs.io/en/stable/manual.html>`_, and `Lawhead, J. (2013), Chapters I and V <https://www.packtpub.com/application-development/learning-geospatial-analysis-python>`_.

Lesson videos
--------------

.. admonition:: Lesson 3.1 - Geocoding

    .. raw:: html

        <iframe width="560" height="315" src="https://www.youtube.com/embed/1f4xS1PUzvE" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
        <p>Vuokko Heikinheimo, University of Helsinki <a href="https://www.youtube.com/channel/UCGrJqJjVHGDV5l0XijSAN1Q">@ AutoGIS channel on Youtube</a>.</p>




.. admonition:: Lesson 3.2 - Point in polygon, spatial join, nearest neighbor analysis

    .. raw:: html

        <iframe width="560" height="315" src="https://www.youtube.com/embed/EqpFVXBDCe8" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
        <p>Vuokko Heikinheimo, University of Helsinki <a href="https://www.youtube.com/channel/UCGrJqJjVHGDV5l0XijSAN1Q">@ AutoGIS channel on Youtube</a>.</p>



.. admonition:: Lesson 3.3 - Intro to exercise 3

    .. raw:: html

        <iframe width="560" height="315" src="https://www.youtube.com/embed/Yr-DzFVoghg" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>
        <p>Vuokko Heikinheimo, University of Helsinki <a href="https://www.youtube.com/channel/UCGrJqJjVHGDV5l0XijSAN1Q">@ AutoGIS channel on Youtube</a>.</p>