Overview
========

During this week we will learn a few really useful and commonly used GIS functionalities using Geopandas, namely:

1. :doc:`Geocoding <geocoding>` / `Geocoding in Geopandas <../../notebooks/L3/geocoding_in_geopandas.ipynb>`__
2. `Conducting Point in Polygon queries <../../notebooks/L3/point-in-polygon.ipynb>`__
3. `Making Spatial joins <../../notebooks/L3/spatial-join.ipynb>`__
4. `Finding Nearest neighbour of a geometry <../../notebooks/L3/nearest-neighbour.ipynb>`__

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

After this weeks' lesson you should be able to:

 - Do geocoding, i.e. converting addresses into Points
 - Conduct Point in Polygon queries
 - Read data from KML files
 - Make spatial joins and table joins between layers
 - Find the nearest neighbour for Point -objects.

Sources
-------

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

Lecture videos
--------------

.. admonition:: Lesson 3.1 - Geocoding addresses; Point in Polygon queries

    .. raw:: html

        <iframe width="560" height="315" src="https://www.youtube.com/embed/Y78osvKYoLo" frameborder="0" allowfullscreen></iframe>
        <p>Vuokko Heikinheimo & Henrikki Tenkanen, University of Helsinki <a href="https://www.youtube.com/channel/UCGrJqJjVHGDV5l0XijSAN1Q/playlists">@ AutoGIS channel on Youtube</a>.</p>


.. admonition:: Lesson 3.2 - Spatial join; Nearest neighbor analysis; Exercise 3 overview

    .. raw:: html

        <iframe width="560" height="315" src="https://www.youtube.com/embed/7yCmi71RAzQ" frameborder="0" allowfullscreen></iframe>
        <p>Vuokko Heikinheimo & Henrikki Tenkanen, University of Helsinki <a href="https://www.youtube.com/channel/UCGrJqJjVHGDV5l0XijSAN1Q/playlists">@ AutoGIS channel on Youtube</a>.</p>