View Source LocationSimulator

Use for simulating location/GPS (longitude, latitude, altitude) data. Support scalable for test workload.

Source code is available on Github

Package for using on



The library has 3 main part:

  1. Supervisor. Lib uses PartitionSupervisor for creating worker from config
  2. Worker. Generating GPS with user config
  3. Callback module. This is defined by user to handle event from worker


Api call flow

    participant CallbackModule
    participant Worker
    participant Api
    participant Supervisor

    Api->>Supervisor: Start with workers from config
    Supervisor->>Worker: Start GPS generator
    Worker->>CallbackModule: call start event
    Worker->>CallbackModule: call gps event
    Worker->>CallbackModule: call stop event

(for in local you need install extension support for mermaid to view flow)



Library can be installed by adding location_simulator to your list of dependencies in mix.exs:

def deps do
    {:location_simulator, "~> 0.3.4"}

Library need to start before using APIs. If you need start with your app, you could add to application function:

def application do
    mod: {YourApp.Application, []},
    extra_applications: [:logger, :location_simulator]

If you need to modify source please go to Github and clone repo or contribute our repo.



Start LocationSimulator with default config:


With default config simulator will print location to console by Logger.

Start with your callback & config:

config =
      worker: 3,
      event: 100,
      interval: 1000,
      random_range: 0,
      direciton: :random,
      altitude: 100,
      altitude_way: :up,
      callback: MyCallbackModule


Simulator support directions:

:north, :south, :east, :west, :north_east, :north_west, :south_east, :south_west

If :direction is missed or equal :random, simulator will random a direction for each worker.

With altitude, you can set start level and way :up or :down or no move up/down by any value.

If you want all worker started from same point, you can add :started_gps. In this case altitube config from outside will be ignored.

config =
    started_gps: {20.95991288388162, 107.06662537952286, 0}



Start library in Elixir's shell:

mix deps.get

iex -S mix

iex(1)> LocationSimulator.start()

For writing callback module please go to LocationSimulator.Event document.

We provide simple demo that generate a GPX file. You can get from repo