How to add a basemap - PIX4Dreact


Custom basemaps

PIX4Dreact allows the user to use its standard basemap and to add a different basemap by connecting to a tile service.

Default Basemap provider

In PIX4Dreact, the standard Basemap provider is MapBox.

Changing the Basemap provider

To add a custom Basemap provider:

1. In the Dashboard screen, click SETTINGS.
2. In the APP SETTINGS section, click Basemaps.

3. Select Your custom basemap.
4. Type or paste the URL for the map service. 

Supported arguments

Note:  Generally, the URL has this format:{z}/{y}/{x}.  For more information:  Tiled web map.

The table below describes the arguments supported on PIX4Dreact:

Arguments Description


X position of tile

{y} or {-y} Y position of the tile, starting at the top/north. Use {-y} if the origin is at the bottom/south (TMS).
{z} Zoom
{r} Scale value. Can be used to add "@2x" to the URL to load retina tiles
{q} Quadtree
Bounding box coordinates for WMS Urls.
{s} Subdomains a,b,c.

Use python and QGIS to add an orthomosaic as basemap in PIX4Dreact

  1. Create a local server using python:
    • Create a dedicated folder on the windows machine (e.g. “Local_Basemap”).
    • Open a windows console and navigate to the folder “Local_Basemap”.
    • Execute the following command: "C:\Program Files\QGIS 3.16\apps\Python37\python" -m http.server (check that the path to where python is installed is correct).
    • The console will show the following message: Serving HTTP on port 8000 ( …  The URL of the local server will be http://localhost:8000/
  2. Generate XYZ tiles from the orthomosaic that you want to use.
    • Open QGIS and load the orthomosaic.
    • Click Processing> Toolbox> Raster tools>Generate XYZ tiles (Directory)
    • Fill in the following parameters as follows:
      • Extent: the orthomosaic.
      • Zoom level range: it depends on the ortho size, but 12-19 should be ok for all cases.
      • Tile format: JPG.
      • Output directory: save into the folder “Local_Basemap”.
      • Output html: give a name and save it in the “Local_Basemap” folder (to test if the tiles were created correctly).
  3. Open PIX4Dreact and add the following URL http://localhost:8000/{z}/{x}/{y}.jpg in the custom basemap section.
Was this article helpful?
1 out of 4 found this helpful

Article feedback (for troubleshooting, post here)


Article is closed for comments.