aboutsummaryrefslogtreecommitdiffstats
path: root/libgeome.h
diff options
context:
space:
mode:
Diffstat (limited to 'libgeome.h')
-rw-r--r--libgeome.h17
1 files changed, 15 insertions, 2 deletions
diff --git a/libgeome.h b/libgeome.h
index 48e40e3..1e81494 100644
--- a/libgeome.h
+++ b/libgeome.h
@@ -10,6 +10,19 @@
#define LIBGEOME_DATUM_LONGITUDE UINT64_C(0x0000000000000002)
#define LIBGEOME_DATUM_ALTITUDE UINT64_C(0x0000000000000004)
+/**
+ * The highest bit in `.requested_data` that is used
+ * in the applications version of `struct libgeome_data`
+ *
+ * You can an #if'ed CPP warning to detected when this
+ * value has been changed, so you can add support for
+ * new data in your application. When you do this, you
+ * can also always set the `.requested_data` to
+ * `LIBGEOME_LAST_DATUM - 1U | LIBGEOME_LAST_DATUM`
+ * to get all data your application support.
+ */
+#define LIBGEOME_LAST_DATUM LIBGEOME_DATUM_ALTITUDE
+
/**
* Geolocation data
@@ -96,7 +109,7 @@ struct libgeome_netservice {
/**
* Geolocation data that may be provided by the service
*
- * 0 if unknown (always known (non-zero) when retreived
+ * 0 if unknown (always known (non-zero) when retrieved
* from libgeome_netservices)
*
* See `struct libgeome_data.requested_data`
@@ -156,7 +169,7 @@ struct libgeome_netservice {
* Be aware these services may have terms of use that
* restrict how you are allowed to use them.
*/
-extern struct libgeome_netservice libgeome_netservices[];
+extern const struct libgeome_netservice libgeome_netservices[];
/**
* The number of elements in `libgeome_netservices`