Soenneker.Google.Geocode
4.0.1243
Prefix Reserved
dotnet add package Soenneker.Google.Geocode --version 4.0.1243
NuGet\Install-Package Soenneker.Google.Geocode -Version 4.0.1243
<PackageReference Include="Soenneker.Google.Geocode" Version="4.0.1243" />
<PackageVersion Include="Soenneker.Google.Geocode" Version="4.0.1243" />
<PackageReference Include="Soenneker.Google.Geocode" />
paket add Soenneker.Google.Geocode --version 4.0.1243
#r "nuget: Soenneker.Google.Geocode, 4.0.1243"
#:package Soenneker.Google.Geocode@4.0.1243
#addin nuget:?package=Soenneker.Google.Geocode&version=4.0.1243
#tool nuget:?package=Soenneker.Google.Geocode&version=4.0.1243
Soenneker.Google.Geocode
A small DI-ready wrapper around Google Maps address geocoding for retrieving all matches, the first match, or its place ID.
Install
dotnet add package Soenneker.Google.Geocode
Configuration
{
"Google": {
"Geocode": {
"ApiKey": "<Google Maps API key>"
}
}
}
Enable the Geocoding API for the key and restrict the key appropriately for the application that uses it.
Register
using Soenneker.Google.Geocode.Registrars;
using Microsoft.Extensions.DependencyInjection;
services.AddGoogleGeocodeUtilAsScoped();
Singleton registration is also available through AddGoogleGeocodeUtilAsSingleton(); the implementation is stateless after reading its API key.
Usage
Result? result = await geocode.GetResult(
"1600 Amphitheatre Parkway, Mountain View, CA",
cancellationToken);
if (result is not null)
Console.WriteLine($"{result.FormattedAddress} ({result.PlaceId})");
Use GetResults() when every Google candidate matters. GetResult() returns Google's first candidate, and GetPlaceId() returns that candidate's place ID directly.
API at a glance
| API | What it does | Result / important behavior |
|---|---|---|
GetResults(address) |
Sends an address-geocoding request. | Returns Google's candidates in response order, or null if no response is produced. |
GetResult(address) |
Gets the first candidate. | Returns null when no candidate exists. |
GetPlaceId(address) |
Gets the first candidate's place ID. | Returns null when no candidate exists. |
Behavior
- The address is sent to Google as provided; this package does not normalize or validate it locally.
- A first result is not a guarantee of an exact match. Inspect the full
Resultwhen match quality matters. - Google API and transport failures propagate to the caller. Cancellation is forwarded to the request.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- GoogleApi (>= 5.8.18)
- Soenneker.Extensions.Configuration (>= 4.0.910)
- Soenneker.Extensions.Task (>= 4.0.140)
- Soenneker.Extensions.ValueTask (>= 4.0.133)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 4.0.1243 | 81 | 10/15/2026 |
| 4.0.1242 | 74 | 10/15/2026 |
| 4.0.1241 | 71 | 10/14/2026 |
| 4.0.1240 | 74 | 10/14/2026 |
| 4.0.1237 | 69 | 10/14/2026 |
| 4.0.1230 | 77 | 10/13/2026 |
| 4.0.1229 | 79 | 10/13/2026 |
| 4.0.1228 | 80 | 10/12/2026 |
| 4.0.1224 | 105 | 10/11/2026 |
| 4.0.1223 | 92 | 10/11/2026 |
| 4.0.1222 | 84 | 10/11/2026 |
| 4.0.1221 | 91 | 10/10/2026 |
| 4.0.1220 | 84 | 10/9/2026 |
| 4.0.1219 | 84 | 10/9/2026 |
| 4.0.1218 | 153 | 10/1/2026 |
| 4.0.1217 | 118 | 9/25/2026 |
| 4.0.1216 | 101 | 9/25/2026 |
| 4.0.1215 | 97 | 9/24/2026 |
| 4.0.1214 | 96 | 9/24/2026 |
| 4.0.1213 | 114 | 9/18/2026 |
Update dependency Soenneker.Extensions.Task to 4.0.140 (#1822)