Skip to content

AppDeviceBridge maps: pluggable providers with Azure Maps and Google Maps - #12

Merged
aritchie merged 2 commits into
mainfrom
maps-providers
Oct 6, 2026
Merged

aritchie merged 2 commits into
mainfrom
maps-providers

Conversation

@aritchie

@aritchie aritchie commented Oct 6, 2026

Copy link
Copy Markdown
Member

Summary

Docs for shinyorg/appdevicebridge#3, which makes the maps bridge's basemap, router and geocoder pluggable providers, with OpenStreetMap, Azure Maps and Google Maps built in.

  • appdevicebridge/maps.mdx:
    • A new Providers section: the provider matrix, all-Azure and all-Google setups, raster maps over downloaded regions, router travel modes, and writing your own IBasemapProvider or IRouteProvider.
    • The registration example and options table now use Basemap and Directions.Router.
    • Azure traffic now takes an AzureMapsCredential.
    • The failure table adds 400 mode_unsupported and 502 router_error.
  • appdevicebridge/release-notes.mdx: a 1.2 feature note and a breaking-change note.
  • appdevicebridge/index.mdx: the Maps and Maps.Blazor package rows.
  • src/data/appdevicebridge/bridges.json: regenerated with scripts/extract-bridges.mjs; the diff only touches maps.
  • src/sidebar-topics.mjs: the maps page's dateUpdated.

Testing

npx astro build succeeds: 822 pages built.

🤖 Generated with Claude Code

aritchie and others added 2 commits October 6, 2026 08:37
…Maps

Document the basemap, router and geocoder providers (OpenStreetMap, Azure
Maps, Google Maps, or your own), add the 1.2 feature and breaking release
notes, and regenerate the bridge API reference.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI balanced review requested due to automatic review settings October 6, 2026 12:39
@aritchie
aritchie merged commit b19ee5b into main Oct 6, 2026
1 check passed

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟡 Changes recommended

Several routing and basemap descriptions conflict with the documented runtime behavior.

Review effort: Balanced
Findings: 3 Low severity

Open (3)
What changed in this PR

Documents pluggable map, routing, and geocoding providers for AppDeviceBridge.

Changes:

  • Adds Azure Maps, Google Maps, and custom-provider guidance.
  • Updates release notes, package summaries, and generated bridge API data.
  • Refreshes the Maps sidebar date.
File Description
src/​sidebar-topics.mjs Updates the Maps page date.
src/​data/​appdevicebridge/​bridges.json Adds generated provider API contracts.
src/​content/​docs/​appdevicebridge/​release-notes.mdx Documents features and breaking changes.
src/​content/​docs/​appdevicebridge/​maps.mdx Adds provider setup and API guidance.
src/​content/​docs/​appdevicebridge/​index.mdx Updates Maps package summaries.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

}
```

Set `Cacheable = true` on the layer only if the service's terms allow tiles to be kept on the device.
Comment on lines +180 to +182
`Directions.Router`. A router declares the travel modes it offers: `GET /_bridge/directions` reports them as
`onlineModes`, with the router's name as `router`, and a request for another mode answers `400 mode_unsupported` when the
device can't route it either. Every route carries the `Attribution` its source requires; show it with the route.
"verb": "POST",
"route": "directions/route",
"summary": "Computes a route through the stops. Fails with 400 for fewer than two stops or a stop off the map, 404 when no route connects them, 503 (`offline_unavailable`) when the device cannot compute it and the online router cannot be reached, 501 when neither is available on this platform and app.",
"summary": "Computes a route through the stops. Fails with 400 for fewer than two stops or a stop off the map, or (`mode_unsupported`) for a travel mode the online router does not offer when the device cannot route; 404 when no route connects them, 503 (`offline_unavailable`) when the device cannot compute it and the online router cannot be reached, 501 when neither is available on this platform and app.",
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants