Skip to content

C# google maps api interface for interacting with the backend web services for Google Maps

License

Notifications You must be signed in to change notification settings

tony031/gmaps-api-net

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Google Maps API for .NET

AppVeyor Join the chat at https://gitter.im/gmaps-api-net/Lobby

A .NET library for interacting with the Google Maps API suite.

NuGet package: https://www.nuget.org/packages/gmaps-api-net/

PS> Install-Package gmaps-api-net

Overview

This project attempts to provide all the features available in the Google Maps API. It is being developed in C# for the Microsoft .NET including .Net Framework v4.6.1+ and .Net Standard v1.3+. gmaps-api-net is a fully featured API client library, providing strongly typed access to the API.

API Support

Currently the library supports full coverage of the following Google Maps APIs:

  • Geocoding
  • Elevation
  • Static Maps
  • Directions
  • Distance Matrix
  • Places
  • Time Zones
  • Street View, added to v0.19

Quick Examples

Using Google Maps API for .NET is designed to be really easy.

Quick Note about the Google Maps API Key

Google is now requiring a proper API key for accessing the service. Use the Google Developers Console to create one for your project.

Getting an address from the Geocoding service

Let's suppose we want to search an address and get more information about it. We can write:

//always need to use YOUR_API_KEY for requests.  Do this in App_Start.
GoogleSigned.AssignAllServices(new GoogleSigned("YOUR_API_KEY"));

var request = new GeocodingRequest();
request.Address = "1600 Pennsylvania Ave NW, Washington, DC 20500";
var response = new GeocodingService().GetResponse(request);

//The GeocodingService class submits the request to the API web service, and returns the
//response strongly typed as a GeocodeResponse object which may contain zero, one or more results.

//Assuming we received at least one result, let's get some of its properties:
if(response.Status == ServiceResponseStatus.Ok && response.Results.Count() > 0)
{
    var result = response.Results.First();

    Console.WriteLine("Full Address: " + result.FormattedAddress);         // "1600 Pennsylvania Ave NW, Washington, DC 20500, USA"
    Console.WriteLine("Latitude: " + result.Geometry.Location.Latitude);   // 38.8976633
    Console.WriteLine("Longitude: " + result.Geometry.Location.Longitude); // -77.0365739
    Console.WriteLine();
}
else
{
    Console.WriteLine("Unable to geocode.  Status={0} and ErrorMessage={1}", response.Status, response.ErrorMessage);
}

Getting a static map URL

Static Maps API support allows you to get a valid url or a streamed bitmap which you can use:

//always need to use YOUR_API_KEY for requests.  Do this in App_Start.
GoogleSigned.AssignAllServices(new GoogleSigned("YOUR_API_KEY"));
var map = new StaticMapRequest();
map.Center = new Location("1600 Pennsylvania Ave NW, Washington, DC 20500");
map.Size = new System.Drawing.Size(400, 400);
map.Zoom = 14;

Sample for ASP.Net WebForms:

//Web Forms: Page method contains above code to create the request
var hyperlink = (Hyperlink)Page.FindControl("Hyperlink1");
hyperlink.NavigateUrl = map.ToUri().ToString();

For MVC controllers/views:

//MVC: controller contains above code to create the request
ViewBag["StaticMapUri"] = map.ToUri();

//MVC: view code
<img src="@ViewBag["StaticMapUri"]" alt="Static Map Image" />

You can also directly retrieve the bitmap as a byte array (byte[]) or as a Stream:

For WPF/xaml applications:

//for WPF:
BitmapImage img = new BitmapImage();
img.SourceStream = staticMapsService.GetStream(staticMapsRequest);

this.imageControl.Image = img;

Using a Google Maps for Business key

//enterprise users to use your supplied information for requests.  Do this in App_Start.
GoogleSigned.AssignAllServices(new GoogleSigned("gme-your-client-id", "your-signing-key"));

// Then do as many requests as you like...
var request = new GeocodingRequest();
//...
var response = GeocodingService.GetResponse(request);

Using a Google Maps API key

//always need to use YOUR_API_KEY for requests.  Do this in App_Start.
GoogleSigned.AssignAllServices(new GoogleSigned("your-api-key"));

// Then do as many requests as you like...
var request = new GeocodingRequest();
//...
var response = GeocodingService.GetResponse(request);

You can also use a particular key for a single request:

const GoogleSigned apikey = new GoogleSigned("special_api_key_here");
var request = new GeocodingRequest();
//...
var service = new GeocodingService(request, apikey);

Contact

Questions, comments and/or suggestions are welcome! Please raise an issue in GitHub or send an email to:

Contributors

A big thank you to all of our contributors including:

Forked from a work originally created by Luis Farzati and incorporating ideas from Brian Pedersen

A note to Contributors

In order to maintain the project files' formatting, please get the EditorConfig plugin that works with your favorite IDE. Many options available.

This will go a long ways towards helping to maintain formatting so that actual changes arent lost in formatting changes... And that's a good thing, yes? 😉

The .editorconfig file specifies the desired formatting. It basically uses an out-of-the-box Visual Studio 2013 C# editor configuration.

And to all who contribute... Thank you!

About

C# google maps api interface for interacting with the backend web services for Google Maps

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • C# 100.0%