What is EcorisMap?

EcorisMap is an app used for recording and verifying location information with smartphones or tablets during outdoor surveys and the like.

Main Features

• Display and record location information on the map.
• Load any maps published in map tile format.
• Import and set labels and colors for data created in GIS in GeoJSON, GPX, KML, KMZ formats.
• Set the items you want to record, and use forms like lists and checkboxes.
• Export recorded data in CSV, GeoJSON, GPX formats.
• Use in offline mode in places without internet connectivity.

Website https://ecoris-map.web.app
Terms of Use https://ecoris-map.web.app/terms_en.html

Quick Start

Main Screens

Home	Adding Features	Map Selection	Map Settings

Layer List	Layer Settings	Data	Data Editing

Procedures

A. Preparing the Map

1. Press the map selection button on the home screen.
2. Select the map you want to display on the map selection screen.
3. If you want to add a map, either add new map settings or select from the map settings list.
4. Download the map if you want to use it offline.

B. Preparing the Data to Display

1. Press the layer list button from the home screen.
2. Press the import button and import the data (GeoJSON, GPX, KML, KMZ) you want to display.
3. Change the data style (color).
4. Select the field name to use for labels if you want to display labels.

C. Setting up Recording Layer

1. Press the add new button on the layer list screen to create a layer for recording data.
2. On the layer settings screen, add layer name, style, fields and save.
3. If you want to edit an existing layer, press the layer settings button to edit.

D. Usage On-Site

1. Turn on GPS and move to your current location.
2. Switch to offline mode on the map selection screen if you want to use it offline.
3. Press the track button to start recording if you want to record tracks. Press again to stop recording.
4. Switch to edit mode for the target layer on the layer list screen if you want to record location information.
5. Select the add current location button or drawing tool on the home screen to add points, lines, or polygons.
6. Enter field values and save on the data editing screen.

E. Exporting Data

1. Select a layer from the layer list screen to display data.
2. Select data and press the export button.

Basic Operations

Home

On the Home screen, you operate the map and various function buttons.

(1) Map Selection Button
Opens the map selection screen.

(2) Track Recording
Press the track button to start recording. Press again to stop recording. Tracks are recorded to the line type layer that is in edit mode. The total distance is recorded in the cmt field. (If there is no cmt field, it will not be recorded)

(3) Layer List Button
Opens the layer list screen.

(4) Select Draw Tool
Displays tools for adding and editing points, lines, polygons, and map memos.

(5) Settings Button
Opens the settings screen.

(6) Compass
Switches between North-Up (North is up) and Heading-Up (Direction of travel is up) on the map.

(7) Zoom
Changes the map scale. You can also change it by pinching in and out on the screen.

(8) GPS
Activate the GPS to display your current location. Upon activation, it enters the current location tracking mode. If you drag the map, the tracking mode is deactivated, so press the GPS button again to re-enter tracking mode. Pressing the GPS button while in tracking mode will turn it OFF. Tapping on the current location marker will display the coordinates and accuracy. The color of the current location marker changes based on accuracy: red for accuracy <=10m, orange for 10m< accuracy <=15m, and gray for accuracy >15m.

(9) Display Attribute Information
Displays attribute information of features.

Map Selection

In the Map Selection screen, you select and set the map to display.

(1) Map Selection
Select the map to display. Maps with transparency settings can be overlaid on top of other maps. You can change the order of overlay with the button on the right.

(2) Map Settings Button
Opens the map settings screen.

(3) Download Button
Opens the map download screen.

(4) Import Map Settings
Imports map settings.

(5) Add Map Settings Button
Opens the new map addition screen.

(6) Export Map Settings
Exports map settings.

(7) Toggle Offline Mode
Switches between offline mode and online mode. Offline mode displays maps downloaded in advance from cache. Use in places without internet connectivity.

Map Download

In the Map Download screen, you download maps for offline use.

(1) Map Download
Move to the necessary area and range, then press the download button. Maps covering that area from zoom levels 0 to 16 (vector tiles are 0 to 18) will be downloaded. The download button is displayed at zoom levels 11 to 14.

(2) Map Deletion
Deletes downloaded maps. Downloaded areas are displayed in orange.

Map Settings

In the Map Settings screen, you register and set map tiles.

(1) Map Name

(2) Map Tile URL
Enter in the format like https://example/{z}/{x}/{y}.png. Please read the map terms of use to determine if you can use it. For vector tiles, it supports pbf and pmtiles formats. For pbf, enter in the format like https://example/{z}/{x}/{y}.pbf. For pmtiles, enter in the format like https://example/sample.pmtiles or pmtiles://https://example/sample. If the pmtiles is in raster format, uncheck "Vector Tile".

(3) Attribution
Please provide attribution according to the map terms of use.

(4) Transparency Setting 0 (Opaque) to 1 (Transparent)
Maps with transparency settings can be overlaid on other maps. Use it when you want to overlay a shaded relief map, for example.

(5) Fixed Zoom
At zoom levels larger than this value, the map at the fixed zoom level is enlarged and displayed.

(6) High Resolution
Displays the map of the next zoom level. Use it when you want to display a detailed map in a wide area, such as with the Geospatial Information Authority of Japan's standard map.

(7) Y-Axis Inversion
Check when loading TMS style (Y-axis origin is at the bottom). The default is XYZ tile (Y-axis origin is at the top).

(8) Delete Settings
Deletes these map settings.

(9) Vector Tile Style
When specifying a vector tile in the map tile URL, you can specify a style file. The style file conforms to the layers item of the MapLibre Style Spec, but only basic items are supported. See style_sample for supported styles. If you do not specify a style file, it will be displayed with default settings.

Layer List

The Layer List screen displays a list of layers, and provides access to their data and settings.

(1) Display Toggle Button
Toggles the display of layer data.

(2) Style Button
Opens the layer style setting screen.

(3) Edit Checkbox
Selects the layer to be put in edit mode. When adding or editing points or lines, the layer in edit mode is targeted. Layers of the same type (points or lines) cannot be in edit mode simultaneously.

(4) Data Verification
Tapping the layer name opens the data screen for that layer.

(5) Label Setting
Selects the field name to be displayed as a label. Choosing custom allows the creation of a label combining field values. Enter the format as Field1|Field2 for custom fields.

(6) Layer Settings Button
Opens the layer settings screen.

(7) Data Import Button
Imports data in GeoJSON, GPX, KML, KMZ formats. GeoJSON supports point, line, and polygon data with latitude and longitude. GPX supports waypoint and track data. Files can also be directly opened in EcorisMap for import.

(8) Layer Settings Addition Button
Opens the layer settings screen to add a new layer.

Layer Settings

In the Layer Settings screen, set the layer name, type, and data fields.

(1) Layer Name
Enter the layer name.

(2) Style Settings Button
Opens the style settings screen.

(3) Type Selection
Selects the type. Supports point, line, polygon, none. Polygon is read-only. 'None' is used for recording data without location information.

(4) Field Addition Button
Adds a field.

(5) Field Name
Enter the field name.

(6) Data Format
Selects the data format. Supports string, serial number, datetime, date, time, time range, integer, decimal, numeric range, list, radio button, check button, photo, table, list table, reference.

(7) Field Deletion Button
Deletes a field.

(8) Default Value, List Item Settings
Sets default values for string, integer fields. Sets candidate values for list, radio button, check button, table, list table.

(9) Display Order Change Button
Changes the display order of fields.

(10) Layer Deletion Button
Deletes the layer and its data.

(11) Save Settings
Saves changes to the layer settings.

Style Settings

In the Style Settings screen, set the style (color) of the layer.

(1) Line Width
Specifies the width of lines and the border width of polygons.

(2) Color Type
Selects how the color is applied. You can specify single color, category, or individual. Category colors by field value. Individual is used in map memo functionality.

(3) Transparency
Sets the fill transparency for polygons. 0 (Opaque) to 1 (Transparent). Setting transparency to 1 displays the border of polygons.

(4) Field Name
Selects the field name when Color Type is category. Choosing custom allows specifying color by a combination of field values. Enter the field names as Field1|Field2 in the custom field.

(5) Color Ramp
Selects how colors are automatically picked when Color Type is category. Currently, only random is supported.

(6) Auto Fetch Button
When Color Type is category, automatically fetches field values and sets their colors according to the color ramp. For custom fields, it automatically fetches the combination of field values entered.

(7) Color Addition Button
When Color Type is category, manually adds color for a field value.

(8) Color Setting
Selects color using the color picker.

(9) Color Setting Deletion Button
Deletes the color setting for a field.

Field Value Settings

In the Field Value Settings screen, you can set the default values for fields, and the candidate values for lists and checkboxes.

(1) Value
Enter the default value or the values for lists and checkboxes.

(2) Value Addition Button
Adds a new value.

(3) Add 'Other' Value
Adds an 'Other' value.

(4) Value Deletion Button
Deletes a value.

Data

In the Data screen, you can view a list of data, and access and operate on individual data items.

(1) Display Toggle Button
Toggles the display of data. The header button toggles all data.

(2) Data Selection Checkbox
Selects data to be deleted or exported. The header checkbox selects all data.

(3) Change Ascending/Descending Order
Tapping the field name changes the data display order to ascending or descending.　Also, by long-pressing and dragging the data, you can change the order of the data.

(4) Data Entry/Edit
Tapping the data opens its edit screen.

(5) Data Addition Button
Adds new data. The default coordinate values are 0,0.

(6) Deletion Button
Deletes selected data.

(7) Export Button
Exports selected data.

Data Editing

In the Data Editing screen, you can enter and edit data.

(1) Layer Name
Displays the name of the data layer.

(2) Field
Enter or select values according to the field type.

(3) Photo Capture Button
Captures a photo.

(4) Photo Selection Button
Selects a photo.

(5) Photo Display/Delete
Tapping the photo displays it enlarged. You can also delete it.

(6) Coordinate Display Toggle Button
Toggles the coordinate display between decimal and sexagesimal.

(7) Move to Data Button
Moves the map to the data location.

(8) Google Map Button
Displays the data location on Google Map. Useful for accessing route information.

(9) Deletion Button
Deletes the data.

(10) Save Button
Saves the changes to the data.

Displaying Attribute Information

Displays attribute information for points, lines, polygons, and vector tiles.

Information for Points, Lines, and Polygons

(1) Info Display Button
Select and tap the feature to display attribute information.

(2) Data Toggle Button
Displays the next data in the same layer.

(3) Display Area Change
Swipe to change the display area.

(4) Close Button
Closes the display screen and shows the home screen.

Information for Vector Tiles

With the info display button off, tapping the vector tile features displays information in a popup.

Adding & Editing Location Information

Adds and edits points, lines, polygons, and map memos.

(1) Point Tool Display Button
Displays the point tool.

(2) Line Tool Display Button
Displays the line tool.

(3) Polygon Tool Display Button
Displays the polygon tool.

(4) Map Memo Tool Display Button
Displays the map memo tool.

Adding and Editing Points

(5) Add to Current Location Button
Adds a point at the current location. With GPS on, tap the screen.

(6) Point Addition Button
Adds a new point at the tapped location.

(7) Point Move Button
Long press the point, then drag to move.

(8) Point Deletion Button
Deletes the tapped point.

Adding & Editing Lines and Polygons

Line	Polygon

Editing Methods for Lines and Polygons
There are plot tools for tapping to create lines or polygons, and freehand tools for dragging to create lines. Long-press the button to switch tools.

A. Plot Tool

1. Select the line (or polygon) you want to edit with the feature selection button. (Skip steps 1-3 if creating new)
2. Switch to the plot tool.
3. Tap the line you want to edit.
4. Tap the screen to plot the line.
5. To move existing nodes (2), drag the nodes.
6. To add nodes in between, tap on the line.
7. To delete a node, tap the node.
8. To finish editing, tap the starting node (3).
9. To create a new line, tap the screen to add new line nodes. Repeat steps 3-8 for editing another line. Press the cross (4) on the line starting point to exclude from editing.
10. Press the feature save button to complete editing.

B. Freehand Tool
1-3 are the same as the plot tool.
4. Drag the screen to draw the line.
5. To modify an existing line, trace the line part you want to modify.
6. To finish editing, tap the starting node (3). For polygons, if the ending and starting points are apart, it closes with a straight line.
7. To create a new line, drag the screen to create a new line. Repeat steps 3-6 for editing another line. Press the cross (4) on the line starting point to exclude from editing.
8. Press the feature save button to complete editing.

Adding & Editing Map Memos

Adds and edits map memos written on the map. Memos are saved to layers with line types in edit mode. Selecting the tool hides the layer labels, and changes style settings to 'Individual'.

(1) Pen Selection Button
Allows you to write memos on the map when selected. Long press to select pen thickness. To move the map, deselect or use two fingers to tap.

(2) Eraser Button
Select and trace the memo to erase memos on the map. The eraser erases intersected lines.

(3) Color Selection Button
Selects the pen color.

(4) Undo Button
Undoes one step of editing.

(5) Redo Button
Redoes one undo step.

(6) Draw with Apple Pencil Only Button
When on, drawing is only with Apple Pencil. Finger touch moves or zooms the map.

Exporting and Utilizing Memos
Export from the data screen like regular lines. Fields include _strokeWidth (line width), _strokeColor (line color), _zoom (zoom level at the time of writing).

Settings

The Settings screen allows you to make various settings and refer to manuals, etc.

(1) Save Data to File
Saves the current data and settings to a file in ecorismap format.

(2) Load Data File
Loads data and settings from a file in ecorismap format.

(3) Clear Data
Clears current data and settings.

(4) Clear Map Cache
Clears the map cache and downloaded files.

(5) Open Source Licenses
Displays the licenses of open source software used in this app.

(6) How to Use EcorisMap, Terms of Use
Displays how to use (this site) and terms of use.

(7) Version
Displays version and change history.