ExMaps

Fast, industrial strength, concurrent Google Maps interface for Elixir platforms.

Overivew

Currently this wrapper handles directions calculations. Google Directions API is a service that calculates directions between locations. You can search for directions for several modes of transportation, including transit, driving, walking, or cycling. Yes, it's written in Elixir so it's concurrent. It means that every coordinates entry on param list will spawn separate Elixir process (task) to retrieve the data from Google API or the cache if query has been already sent. It allows to create large amounts of queries in the same time and return them quickly.

The application is using super fast generational caching lib Nebulex. Since its latest version is rc3, this package is also treated as release candidate.

Installation

Add ExMaps as a dependency to your mix.exs file:

defp deps() do
  [{:ex_maps, "1.0.0-rc.1"}]
end

Configuration

In order to be able to use Google API, you need to get free or commercial key. Please then create environmental variable MAPS_API_KEY with the value of your key.

If you are going to use this application as a dependency in your own project, you will need to copy and paste below configuration to your config/config.exs file:

config :ex_maps, api_key: System.get_env("MAPS_API_KEY")

config :ex_maps, ExMaps.Cache,
  adapter: Nebulex.Adapters.Local,
  n_shards: 2,
  gc_interval: 3600

..and you are ready to go!

Basic Usage

Please note that free Google API key has some limitations and it will be easy to exceed query limit per second. First param is a list of coordinates, second one is a list of additional options explained on hexdocs and Google Dev Guide.

ExMaps.get_directions([%{origin: "Warsaw", destination: "Amsterdam"}], units: :metric)
[%{"geocoded_waypoints" => ... }]

You can of course mix coordinates types, ie. cities names, latitude / longitude, etc.

ExMaps.get_directions([%{origin: "Warsaw", destination: "Amsterdam"}, %{origin: {52.3714894, 4.8957388}, destination: {52.3719729, 4.8903469}}], units: :metric)
[%{"geocoded_waypoints" => ... }, %{"geocoded_waypoints" => ... }]

To do

• Add Distance Matrix
• Simplify configuration
• Expand test and docs coverage

License

This project is MIT licensed. Please see the LICENSE.md file for more details.