DOC: Add zorder example to docs

[Sangarshanan]

Closes #1224

[codecov]

Codecov Report

Merging #1228 into master will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master    #1228   +/-   ##
=======================================
  Coverage   89.89%   89.89%           
=======================================
  Files          21       21           
  Lines        2088     2088           
=======================================
  Hits         1877     1877           
  Misses        211      211

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 22b5a0d...a75a3c3. Read the comment docs.

[martinfleis]

Hi,
sorry for a slow response. I would prefer using our naturalearth_cities and naturalearth_lowres datasets for this example.

cities = geopandas.read_file(geopandas.datasets.get_path('naturalearth_cities'))
world = geopandas.read_file(geopandas.datasets.get_path('naturalearth_lowres'))

You don't need to import matplotlib, as you can make axis using one plot and reuse it for another.

ax = cities.plot(color='k')
world.plot(ax=ax)

ax = cities.plot(color='k', zorder=2)
world.plot(ax=ax, zorder=1)

I would also make a note than lower zorder = lower layer. Thanks!

[Sangarshanan]

Sure...Will do that

[martinfleis]

Few minor suggestions, otherwise it looks good. Thanks!

[Sangarshanan]

Thanks for helping out : )

[martinfleis]

Oh, one final thing. You need to tell sphinx that images should be saved. And you were right with the header type before. My bad. I can't push changes (as you did not allow it), so pasting the correct version below.

Control the order of multiple layers in a plot
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

When plotting multiple layers, use ``zorder`` to take control of the order of layers being plotted.
The lower the ``zorder`` is, the lower the layer is on the map and vice versa.

Without specified ``zorder``, cities (Points) gets plotted below world (Polygons), following the default order based on geometry types.

.. ipython:: python

    ax = cities.plot(color='k')
    @savefig zorder_default.png
    world.plot(ax=ax);

We can set the ``zorder`` for cities higher than for world to move it of top.

.. ipython:: python

    ax = cities.plot(color='k', zorder=2)
    @savefig zorder_set.png
    world.plot(ax=ax, zorder=1);

[Sangarshanan]

Oh... I have allowed edits from maintainers

I will make the change tho... Thank you for your patience

[martinfleis]

Thank you @Sangarshanan!