Replace the legacy example site with a minimal API sample

Retire the old MVC example project in favor of an SDK-style ASP.NET Core sample that matches the modernized solution layout and tooling.

The new sample keeps provider discovery explicit, validates reverse-geocode input up front, and returns handled problem responses when a provider is unavailable or rejects a request so the out-of-box experience is diagnosable instead of failing with unhandled exceptions.

Author: niemyjski

.gitignore

@@ -1,6 +1,6 @@
 /bin
 /packages
-/examples/packages
+/samples/packages
 test/Geocoding.Tests/settings-override.json
 
 .vs

.vscode/launch.json

@@ -2,21 +2,31 @@
     "version": "0.2.0",
     "configurations": [
         {
-            "name": ".NET Core Launch (console)",
+            "name": "Launch Example.Web",
             "type": "coreclr",
             "request": "launch",
-            "preLaunchTask": "build",
-            "program": "${workspaceRoot}/bin/Debug/<target-framework>/<project-name.dll>",
-            "args": [],
-            "cwd": "${workspaceRoot}",
-            "externalConsole": false,
-            "stopAtEntry": false
+            "preLaunchTask": "build example",
+            "program": "dotnet",
+            "args": [
+                "run",
+                "--project",
+                "${workspaceFolder}/samples/Example.Web/Example.Web.csproj"
+            ],
+            "cwd": "${workspaceFolder}",
+            "env": {
+                "ASPNETCORE_ENVIRONMENT": "Development"
+            },
+            "stopAtEntry": false,
+            "serverReadyAction": {
+                "action": "openExternally",
+                "pattern": "\\bNow listening on:\\s+(https?://\\S+)"
+            }
         },
         {
             "name": ".NET Core Attach",
             "type": "coreclr",
             "request": "attach",
-            "processId": "${command.pickProcess}"
+            "processId": "${command:pickProcess}"
         }
     ]
 }

.vscode/tasks.json

@@ -1,21 +1,65 @@
 {
     "version": "2.0.0",
-    "command": "dotnet",
-    "args": [],
     "tasks": [
         {
             "label": "build",
             "type": "shell",
             "command": "dotnet",
             "args": [
                 "build",
-                ""
+                "Geocoding.slnx"
             ],
             "problemMatcher": "$msCompile",
             "group": {
-                "_id": "build",
-                "isDefault": false
+                "kind": "build",
+                "isDefault": true
             }
+        },
+        {
+            "label": "test",
+            "type": "shell",
+            "command": "dotnet",
+            "args": [
+                "test",
+                "--project",
+                "test/Geocoding.Tests/Geocoding.Tests.csproj"
+            ],
+            "problemMatcher": "$msCompile",
+            "group": "test"
+        },
+        {
+            "label": "pack",
+            "type": "shell",
+            "command": "dotnet",
+            "args": [
+                "pack",
+                "Geocoding.slnx",
+                "--configuration",
+                "Release"
+            ],
+            "problemMatcher": "$msCompile"
+        },
+        {
+            "label": "build example",
+            "type": "shell",
+            "command": "dotnet",
+            "args": [
+                "build",
+                "samples/Example.Web/Example.Web.csproj"
+            ],
+            "problemMatcher": "$msCompile"
+        },
+        {
+            "label": "run example",
+            "type": "shell",
+            "command": "dotnet",
+            "args": [
+                "run",
+                "--project",
+                "samples/Example.Web/Example.Web.csproj"
+            ],
+            "isBackground": true,
+            "problemMatcher": []
         }
     ]
 }

AGENTS.md

@@ -42,7 +42,7 @@ src/
 └── Geocoding.Yahoo             # Yahoo geocoding provider
 test/
 └── Geocoding.Tests             # xUnit tests for all providers
-examples/
+samples/
 └── Example.Web                 # Sample web application
 ```
 

Geocoding.slnx

@@ -10,4 +10,7 @@
   <Folder Name="/test/">
     <Project Path="test/Geocoding.Tests/Geocoding.Tests.csproj" />
   </Folder>
+  <Folder Name="/samples/">
+    <Project Path="samples/Example.Web/Example.Web.csproj" />
+  </Folder>
 </Solution>

README.md

@@ -1,17 +1,17 @@
-# Generic C# Geocoding API [![Build Status](http://teamcity.chadly.net/app/rest/builds/buildType:(id:GeocodingNe_Build)/statusIcon)](http://teamcity.chadly.net/viewType.html?buildTypeId=GeocodingNe_Build&guest=1)
+# Generic C# Geocoding API [![CI](https://github.com/exceptionless/Geocoding.net/actions/workflows/build.yml/badge.svg)](https://github.com/exceptionless/Geocoding.net/actions/workflows/build.yml) [![Publish Packages](https://github.com/exceptionless/Geocoding.net/actions/workflows/publish-packages.yml/badge.svg)](https://github.com/exceptionless/Geocoding.net/actions/workflows/publish-packages.yml) [![CodeQL](https://github.com/exceptionless/Geocoding.net/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/exceptionless/Geocoding.net/actions/workflows/codeql-analysis.yml)
 
 Includes a model and interface for communicating with five popular Geocoding providers.  Current implementations include:
 
-* [Google Maps](https://developers.google.com/maps/) - [docs](https://developers.google.com/maps/documentation/geocoding/)
-* [Yahoo! BOSS Geo Services](http://developer.yahoo.com/boss/geo/) - [docs](http://developer.yahoo.com/geo/placefinder/guide/index.html)
-* [Bing Maps (aka Virtual Earth)](http://www.microsoft.com/maps/) - [docs](http://msdn.microsoft.com/en-us/library/ff701715.aspx)
-* :warning: MapQuest [(Commercial API)](http://www.mapquestapi.com/) - [docs](http://www.mapquestapi.com/geocoding/)
-* :warning: MapQuest [(OpenStreetMap)](http://open.mapquestapi.com/) - [docs](http://open.mapquestapi.com/geocoding/)
-* [HERE](https://www.here.com/) - [docs](https://developer.here.com/documentation)
+* [Google Maps](https://developers.google.com/maps/) - [Google geocoding docs](https://developers.google.com/maps/documentation/geocoding/)
+* [Yahoo! BOSS Geo Services](http://developer.yahoo.com/boss/geo/) - [Yahoo PlaceFinder docs](http://developer.yahoo.com/geo/placefinder/guide/index.html)
+* [Bing Maps (aka Virtual Earth)](http://www.microsoft.com/maps/) - [Bing geocoding docs](http://msdn.microsoft.com/en-us/library/ff701715.aspx)
+* :warning: MapQuest [(Commercial API)](http://www.mapquestapi.com/) - [MapQuest geocoding docs](http://www.mapquestapi.com/geocoding/)
+* :warning: MapQuest [(OpenStreetMap)](http://open.mapquestapi.com/) - [MapQuest OpenStreetMap geocoding docs](http://open.mapquestapi.com/geocoding/)
+* [HERE Maps](https://www.here.com/) - [HERE developer documentation](https://developer.here.com/documentation)
 
 The API returns latitude/longitude coordinates and normalized address information.  This can be used to perform address validation, real time mapping of user-entered addresses, distance calculations, and much more.
 
-See latest [release notes](https://github.com/chadly/Geocoding.net/releases/latest).
+See latest [release notes](https://github.com/exceptionless/Geocoding.net/releases/latest).
 
 :warning: There is a potential issue ([#29](https://github.com/chadly/Geocoding.net/issues/29)) regarding MapQuest that has a workaround. If you would like to help fix the issue, PRs are welcome.
 
@@ -89,3 +89,15 @@ Alternatively, if you are on Windows, you can open the solution in [Visual Studi
 ### Service Tests
 
 You will need to generate API keys for each respective service to run the service tests. Make a `settings-override.json` as a copy of `settings.json` in the test project and put in your API keys. Then you should be able to run the tests.
+
+Most provider-backed integration tests skip with a message indicating which setting is required when credentials are missing. The Yahoo suite is still explicitly skipped while issue #27 remains open, but it now uses the same credential checks when those tests are re-enabled.
+
+## Sample App
+
+The sample app in `samples/Example.Web` is an ASP.NET Core 10 minimal API that can geocode and reverse geocode against any configured provider.
+
+```bash
+dotnet run --project samples/Example.Web/Example.Web.csproj
+```
+
+Configure a provider in `samples/Example.Web/appsettings.json` or via environment variables such as `Providers__Google__ApiKey`. Once the app is running, use `samples/Example.Web/sample.http` to call `/providers`, `/geocode`, and `/reverse`.