Soenneker.Google.Geocode 4.0.1182

Prefix Reserved

There is a newer version of this package available.
See the version list below for details.

dotnet add package Soenneker.Google.Geocode --version 4.0.1182

NuGet\Install-Package Soenneker.Google.Geocode -Version 4.0.1182

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Soenneker.Google.Geocode" Version="4.0.1182" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Soenneker.Google.Geocode" Version="4.0.1182" />
                    

                            Directory.Packages.props

<PackageReference Include="Soenneker.Google.Geocode" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add Soenneker.Google.Geocode --version 4.0.1182

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Soenneker.Google.Geocode, 4.0.1182"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package Soenneker.Google.Geocode@4.0.1182

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=Soenneker.Google.Geocode&version=4.0.1182
                    

                            Install as a Cake Addin

#tool nuget:?package=Soenneker.Google.Geocode&version=4.0.1182
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

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 Result when match quality matters.
Google API and transport failures propagate to the caller. Cancellation is forwarded to the request.

Product	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.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- GoogleApi (>= 5.8.15)
- Soenneker.Extensions.Configuration (>= 4.0.868)
- Soenneker.Extensions.Task (>= 4.0.128)
- Soenneker.Extensions.ValueTask (>= 4.0.120)

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.1184	0	8/31/2026
4.0.1183	0	8/31/2026
4.0.1182	25	8/30/2026
4.0.1180	41	8/30/2026
4.0.1179	30	8/30/2026
4.0.1178	40	8/30/2026
4.0.1177	34	8/30/2026
4.0.1176	39	8/30/2026
4.0.1175	37	8/30/2026
4.0.1174	37	8/29/2026
4.0.1173	40	8/29/2026
4.0.1172	40	8/29/2026
4.0.1170	70	8/26/2026
4.0.1169	76	8/26/2026
4.0.1168	78	8/25/2026
4.0.1167	89	8/21/2026
4.0.1166	92	8/18/2026
4.0.1165	91	8/12/2026
4.0.1164	98	8/12/2026
4.0.1163	88	8/8/2026

Update dependency Soenneker.Extensions.Task to 4.0.128 (#1716)