Improve the blueprint API for the map view (#8027)

### What

- Fixes #7903

In passing, I noticed we didn't have an easy way to test view blueprint
for equality, e.g. to verify the various way they can be constructed.
I've added an `__eq__` implementation on both `SpaceView` and
`Container` that ignores the `id` field (which is always unique).

- [x] add snippet/screenshot

### Checklist
* [x] I have read and agree to [Contributor
Guide](https://github.com/rerun-io/rerun/blob/main/CONTRIBUTING.md) and
the [Code of
Conduct](https://github.com/rerun-io/rerun/blob/main/CODE_OF_CONDUCT.md)
* [x] I've included a screenshot or gif (if applicable)
* [x] I have tested the web demo (if applicable):
* Using examples from latest `main` build:
[rerun.io/viewer](https://rerun.io/viewer/pr/8027?manifest_url=https://app.rerun.io/version/main/examples_manifest.json)
* Using full set of examples from `nightly` build:
[rerun.io/viewer](https://rerun.io/viewer/pr/8027?manifest_url=https://app.rerun.io/version/nightly/examples_manifest.json)
* [x] The PR title and labels are set such as to maximize their
usefulness for the next release's CHANGELOG
* [x] If applicable, add a new check to the [release
checklist](https://github.com/rerun-io/rerun/blob/main/tests/python/release_checklist)!
* [x] If have noted any breaking changes to the log API in
`CHANGELOG.md` and the migration guide

- [PR Build Summary](https://build.rerun.io/pr/8027)
- [Recent benchmark results](https://build.rerun.io/graphs/crates.html)
- [Wasm size tracking](https://build.rerun.io/graphs/sizes.html)

To run all checks from `main`, comment on the PR with `@rerun-bot
full-check`.

Author: abey79

crates/store/re_types/definitions/rerun/blueprint/archetypes/map_background.fbs

@@ -4,6 +4,7 @@ namespace rerun.blueprint.archetypes;
 /// Configuration for the background map of the map view.
 table MapBackground (
     "attr.rerun.scope": "blueprint",
+    "attr.python.aliases": "blueprint_components.MapProviderLike",
     "attr.docs.unreleased"
 ) {
     // --- Optional ---

crates/store/re_types/definitions/rerun/blueprint/archetypes/map_zoom.fbs

@@ -5,6 +5,7 @@ namespace rerun.blueprint.archetypes;
 //TODO(ab): Turn this archetype into `MapArea` and include a `center: LatLon` componnent or similar
 table MapZoom (
     "attr.rerun.scope": "blueprint",
+    "attr.python.aliases": "datatypes.Float64Like",
     "attr.docs.unreleased"
 ) {
     // --- Optional ---

crates/store/re_types/definitions/rerun/blueprint/views/map.fbs

@@ -2,8 +2,7 @@ namespace rerun.blueprint.views;
 
 /// A 2D map view to display geospatial primitives.
 ///
-/// \example views/map title="Use a blueprint to create a map view."
-//TODO(ab): add a screenshot
+/// \example views/map title="Use a blueprint to create a map view." image="https://static.rerun.io/map-view/8b2cc15e3f3313e2181667f6c29816ebe75e16e6/1200w.png"
 table MapView (
     "attr.rerun.view_identifier": "Map",
     "attr.docs.unreleased"

docs/content/reference/types/views/map_view.md

@@ -1,20 +1,19 @@
-"""Use a blueprint to show a map."""
+"""Use a blueprint to customize a map view."""
 
 import rerun as rr
 import rerun.blueprint as rrb
 
 rr.init("rerun_example_map_view", spawn=True)
 
-rr.log("points", rr.GeoPoints(lat_lon=[[47.6344, 19.1397], [47.6334, 19.1399]]))
+rr.log("points", rr.GeoPoints(lat_lon=[[47.6344, 19.1397], [47.6334, 19.1399]], radii=rr.Radius.ui_points(20.0)))
 
 # Create a map view to display the chart.
-# TODO(#7903): cleanup the blueprint API for the map view
 blueprint = rrb.Blueprint(
     rrb.MapView(
         origin="points",
         name="MapView",
-        zoom=rrb.archetypes.MapZoom(16.0),
-        background=rrb.archetypes.MapBackground(rrb.components.MapProvider.OpenStreetMap),
+        zoom=16.0,
+        background=rrb.MapProvider.OpenStreetMap,
     ),
     collapse_panels=True,
 )

docs/snippets/all/views/map.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+from typing import Any
+
+import rerun.blueprint as rrb
+
+
+def assert_blueprint_contents_are_equal(*contents: rrb.SpaceView | rrb.Container) -> None:
+    """
+    Check for equivalence between blueprint contents (views and containers).
+
+    This is done by checking equality between all fields, _except_ the `id` field, which is always unique.
+    """
+
+    def strip_id_field(d: dict[str, Any]) -> dict[str, Any]:
+        return {k: v for k, v in d.items() if k != "id"}
+
+    for i, (c1, c2) in enumerate(zip(contents, contents[1:])):
+        assert strip_id_field(c1.__dict__) == strip_id_field(c2.__dict__), f"View {i} and {i + 1} are not equal"

rerun_py/rerun_sdk/rerun/blueprint/__init__.py

@@ -0,0 +1,24 @@
+from __future__ import annotations
+
+import rerun.blueprint as rrb
+
+from .blueprint_utils import assert_blueprint_contents_are_equal
+
+
+def test_map_view_blueprint() -> None:
+    """Various ways to create a `MapView` blueprint."""
+
+    bp1 = rrb.MapView(origin="point", name="MapView", zoom=16, background="openstreetmap")
+    bp2 = rrb.MapView(origin="point", name="MapView", zoom=rrb.components.ZoomLevel(16), background="openstreetmap")
+    bp3 = rrb.MapView(
+        origin="point", name="MapView", zoom=rrb.archetypes.MapZoom(16), background=rrb.MapProvider.OpenStreetMap
+    )
+    bp4 = rrb.MapView(
+        origin="point",
+        name="MapView",
+        zoom=rrb.archetypes.MapZoom(rrb.components.ZoomLevel(16)),
+        background=rrb.archetypes.MapBackground(rrb.MapProvider.OpenStreetMap),
+    )
+
+    # assert bp1 == bp2 == bp3 == bp4
+    assert_blueprint_contents_are_equal(bp1, bp2, bp3, bp4)