1. git clone ...
2. cd homeday
3. bundle install
4. rake db:setup
5. rake db:seed

1. run app.rb
2. goto http://localhost:4567/?lng=13.4236807&lat=52.5342963&property_type=single_family_house&marketing_type=sell

rspec spec

https://homeday-api.herokuapp.com/?lng=13.4236807&lat=52.5342963&property_type=single_family_house&marketing_type=sell

At Homeday, we are working to improve the process of selling real estate by giving real estate agents the best tools to do their job.

One of the most important questions when dealing with real estate is the property price. Given a specific property, there isn't always a clear way to arrive at a price, but there are estimations, comparisons, historical data, etc. that can support an agent in giving a realistic price estimation.

We have accumulated an extensive database of real estate listings dating back several years ago and covering the whole Germany. That data is used both to provide estimations and values to compare.

Your task will be to build a service that, given latitude and longitude of an object, its type and marketing type, returns a list of similar objects with their prices.

A little insight into terms: property_type is just either apartment or single_family_house and marketing type is either rent or sell.

Consider the following scenario:

• Alice, the real estate agent, is asked to estimate the sell price of an apartment that is located in Marienburger Straße 31 10405 Prenzlauer Berg, Berlin.
• Alice wants to figure out prices of similar apartments in Prenzlauer Berg
• Alice calls your service with the following params:
  • lng : 13.4236807
  • lat : 52.5342963
  • property_type : apartment
  • marketing_type : sell
• Alice receives a list of properies near the point she specified along with their prices.

Note that in the scenario above, Alice works with coordinates (lat, lng) and may not specify exact coordinates of an address.

What you have to do is to build a service that is:

• accessible with HTTP/HTTPS
• has a single endpoint that accepts latitude, longitude, property_type and marketing_type and returns a list of properties within a 5 kilometer radius along with their addresses and price.

E.g. given the input of

lng=13.4236807&lat=52.5342963&property_type=apartment&marketing_type=sell

the return value could look like

[
  {

    house_number: "31", 
    street: "Marienburger Straße", 
    city: "Berlin", 
    zip_code: "10405
    state: "Berlin",
    lat: '13.4211476',
    lng: '52.534993',
    price: '350000'

  },
  {

    house_number: "16", 
    street: "Winsstraße", 
    city: "Berlin", 
    zip_code: "10405"
    state: "Berlin",
    lat: '52.533533',
    lng: '13.425226',
    price: '320400'

  }
 # ... other properties 
]

We also expect the service to handle errors and respond with meaningful status and error messages. Some error cases are:

• No data for given location
• Invalid input params

the /data folder in this repo contains a PostgreSQL data dump containing a single table with a bunch of properties in Berlin. Use that data for your service.

The service should be written in Ruby. The rest - framework, choice of libraries/gems/external services - is entirely up to you.

• a github repo with your code
• tests, obviously
• a rationale behind the choices you've made

• Postgres has some functions to calculate distance that can be handy
• The service should have an obvious way to scale
• Response time is important