Getting Started

This guide walks you through installing GoogleMapsApi and making your first geocoding request.

Installation

Install via NuGet Package Manager:

Install-Package GoogleMapsApi

Or via the .NET CLI:

dotnet add package GoogleMapsApi

API key configuration

You can configure your Google Maps API key in several ways. The simplest is to set it directly on each request:

using GoogleMapsApi;
using GoogleMapsApi.Entities.Geocoding.Request;
using GoogleMapsApi.Entities.Geocoding.Response;

using var http = new HttpClient();
var maps = new GoogleMapsClient(http);

GeocodingRequest geocodeRequest = new GeocodingRequest()
{
    Address = "new york city",
    ApiKey = "your-google-maps-api-key"
};

GeocodingResponse geocode = await maps.Geocode.QueryAsync(geocodeRequest);
Console.WriteLine(geocode);

Note

The static GoogleMaps facade was removed in 2.0.0. Use the instance-based GoogleMapsClient / IGoogleMapsClient shown above.

For more configuration options (including global configuration via app.config / appsettings.json), see the wiki.

Synchronous usage

The API is async-first. When you must call from a synchronous context, block on the task — prefer QueryAsync whenever possible:

GeocodingResponse geocode = maps.Geocode.QueryAsync(geocodeRequest).GetAwaiter().GetResult();
Console.WriteLine(geocode);

Next steps

• Browse the API Reference for the full surface area of every supported service.
• See the project README for a broader code tour, including Directions and Static Maps examples.