Skip to content

Latest commit

 

History

History
187 lines (176 loc) · 6.5 KB

MAPPROXY.md

File metadata and controls

187 lines (176 loc) · 6.5 KB
Raw

INAV Configurator MapProxy setup

There are several different approaches to setting up MapProxy service. All that iNav needs is a working MapProxy WMS URL and the name of the layer that you want to use for caching

Generic MapProxy Installation Guides

https://mapproxy.org/docs/latest/install.html Unix Install Guide

https://mapproxy.org/docs/latest/install_windows.html Windows Install Guide

https://hub.docker.com/r/yagajs/mapproxy/ Docker image (untested)

Linux MapProxy virtual machine setup instructions

  1. Using virtualization platform of your choice, install a base 14.04 LTS Ubuntu server http://releases.ubuntu.com/14.04/ubuntu-14.04.5-server-i386.iso

  2. Use NAT networking so that the virtual machine can download maps while online

  3. Create a mapproxy user (this can be done during installation)

  4. All commands executed as mapproxy user from mapproxy user home directory

  5. Choose defaults for everything else unless you want to change anything

  6. After installation, update all packages and reboot

    sudo apt-get update && sudo apt-get upgrade && sudo reboot

  7. Set a static IP so that your iNav proxy URL does not need to be updated

    # get dhcp ip address and host gateway
mapproxy@MapProxy:~$ ip route get 8.8.8.8 | awk '{print $NF; exit}'
192.168.145.133
mapproxy@MapProxy:~$ cat /etc/resolv.conf | tail -n 1
nameserver 192.168.145.2
mapproxy@MapProxy:~$ route
Kernel IP routing table
Destination     Gateway         Genmask         Flags Metric Ref    Use Iface
default         192.168.145.2   0.0.0.0         UG    0      0        0 eth0
192.168.145.0   *               255.255.255.0   U     0      0        0 eth0
mapproxy@MapProxy:~$ sudo vi /etc/network/interfaces
# replace existing eth0 section with this:
auto eth0
iface eth0 inet static
    address 192.168.145.20
    netmask 255.255.255.0
    network 192.168.145.0
    broadcast 192.168.145.255
    gateway 192.168.145.2
    dns-nameservers 192.168.145.2
# reboot to apply changes
mapproxy@MapProxy:~$ sudo reboot

  8. Install ssh server so you can connect from host

    sudo apt-get -y install openssh-server

  9. Connect to virtual machine ssh using mapproxy@192.168.145.20

  10. Install python-virtualenv and dependencies

    sudo apt install python-virtualenv python-imaging python-yaml libproj0 \
   build-essential python-dev libjpeg-dev \
   zlib1g-dev libfreetype6-dev libapache2-mod-wsgi apache2

  11. Update pillow and install mapproxy

    sudo pip install pillow 
sudo pip install MapProxy

  12. Initialize MapProxy server

    # check that mapproxy is installed
mapproxy-util --version
# create inav config
mapproxy-util create -t base-config inavmapproxy
virtualenv --system-site-packages mapproxy
source mapproxy/bin/activate

  13. Update apache wsgi.conf

    sudo vi /etc/apache2/mods-available/wsgi.conf

    so it looks like this:

    WSGIScriptAlias /inavmapproxy /home/mapproxy/inavmapproxy/config.py
WSGIDaemonProcess mapproxy user=mapproxy group=mapproxy processes=8 threads=25
WSGIProcessGroup mapproxy
# WSGIPythonHome should contain the bin and lib dir of your virtualenv
WSGIPythonHome /home/mapproxy/mapproxy
WSGIApplicationGroup %{GLOBAL}

<Directory /home/mapproxy/inavmapproxy/>
  Order deny,allow
  Require all granted
</Directory>

  14. Create wsgi config file

    vi inavmapproxy/config.py

    with the following content:

    from mapproxy.wsgiapp import make_wsgi_app
application = make_wsgi_app(r'/home/mapproxy/inavmapproxy/mapproxy.yaml')

  15. Enable wsgi and restart apache

    sudo a2enmod wsgi
sudo service apache2 restart

  16. Test your MapProxy instance using web browser on host, you should see a demo link http://192.168.145.20/inavmapproxy/

  17. Open iNav Configurator, connect to your flight controller

  18. In upper right corner click on Application Options (gears icon)

  19. For MapProxy URL use: http://192.168.145.20/inavmapproxy/service?

  20. For MapProxy layer use: osm

  21. If everything is working you should see a map in the GPS and Mission Planner tabs

  22. You can change your server configuration by editing

    mapproxy@MapProxy:~$ vi ~/inavmapproxy/mapproxy.yaml

    After editing configuration, restart apache

    mapproxy@MapProxy:~$ sudo /etc/init.d/apache2 restart

  23. Some additional sample configurations, use at your own discretion (change layer in inav to layer from configuration)

    # mundialis openstreetmap wms example
services:
  demo:
  wms:
    md:
      title: MapProxy WMS Proxy
layers:
  - name: osm
    title: mundialis
    sources: [osm_cache]
caches:
  osm_cache:
    grids: [webmercator]
    sources: [osm_wms]
sources:
  osm_wms:
    type: wms
    req:
      url: http://ows.mundialis.de/services/service?
      layers: osm
grids:
    webmercator:
        base: GLOBAL_WEBMERCATOR
    # google maps hybrid example, use inav_layer in configurator as layer name
services:
  demo:
  wms:
    md:
      title: MapProxy WMS Proxy
layers:
  - name: inav_layer
    title: Google Maps Hybrid
    sources: [inav_cache]
caches:
  inav_cache:
    grids: [inav_grid]
    sources: [inav]
    cache:
      type: file
      directory_layout: tms
sources:
  inav:
    type: tile
    url: http://mt0.google.com/vt/lyrs=y&hl=en&x=%(x)s&y=%(y)s&z=%(z)s
    grid: inav_grid
grids:
  inav_grid:
    base: GLOBAL_MERCATOR
    origin: ul

  24. You can use any map provider that is compatible with MapProxy, and once you zoom in on the region you will be flying in, the map tiles will be cached for offline use. You can test this by disabling your internet connection and browsing the demo URL in a browser

    https://wiki.openstreetmap.org/wiki/WMS#OSM_WMS_Servers OpenStreetMap WSM servers

    https://lpdaac.usgs.gov/data_access/web_map_services_wms # USGS currently has 400+ WMS layers

    • You can use QGIS to browse different providers and pick the maps you like for your iNav layers https://qgis.org/en/site/

    • There are many government and public WMS providers available in different regions worldwide