defmodule ApiBrasil.Data.Geolocation do
  @moduledoc """
  Geolocalização (device-based): `POST /geolocation/{action}`.

  Além das funções nomeadas, `request/4` aceita qualquer action do catálogo e
  `queue/4` executa a mesma action por fila.

      {:ok, envelope} = ApiBrasil.Data.Geolocation.geocode(client, body)
      ApiBrasil.Core.DeviceResponse.response(envelope)
  """

  use ApiBrasil.Core.Service, device: "geolocation"

  action(:geocode, "geocode", "Converte endereço em coordenadas: `POST /geolocation/geocode`.")

  action(
    :forward_geocoding,
    "forward-geocoding",
    "Geocoding direto: `POST /geolocation/forward-geocoding`."
  )
end