Epinova.GoogleGeocoding

Epinova's take on Google Geocoding API

Usage

Configuration

No configuration via config files are needed. All API calls are made towards Google's production endpoint. Each service method in this API wrapper takes in an API key, so it is the calling application that decides how to configure that.

Add registry to IoC container

If using Structuremap:

    container.Configure(
        x =>
        {
            x.Scan(y =>
            {
                y.TheCallingAssembly();
                y.WithDefaultConventions();
            });

            x.AddRegistry<Epinova.GoogleGeocoding.GeocodingRegistry>();
        });

If you cannot use the structuremap registry provided with this module, you can manually set up GeocodingService for IGeocodingService.

Inject contract and use service

Epinova.GoogleGeocoding.IGeocodingService describes the service.

Basically, you can fetch geocoding info by a full address string, or by postalcode+country. This last one can be tricky without a good geocoding service API.

Prerequisites

• Epinova.Infrastructure >= v11.1.0.95.
• EPiServer.Framework >= v11.1 for logging purposes.
• Automapper >= v9.0 for mapping models.
• StructureMap >= v4.7 for registering service contract.

Installing

The module is published on nuget.org.

nuget install Epinova.GoogleGeocoding

Target framework

• .NET Standard 2.0
• Tests target .NET Core 2.1

Authors

• Tarjei Olsen - Initial work - apeneve

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE file for details

Further reading

Geocoding API Developer Guide