QGIS
Last updated
Last updated
This plugin allows you to interact with the Jakarto environment directly from QGIS. Five tools are available to you:
The point-by-point validation tool () allows sequential browsing of selected points on the map. This tool enables viewing one or more images from Jakartowns at the active point's coordinates and assigning a numeric status (from 0 to 9) to that point.
The preview and proximity validation tool () allows viewing one or more images from Jakartowns at clicked coordinates on the map. This tool also allows interacting with the nearest point — to assign it a numeric status (0 to 9), move it — or create a new point at those coordinates.
The open Jakartowns at these coordinates tool () opens Jakartowns centered on the coordinates clicked on the map.
The add Jakartowns URL to an inventory tool () adds a URL for each entity in a vector layer containing points, allowing you to open Jakartowns centered on the entity.
The center the map using a Jakartowns URL tool () centers the map on the coordinates corresponding to a URL copied from Jakartowns.
Open QGIS.
Open the About window: Help -> About.
Note the Python version used by QGIS.
Go to the download page.
Enter the folder for the most recent version of the plugin.
Select and download the ZIP file corresponding to your operating system (windows for Windows systems, macos for Mac OS systems, and unix for UNIX systems) and the version of Python used by your QGIS. Example for Python 3.10 on a UNIX system:
In QGIS, open the Plugins window: Plugins -> Install/Manage Plugins.
Open the Install from ZIP tab.
Navigate and select the ZIP file downloaded earlier.
Click Install Plugin
The Jakarto plugin tools should now be visible in the toolbar. If not, restart QGIS to apply the changes.
The point-by-point validation tool is designed to facilitate the visual validation of point elements in an inventory:
Select the points to validate on the map.
Browse the points and assign them a numeric status (0 to 9).
🔵 Status selection 🔵 allows you to define the active point's status either by clicking the corresponding button or using the numeric keypad on your keyboard. Note that once defined, the active point's status is shown in green.
🟢 Status field selection 🟢 allows you to select a field in the active layer to store the points' status. If the field is not selected, a default field JAKARTO_STATUS is added to the active layer when the first status is assigned.
🟠 Navigation 🟠 allows you to move to the next or previous point by clicking the dedicated buttons or using the keyboard arrows. The distance of the observed point from the camera and the capture date are also indicated.
🔴 Random point selection 🔴 allows you to randomly select a defined number of points from the active layer for inspection.
🟣 Attribute display 🟣 allows you to display an attribute related to the active point (selected using the dropdown menu) directly in the plugin window. To display all attributes of the active point in a separate window, check the Display all attributes box.
🟡 Go to Jakartowns button 🟡 allows you to view the object at the active point's coordinates directly in Jakartowns.
Several options related to image selection are available in the Options tab of the tool:
Temporal filters (temporal_filters) allow setting the image capture time range by defining a minimum (from) and/or maximum date (to).
Selection of the number of neighboring images (k neighbors) defines the number of images to pre-select before applying selection filters.
💡Tips:
If an error appears asking you to check the filters applied to the image selection, increasing the number of neighbors (k_neighbors) usually resolves this issue.
Sorting method for candidate images (sort candidates by) allows defining whether displayed images are selected — among the previously defined k neighboring images — from the closest to the active point (distance) or the most recent to the oldest (time).
⚠️ Warning:
Sorting images from most recent to oldest may result in displaying images far from the active point.
Neighbor positions allows defining which images to display based on their position relative to the active point. A parameter of 0 shows only the first image after sorting the candidate images. If the parameter is greater than 0, two additional images corresponding to the defined positions are displayed alongside the first image. The larger the selected parameter, the greater the spacing between the capture positions of the displayed images (see illustration below). A higher parameter increases the chance of an oblique view of the object (indicated by arrows for images at positions 1 and 5).
💡Tips: Increasing the Neighbor positions parameter can help with validating objects perpendicular to the street, such as traffic signs, but it also increases the likelihood that an object far from the street will be obscured by obstacles. Selecting this parameter carefully can greatly improve the plugin's usefulness.
Image layout (Stacked) defines whether three displayed images are stacked vertically or arranged horizontally.
Context adjustment (Context) defines, in meters, the dimensions of the bounding box around the object, delimiting the portion of the image to display around the point. The larger the selected value, the more context is included in the image.
Vertical offset adjustment (Vertical offset) allows modifying the height of the view. By default, the horizon of the image is approximately 3 meters high, corresponding to the camera's relative elevation on the vehicle. To view objects close to the ground, the height should be lowered. The farther the vertical offset is from 0, the more the image will appear in a bird's-eye view.
The Draw ellipse option adds, or removes, an ellipse centered on the active point in the image.
The Clear cache button allows clearing locally cached images to ensure that the displayed images correspond to the selected filters.
The preview and proximity validation tool allows, like the point-by-point validation tool, viewing an object at specific coordinates. However, unlike coordinates defined as those of a point in a geographic layer (as in the point-by-point validation tool), these coordinates correspond to a position clicked on the map by the user (hereafter referred to as the "active position"). Thus, the preview and proximity validation tool offers the possibility of viewing an object located at the active position. It also allows acting on the nearest point to the active position:
by assigning it a numeric status (0 to 9).
by repositioning it to the active position, an action that is accompanied by assigning the moved point a status defined by the user.
This tool also allows adding a point at the active position. In this case, a user-defined status is assigned to the point.
💡Tips:
The preview and proximity validation tool was originally designed to facilitate inventory validation using tile data produced by Jakarto and available as a WMTS stream. This service can be integrated into QGIS by following the instructions on this page.
⚠️ Warning:
Moving a point is an irreversible operation once the tool is closed. We strongly recommend always keeping a copy of the original data before making modifications.
The steps to use this tool are as follows:
Click a location on the map to activate the tool.
Use the tool to view various locations on the map and, if desired, act on points in a geographic layer.
🔵 Active layer selection 🔵 allows defining the layer to edit. It is possible to leave the layer to edit blank. In this case, the tool will only be used to view images relative to the active position.
🟢 Status field selection 🟢 allows selecting a field in the active layer where the status of edited points will be stored.
🗨️ Important:
For security reasons (since potentially irreversible changes can be made to the data with this tool), the status field must be manually selected and will not be automatically created. A field of type integer must therefore be created in advance by the user.
🗨️ Important:
No changes can be made to the data if the active layer or status field is not selected.
🗨️ Important:
No other layer than the active layer can be modified unless selected using the dropdown menu.
🟠 Status selection 🟠 allows defining the status of the nearest point to the active position either by clicking the corresponding button or using the numeric keypad on your keyboard.
💡Tips:
It is recommended to define a symbology associated with the status field to view the points' status in the active layer since this tool does not display it.
🔴 Move the nearest point 🔴 allows moving the nearest point to the active position to the active position's coordinates, either by clicking the dedicated button or using the keyboard shortcut (A). The moved point will receive the status indicated in the dropdown menu.
🟣 Add a new point 🟣 allows adding a new point to the active layer at the active position's coordinates, either by clicking the dedicated button or using the keyboard shortcut (D). The added point will receive the status indicated in the dropdown menu.
💡Tips:
Applied to an empty layer, adding points can quickly create an object inventory directly in QGIS.
🟤 Special actions 🟤 allow:
Undoing the last action performed with the tool by clicking the dedicated button (Undo) or using the keyboard shortcut (W).
Redoing a previously undone action by clicking the dedicated button (Redo) or using the keyboard shortcut (S).
Moving the active position to the coordinates of the nearest point to view its exact location, by clicking the dedicated button (Jump to nearest object) or using the keyboard shortcut (Q).
🟡 Go to Jakartowns button 🟡 allows viewing the object at the active position's coordinates directly in Jakartowns.
The options of the preview and proximity validation tool are similar to those of the point-by-point validation tool. Only two notable differences exist:
Temporal filters can be defined from an attribute field in the active layer (in the Settings tab, select the date field using the dropdown menu and click use dates from this layer).
Defining a maximum distance to act on the nearest point remotely. Setting this parameter to 0.0 cancels the effect of this filter.
This tool opens Jakartowns with a view centered on the coordinates clicked on the map in a new window or tab of the default web browser:
Click on the map at the location you want to view in Jakartowns.
This tool allows adding for each entity, in an open geographic layer of points in QGIS, a field containing the Jakartowns URL that opens Jakartowns centered on the entity's coordinates:
Select the layer to which the Jakartowns URLs will be added using the dropdown menu.
Name the field that will contain the URLs.
Click OK.
This tool allows pasting a URL copied from a Jakartowns window to center the map on the coordinates observed in Jakartowns:
Paste the URL.
Log into your Jakarto account using the dedicated tool ().
Click on the icon .
Click on the icon .
Click on the icon .
Click on the icon
Click on the icon .
