docs: add Polyglot Notebook samples per API surface#311
Open
maximn wants to merge 1 commit into
Open
Conversation
Add 12 live, runnable .dib notebooks under samples/notebooks/, one per Google Maps API surface (Geocoding, Routes, Directions, Distance Matrix, Elevation, Time Zone, Address Validation, Roads, Static Maps, plus the billable Places New, Solar, and Aerial View). Each references the published GoogleMapsApi NuGet package and renders real responses inline; billable notebooks lead with a cost warning. Add a notebooks index README and cross-link the set from the root and samples READMEs.
🔬 TestGlance✅ 212 passed across 1 job — 100.0% · ⏱️ 2.0s
🟡 build — details✅ 212 passed vs
Updated 2026-06-17T07:15:20.128Z |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds live, runnable Polyglot Notebook (
.dib) samples — one per Google Maps API surface — as a more hands-on alternative to the README's static code blocks. Each notebook references the publishedGoogleMapsApiNuGet package and renders real API responses inline.Related issue
n/a
Changes
.dibnotebooks undersamples/notebooks/, one per API surface: Geocoding, Routes, Directions, Distance Matrix, Elevation, Time Zone, Address Validation, Roads, Static Maps, plus the billable Places (New), Solar, and Aerial View.#r "nuget: GoogleMapsApi, 2.4.0", reads the key fromGOOGLE_API_KEY, constructs the client once, then calls the API and projects responses into inline tables; Static Maps renders the generated map URL as an inline image.> [!WARNING]cost banner; the legacy Directions and Distance Matrix notebooks point readers to the Routes notebook.samples/notebooks/README.md(run instructions + free/billable index) and cross-link the notebooks from the rootREADME.mdandsamples/README.md.Test plan
.cs, public-API,.csproj, orCHANGELOGchanges, so the build and release flow are untouched.export GOOGLE_API_KEY=..., open a notebook in VS Code's Polyglot Notebooks extension, and run cells top to bottom (e.g.StaticMaps.dibrenders the map image inline).Checklist
dotnet formathas been run. (n/a — no source files changed)dotnet testpasses locally (with a validGOOGLE_API_KEYfor integration tests).