Module location

Location handling.

Delta Chat handles two kind of locations.

There are two kinds of locations:

• Independent locations, also known as Points of Interest (POI).
• Path locations.

Locations are sent as KML attachments. Independent locations are sent in message.kml attachments and path locations are sent in location.kml attachments.

Structs

• Kml
  KML document.
• Location
  Location record.

Enums

• KmlTag 🔒

Functions

• delete_all
  Deletes all locations from the database.
• delete_expired 🔒
  Deletes expired locations.
• delete_orphaned_poi_locations 🔒
  Deletes POI locations that don’t have corresponding message anymore.
• delete_poi_location 🔒
  Deletes location if it is an independent location.
• get_kml
  Returns location.kml contents.
• get_kml_timestamp 🔒
• get_message_kml
  Returns a KML document containing a single location with the given timestamp and coordinates.
• get_range
  Searches for locations in the given time range, optionally filtering by chat and contact IDs.
• is_marker 🔒
• is_sending_locations_to_chat
  Returns whether chat_id or any chat is sending locations.
• location_loop 🔒
• maybe_send_locations 🔒
  Returns number of seconds until the next time location streaming for some chat ends automatically.
• save 🔒
  Saves given locations to the database.
• send_locations_to_chat
  Enables location streaming in chat identified by chat_id for seconds seconds.
• set
  Sets current location of the user device.
• set_kml_sent_timestamp
  Sets the timestamp of the last time location was sent in the chat.
• set_msg_location_id
  Sets the location of the message.