Merge branch 'master' of github.com:owntracks/booklet

owntracks · Jan 2, 2025 · 2f14352 · 2f14352
2 parents 4608a13 + 4f859f5
commit 2f14352
Show file tree

Hide file tree

Showing 7 changed files with 47 additions and 0 deletions.
diff --git a/docs/features/images/poi2/jagular309-a.jpg b/docs/features/images/poi2/jagular309-a.jpg
diff --git a/docs/features/images/poi2/jagular309-b.jpg b/docs/features/images/poi2/jagular309-b.jpg
diff --git a/docs/features/images/poi2/jagular309-c.jpg b/docs/features/images/poi2/jagular309-c.jpg
diff --git a/docs/features/images/poi2/jagular309-d.jpg b/docs/features/images/poi2/jagular309-d.jpg
diff --git a/docs/features/images/poi2/jagular309-e.jpg b/docs/features/images/poi2/jagular309-e.jpg
diff --git a/docs/features/poi.md b/docs/features/poi.md
@@ -35,3 +35,48 @@ Also when publishing a location a user can set a Point of Interest (POI) which i
 ```
 
 iOS displays the Points of Interest as red bubbles on the map as shown above. The last POI and tags seen for a particular user are visible on the user's status page.
+
+## POI and images
+
+POI can also be submitted with a thumbnail of an photo selected from the Photos app. I take a photo using the normal iOS mechanisms to do this, and from within OwnTracks I can submit a POI (Point of Interest) with an associated image; the image is tagged with the _file name_ of the photo.
+
+Choose to publish a new location from the map:
+
+![manually publish a location](images/poi2/jagular309-a.jpg)
+![create new POI with image](images/poi2/jagular309-b.jpg)
+
+A new dialog opens when tapping on _Set POI with image_ in which an image from the photos library can be selected and set a POI text input, and the POI itself is shown on the Friend's details page
+
+![selecting a photo from the library and setting POI](images/poi2/jagular309-c.jpg)
+![location details show POI](images/poi2/jagular309-d.jpg)
+
+
+and the map displays the thumbnail of the photo
+
+![the tagged POI on the app's map](images/poi2/jagular309-e.jpg)
+
+
+This thumbnail will also be shown on Friends' maps.
+
+Our `"_type" : "location"` JSON payload is augmented with the image name, a POI text, and the image data of the thumbnail:
+
+```json
+{
+  "_type": "location",
+  "acc": 5,
+  "alt": 0,
+  "conn": "w",
+  "created_at": 1734377867,
+  "image": "/9j/42nS1Xn ... JfVKcX0R5mIy9+813P/9k=",
+  "imagename": "IMG_0009",
+  "lat": 52.085284,
+  "lon": 5.120975,
+  "m": 1,
+  "poi": "fabulous rijsttafel",
+  "t": "u",
+  "tid": "JJ",
+  "tst": 1734377712
+}
+```
+
+The Recorder's API will return these larger payloads transparently.
diff --git a/docs/features/tls.md b/docs/features/tls.md
@@ -11,6 +11,8 @@ Configuring TLS ([Transport Layer Security](http://en.wikipedia.org/wiki/Transpo
 You can share the certificate if you want to (though not many people will want it ...)
 It's so public, that it's perfectly OK to send yourself the file by, say, e-mail.
 
+Note: as per [RFC 9525](https://www.rfc-editor.org/rfc/rfc9525#appendix-A-2.2) an existing certificate/key pair will not work if the server certificate does not have a Subject Alternative Name (SAN). To verify that your server certificate has a SAN, you can look at the certificate in x509 form (see below, in "The nitty gritty").
+
 ## Configure TLS on the Mosquitto broker
 
 We'll first show you how to set up TLS on your Mosquitto [broker](../guide/broker.md).