Project Setup

Work Location

Complete guide to managing work location data in Moyee - viewing, searching, adding, editing, and deleting work locations along with GPS tolerance settings for attendance purposes.

Overview

The Work Location menu displays all work location data used for employee attendance purposes. This feature allows you to set GPS coordinates, maximum radius, and tolerance to ensure employees clock in & out at the correct locations.

Work Location List Display

The work location list page shows a table with the following columns:

  • Location Name - Work location name
  • Latitude - Latitude coordinate
  • Longitude - Longitude coordinate
  • Max Distance (m) - Maximum allowed radius from the center point
  • Use Tolerance? - GPS tolerance usage status
  • Tolerance (m) - GPS accuracy tolerance value (if used)
  • Used For - Location usage purpose

Work Location Data

Here is an example of registered work location data:

Location NameLatitudeLongitudeMax Distance (m)Use Tolerance?Tolerance (m)Used For
Radiant Utama Interinsco-6.240579106.819688100 mYes50Clock In & Out
Mampang Prapatan, Jakarta,...-6.248806106.8208450 mNo-Clock In & Out
Mampang Prapatan, Jakarta,...-6.248806106.8208480 mNo-Clock In & Out
Radiant Utama Interinsco-6.240637106.81966250 mYes20Clock In & Out
RADIANT PARKING-6.241306106.81941420 mNo-Clock In & Out

Search Feature

To easily find specific locations, a global search column is available based on keywords from all columns.

How to use:

  1. Click on the search column
  2. Type the keyword you want to search for (based on location name or address)
  3. Search results will appear automatically

Quick Actions

On each location data row, action buttons are available to manage the data:

  • Duplicate - Duplicate existing location data
  • Edit - Modify location data
  • Delete - Delete location data

Adding a New Location

To add new location data, click the Add Location button or the plus (+) icon. You will be directed to the location form page.

Location Form

The location form page displays a form for entering new location data with the help of an interactive Google Maps interface.

Form Components:

ComponentDescriptionNotes
Location NameFull work location nameRequired
LatitudeLatitude coordinateCan be entered manually or automatically from the map
LongitudeLongitude coordinateCan be entered manually or automatically from the map
Maximum Distance (meters)Maximum radius from the center pointRequired
Use GPS AccuracyCheckbox to enable GPS accuracy toleranceOptional
Accuracy Tolerance (optional)GPS accuracy tolerance value in metersAppears if Use GPS Accuracy is checked
Used ForLocation usage purposeOptions: Clock In & Out

How to Fill the Form:

  1. Location Name
    • Enter the full work location name
    • Example: Radiant Utama Interinsco
  2. GPS Coordinates
    • Drag the pin on the map to the desired location
    • Or manually enter values in the Latitude and Longitude fields
    • Example Latitude: -6.240579
    • Example Longitude: 106.819688
  3. Maximum Distance (meters)
    • Enter the maximum allowed radius from the center point
    • Example: 100
  4. Use GPS Accuracy (Optional)
    • Check if you want to enable GPS accuracy tolerance
    • Useful for accommodating GPS signal inaccuracies
  5. Accuracy Tolerance (Optional)
    • Enter the accuracy tolerance value in meters
    • Example: 50
    • This field only appears if Use GPS Accuracy is checked
  6. Used For
    • Select the location usage purpose
    • Options: Clock In & Out
  7. Click Save to save the data
  8. Click Cancel to cancel

Location Duplication

The duplicate feature makes it easy to create new locations with data similar to existing locations.

How to duplicate a location:

  1. Click the Duplicate icon on the location row you want to duplicate
  2. The form page will open with pre-filled data
  3. Change the Location Name (for example, adding the word "Copy")
  4. Adjust coordinates or other parameters if needed
  5. Click Save to save the new location

Differences from the original location:

  • Location Name usually has "Copy" added
  • Other data can be retained or modified as needed

Editing Location Data

To edit existing location data:

  1. Find the location you want to edit using the search feature
  2. Click the Edit icon (pencil) on that location's row
  3. The edit form will open with pre-filled data
  4. Modify the necessary information
  5. Click Save to save the changes
  6. Click Cancel to cancel

Deleting Location Data

To delete location data:

  1. Find the location you want to delete
  2. Click the Delete icon (trash can) on that location's row
  3. Confirm the deletion in the dialog that appears
  4. The location data will be permanently deleted
Warning: Deleting location data will affect the attendance process for employees using that location. Ensure no employees are still using this location for clock in & out before deleting.

Usage Tips

  1. Coordinate accuracy - Use the interactive map to ensure GPS coordinates are precisely at the desired location.
  2. Maximum radius - Adjust the radius according to the work location area. For office buildings, a 50-100 m radius is usually sufficient.
  3. GPS tolerance - Enable GPS tolerance if the work location is in an area with unstable GPS signals.
  4. Location naming - Use descriptive and easily recognizable names, for example, "Head Office - Radiant Utama" or "East Parking".
  5. Avoid duplication - Before adding a new location, check if a location with similar coordinates is already registered.
  6. Test - After adding a new location, conduct a test clock in to ensure the radius and tolerance settings work properly.

GPS Tolerance Usage Scenarios

ScenarioLocationRecommended Tolerance
Tall buildings with often obstructed GPS signalsCBD Offices20-50 m
Open areas with good GPS signalsFields, factories0-10 m
Hilly or remote areasMining project sites50-100 m
Large parking areasBuilding parking lots10-30 m

Troubleshooting

Employee cannot clock in

  • Ensure the employee's location matches the specified coordinates
  • Check the maximum radius; it might be too small
  • Verify if GPS tolerance is set appropriately
  • Ensure the employee's GPS is active

Coordinates inaccurate when selecting on map

  • Zoom in to get a more precise position
  • Manually drag the pin to the desired point
  • Use the address search feature on the map
  • Refresh the browser page
  • Ensure search keywords are correct
  • Try using more general keywords

Failed to save form

  • Ensure all required fields are filled
  • Check the coordinate format (use period or comma according to the system)
  • Ensure maximum radius and tolerance are entered as positive numbers

Next Steps

Copyright © 2026