spacemap 0.1.0 → 0.1.1

package/README.md

@@ -13,17 +13,22 @@ are licensed for non-commercial use only.
 
 ## Getting it
 
-As one script that carries everything it needs — `spacemap.js`, an ES module,
-next to `spacemap.iife.js` for pages that want a global instead:
+As one script that carries everything it needs, from the CDN or copied next to
+your page:
 
 ```html
 <div id="map" style="height: 500px"></div>
 <script type="module">
-	import { createMap } from './spacemap.js';
+	import { createMap } from 'https://cdn.spacemap.co/0.1.1/spacemap.js';
 	const map = await createMap({ container: '#map' });
 </script>
 ```
 
+`spacemap.iife.js` at the same path defines a `spacemap` global instead, for
+pages without modules. Every version stays where it was published, so pin the
+one you tested; the build's `sha384` digest in an `integrity` attribute keeps
+the page from running anything else.
+
 Or from npm, where three.js is yours to provide:
 
 ```sh
@@ -167,6 +172,8 @@ map.addSurfaceCircle({ body: 'naif-499', center: { lon: 77.5, lat: 18.4 }, radiu
 
 `boxRing`, `smallCircle` and `graticule`, the flat map's helpers, make point
 lists these take; `circlePoints` does the same for a circle in space.
+`groundDistanceM` and `bearingDeg` measure between any two places on a body,
+given its radius.
 
 Every drawing answers `remove()` and `setVisible()`, a shape answers
 `setAnchor()` and `setPoints()`, and `map.clearDrawings()` takes them all away
@@ -435,6 +442,19 @@ A rover's panorama from the inside, with arrows along its traverse. The
 three-dimensional part is all the SDK draws; the date, the place, a list to
 pick from or a map of the traverse are the page's to build.
 
+Which bodies have panoramas, and where each one stands, can be read before a
+view exists — what a page picking one for the reader needs, since `createPanorama`
+opens the body's first unless told which:
+
+```js
+import { fetchPanoramaIndex, fetchPanoramas } from 'spacemap';
+
+await fetchPanoramaIndex(); // every body with coverage, and the missions on it
+const entries = await fetchPanoramas('naif-499'); // every panorama on Mars
+const pick = entries[(Math.random() * entries.length) | 0];
+const view = await createPanorama({ container: '#panorama', body: 'naif-499', at: pick.id });
+```
+
 ```js
 const view = await createPanorama({
 	container: '#panorama',