geolocation_complete.ex

defmodule Legolas.Geolocation do
  @moduledoc """
  Public interface for all geolocation related functionality
  """

  alias Legolas.Geolocation.Cache
  alias Legolas.Geolocation.CityLocation
  alias Legolas.Geolocation.GoogleMaps.Client

  @type address :: {zip :: String.t, city :: String.t, country :: String.t}
  @type geolocation :: {latitude :: number, longitude :: number}

  def child_spec([]) do
    %{
      id: __MODULE__,
      start: {Cache, :start_link, []}
    }
  end

  @doc """
  Finds the geolocation for the given city address
  """
  @spec lookup(address) :: {:ok, geolocation} | {:error, any}
  def lookup(address) do
    case Cache.fetch(address, fn -> Client.lookup(address) end) do
      {:ok, %CityLocation{} = location} ->
        {:ok, {location.latitude, location.longitude}}
      {:error, reason} ->
        {:error, reason}
    end
  end
end