Maps & Destinations

Creating a New Map

Kachaka uses a map to recognize its surroundings and plan routes. You should build a new map when you move it to a new space, or when furniture has been rearranged enough that its layout has changed and Kachaka starts moving unreliably.

Kachaka can save multiple maps and switch between them at any time, so a new map never overwrites the old one — keep a separate map for each location or temporary layout.

Map quality directly determines how reliably Kachaka drives and stops later on. Before you start, read Map Prep and Accuracy Tips: clearing the floor, opening doors, and keeping the area bright will greatly reduce future position drift.

Create a brand-new map

  1. Open the Map tab in the app.

  2. Tap the + in the top-right corner.

  3. Tap Add map.

  4. Name the new map, then tap Create.

  5. Follow the on-screen prompts and tap Start scan. Kachaka will drive around and scan the environment.

  6. When scanning finishes, Kachaka announces that the automatic scan is complete.

  7. Tap Save this map.

    • If the map is not fully scanned, tap Adjust manually instead to fill in or fine-tune the missing areas.

  8. After Kachaka announces that map creation is complete, tap OK to finish.

Once done, go to Adding, Repositioning and Setting Default Destinations to register the destinations on your new map before you start assigning deliveries.

Rebuild the map while keeping your settings

If the layout changed a lot and Kachaka has become unstable, you can rebuild the map without losing everything by using the keep-settings option: furniture info, destinations, and routines (shortcuts and scheduled deliveries) are carried over, and the result is added as a brand-new map rather than overwriting the original.

Important: This mode cannot place destinations back at their exact original positions. After the new map is built, be sure to re-adjust each destination’s position one by one, or Kachaka may stop in the wrong place.

Newer app version

  1. First confirm that the map currently selected is the one whose settings you want to carry over.
  2. Open the Map tab and tap + in the top-right to add a map.
  3. Name the new map and tap Next.
  4. Tap Skip in the top-right.
  5. Turn the Create with current settings toggle on.
  6. Tap OK at the bottom of the screen.
  7. Tap Start scan and complete the map as described above.

Older app version

  1. First confirm that the map currently selected is the one whose settings you want to carry over.
  2. Open the Map tab, name the new map, then tap Create with current settings.
  3. Turn Include the scanned map off.
    • If you want to merge a new area into the original map (instead of building a separate one), turn this on instead. That is the Extend an existing map feature, which widens the map rather than editing the original.
  4. Tap Next, then OK.
  5. Tap Start scan and complete the map as described above.

Screens

Creating a New Map — app walkthrough (step 1) Creating a New Map — app walkthrough (step 2)

Auto-mapping stops with a yellow LED?

If auto-mapping stops partway and Kachaka turns yellow and halts, a common cause is a floor that is too dark: the cliff (fall-prevention) sensor on the underside misreads the dark floor as a drop-off and stops. Use either workaround:

After mapping is done, be sure to remove the tape and restore the cliff sensor to keep normal fall protection.

← Support Center