Soenneker.Google.Geocode
4.0.1241
Prefix Reserved
See the version list below for details.
dotnet add package Soenneker.Google.Geocode --version 4.0.1241
NuGet\Install-Package Soenneker.Google.Geocode -Version 4.0.1241
<PackageReference Include="Soenneker.Google.Geocode" Version="4.0.1241" />
<PackageVersion Include="Soenneker.Google.Geocode" Version="4.0.1241" />
<PackageReference Include="Soenneker.Google.Geocode" />
paket add Soenneker.Google.Geocode --version 4.0.1241
#r "nuget: Soenneker.Google.Geocode, 4.0.1241"
#:package Soenneker.Google.Geocode@4.0.1241
#addin nuget:?package=Soenneker.Google.Geocode&version=4.0.1241
#tool nuget:?package=Soenneker.Google.Geocode&version=4.0.1241
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.909)
- Soenneker.Extensions.Task (>= 4.0.139)
- Soenneker.Extensions.ValueTask (>= 4.0.132)
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 |
|---|---|---|
| 11.0.1261 | 0 | 11/18/2026 |
| 11.0.1260 | 0 | 11/18/2026 |
| 11.0.1258 | 0 | 11/18/2026 |
| 11.0.1256 | 134 | 11/11/2026 |
| 11.0.1255 | 100 | 11/11/2026 |
| 11.0.1254 | 86 | 11/11/2026 |
| 11.0.1252 | 105 | 11/11/2026 |
| 11.0.1251 | 92 | 11/11/2026 |
| 11.0.1250 | 85 | 11/11/2026 |
| 11.0.1248 | 376 | 10/27/2026 |
| 11.0.1247 | 97 | 10/26/2026 |
| 11.0.1246 | 99 | 10/26/2026 |
| 4.0.1243 | 131 | 10/15/2026 |
| 4.0.1242 | 103 | 10/15/2026 |
| 4.0.1241 | 110 | 10/14/2026 |
| 4.0.1240 | 101 | 10/14/2026 |
| 4.0.1237 | 103 | 10/14/2026 |
| 4.0.1230 | 114 | 10/13/2026 |
| 4.0.1229 | 113 | 10/13/2026 |
| 4.0.1228 | 111 | 10/12/2026 |
Updated Multiple NuGet packages