Location settings

Open the location and press “Location settings” at the top of its page, beside Refresh (see The location page). The settings page opens for two kinds of people:

• The location's owner: the account that created it.
• Admins: people with the Admin level on the location.

Everyone else is turned away:

• Managers: the Location settings button is there, but pressing it opens a page headed “Forbidden” that says “You do not have permission to access this location settings page.” At the moment only the owner and Admins can use the settings page, so ask one of them to make the change.
• Users and Viewers: the button is not shown. Opening the settings page from a bookmark or a shared link gives them the same Forbidden page.
• Anyone with no access to the location: the page answers “Page Not Found” with “The page you are looking for does not exist or has been moved.” The same happens for a location that has been deleted.

Both of those pages have “Go Home” and “Go Back” buttons. On the settings page itself, “Back To Location” at the top returns you to the location's page, and the browser tab reads “Location Settings - ” followed by the location's name.

The cards come in this order, from the top:

1. Location Settings: the name and the group.
2. Location on map: the map position.
3. Add new user to (location name) with permissions: giving someone access.
4. The table of people: everyone with access, and their level.
5. Danger zone: deleting the location. Only the owner sees this card.

A location's group is a free-text label for gathering locations together, such as “Greenhouses”, “Open fields” or “Cold stores”. It appears in four places:

• All Locations: the list under Locations in the side menu puts locations under a heading for each group. Locations without one sit under “Ungrouped”.
• The dashboard filter: on the dashboard, “Dashboard Filters” in the side menu holds a “Location Groups” list. Choosing a group shows only the sensors at locations in that group, and “All location groups” shows everything again.
• The location's page: the line above its name reads “Locations / Greenhouses”.
• Location details: the Group row of the card at the bottom of the location's page.

CropWatch matches groups by their exact text, so type a group the same way on every location: “Greenhouse” and “Greenhouses” make two separate groups. A location's group has nothing to do with a sensor's group, which is set on the sensor; see Sensor settings.

The “Location on map” card sets where the location is. The position puts the location on the map on its page, and soil sensors use it for sunrise and sunset. The card's own line sums it up: “Click the map or drag the pin, or use one of the options below.”

There are five ways to set the position, and you can mix them. Each one moves the pin and fills in the Latitude and Longitude boxes under the map:

• Clicking on the map, or dragging the pin.
• The Use my current location button.
• The Centre on my devices button.
• Pasting coordinates or a Google Maps link.
• Typing the latitude and longitude.

When the location has no position yet, the map shows the whole of Japan with no pin. Zoom in towards your site and click on it: the pin drops where you clicked, and if the map is still zoomed out, it zooms in around the pin.

• Clicking the map: moves the pin to where you clicked. Over the map, the pointer becomes a crosshair.
• Dragging the pin: fine-tunes its position.
• Zooming: use the mouse wheel, the plus and minus buttons in the top left corner, or pinch on a phone or tablet.

The Latitude and Longitude boxes follow the pin, to six decimal places, which is about 10 cm.

Three buttons and a paste box sit above the map.

• Use my current location: takes the position of the phone, tablet or computer you are using, so it is meant for when you are standing at the site. Your browser first asks whether CropWatch may know your location; allow it. The button spins while it waits, then the pin moves and a note says how close the position is: “Located to within about 12 m. Drag the pin to adjust before saving.”
• Centre on my devices: puts the pin in the middle of the sensors at this location that have their own map position, which they get when they are added. Sensors without one are left out. When none of them has a position the button is grey, and pointing at it shows “None of this location's devices have coordinates yet.”
• Paste coordinates or a Google Maps link: reads a position from text. Paste into the box and press Apply, or press Enter. It understands a pair of numbers such as “31.9147, 131.4232” or “31.9147 131.4232”, degrees with compass letters such as “31.9147° N, 131.4232° E” (S and W count as negative), and a full Google Maps link copied from the browser's address bar.

Short Google Maps share links, the ones starting maps.app.goo.gl, do not contain the coordinates. Pasting one gives “Couldn't find coordinates in that. Paste "latitude, longitude" or a full Google Maps link (short maps.app.goo.gl links don't include coordinates).” Open the short link in your browser first, then copy the long address from the address bar.

If Use my current location fails, a yellow note says why:

• “Location access was blocked. Allow it in your browser's site settings, or set the pin on the map.” Permission was refused. Allow location for CropWatch in the browser's site settings, then press the button again.
• “Couldn't get your current location. Try again, or set the pin on the map.” The device could not work out where it is within 15 seconds. Press the button again, or use another way.
• “This browser can't share its location.” Use another way, or another browser.

The Latitude and Longitude boxes take decimal degrees, the format Google Maps shows. The empty boxes show examples: “e.g. 35.6762” and “e.g. 139.6503”. Use a full stop for the decimal point. Places south of the equator have a negative latitude, and places west of Greenwich a negative longitude.

A wrong value is flagged under its box as you type, and Save Changes stays grey until it is fixed. The table shows what each case looks like.

Three buttons finish the card:

• Save Changes: saves the position and the zoom. A green “Location coordinates saved.” confirms it, and the location's page shows the new spot from then on.
• Reset: puts the boxes and the pin back to what is saved, without saving anything. It is grey when nothing has changed.
• Clear: empties both boxes and removes the pin. It only shows while there is something in the boxes. Press Save Changes afterwards to remove the saved position; a green “Location coordinates cleared.” confirms it.

Once the position is cleared, the location's page shows the yellow “No coordinates” chip and “This location has no coordinates yet” in place of its map. If a save fails, a red message such as “Unable to save the coordinates.” appears instead, and what you entered stays in the boxes so you can try again.

On a soil sensor with a crop chosen, CropWatch uses the location's position to work out when the sun rises and sets there. That decides when the sensor's day targets give way to its night targets, and how the day's light goal is spread over the hours of daylight. Without a position, CropWatch assumes daylight from 06:00 to 16:00, and the sensor's page says so and asks for the location's position to be set. Crop targets and growing advice explains the targets.

Only the location's owner can delete it, and only the owner sees the red Danger zone card at the bottom of the page. It reads “Delete this location” and “Permanently deletes this location and everyone's access to it. This cannot be undone.”, above a red “Delete location” button.

The location has to be empty first. While it still holds sensors, a yellow note on the card gives the count, “This location still contains devices (3). Move them to another location or delete them before you can delete this location.”, and the Delete location button stays grey. To empty it:

• Move each sensor: change the Location box on its settings page to another location. Moving a sensor changes who can see it, so read Sensor settings first.
• Delete sensors you no longer use: the delete button is at the bottom of each sensor's settings page. Only a sensor's owner can delete it.

• There is no Location settings button. Your level on the location is User or Viewer. Ask the owner or an Admin.
• I get “Forbidden” when I open the settings. Only the owner and Admins can open this page at the moment. Managers see the button but are turned away.
• Save Changes on the name card is grey. Nothing has changed yet, or Location Name is empty.
• My browser asks me to fill in the Group box. Group cannot be left empty. Type a group, then save.
• How do I remove a group? You cannot empty it on this page; you can only change it to another group.
• Where do I change the description? Nowhere. The description is set when the location is created, and this page has no box for it.
• Save Changes on the map card is grey. Only one of Latitude and Longitude is filled in, one of them has a red message under it, or nothing has changed.
• My Google Maps link did not work. Short maps.app.goo.gl links have no coordinates in them. Open the link, then copy the long address from the browser's address bar.
• Use my current location put the pin in the wrong place. It uses the position of the device you are holding, not of the site. Check the accuracy in the note, then drag the pin or paste the site's coordinates.
• Centre on my devices is grey. None of the sensors at this location has its own map position.
• There is no Danger zone card. Only the location's owner sees it.
• Delete location is grey. The location still has sensors. Move or delete them first; the count includes sensors you cannot see.
• Delete this location permanently is grey. The typed name does not match yet, or the box is not ticked.
• Can I undo a delete? No. You would have to create the location again and give everyone access again.