> For the complete documentation index, see [llms.txt](https://open.janastu.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://open.janastu.org/projects/maptales.md).

# Maptales

This is a software design document that captures the system requirements and discusses the overall architecture of the system. The system in question is one designed for creating, publishing and consuming locative media. Locative media is media, text, audio, video, that has been geo-located. There are multiple types of locative media currently available, such as the KML files coming from the ‘Follow the sheep’ project.

The idea is to allow this media to be consumed in a player application which allows the viewing of media at particular geo-locations. This can be used to create interactive narratives and other forms of non-linear narratives that involves the user of the media moving through physical space to consume media.

![](/files/-MX01xbpz_wMa7478tj3)

Examples of narratives could be treasure hunts where users have to unlock clues at different locations that take them to other locations to find treasure. Interactive fiction where users move from point A to B to navigate the fiction, to take the story forward. Guided city tours are another possibility, where users are shown different media at different locations and they get to know or understand media taken or about a particular location.

{% tabs %}
{% tab title="Docs" %}

* [Working Title: MapTales](https://docs.google.com/document/d/1RY2o2Zr6ZH6mBG2P7Hx-8JersDG7NGHq_dnSA3Dac0g/edit?usp=sharing)
* <https://github.com/janastu/maptales_player>
  {% endtab %}
  {% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://open.janastu.org/projects/maptales.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.