luis-balderas / prueba-

Backend Coding Challenge

Requirements

Design a REST API endpoint that provides auto-complete suggestions for large cities.

• The endpoint is exposed at /suggestions
• The partial (or complete) search term is passed as a querystring parameter q
• The caller's location can optionally be supplied via querystring parameters latitude and longitude to help improve relative scores
• The endpoint returns a JSON response with an array of scored suggested matches
  • The suggestions are sorted by descending score
  • Each suggestion has a score between 0 and 1 (inclusive) indicating confidence in the suggestion (1 is most confident)
  • Each suggestion has a name which can be used to disambiguate between similarly named locations
  • Each suggestion has a latitude and longitude

Constraints

• Use spring boot
• The result must be deployed on google cloud (it has a free tier)

Advice

• Try to design and implement your solution as you would do for real production code. Show us how you create clean, maintainable code that does awesome stuff. Build something that we'd be happy to contribute to. This is not a programming contest where dirty hacks win the game.
• Documentation and maintainability are a plus, and don't you forget those unit tests.
• We don’t want to know if you can do exactly as asked (or everybody would have the same result). We want to know what you bring to the table when working on a project, what is your secret sauce. More features? Best solution? Thinking outside the box?

Can I use a database?

If you wish, it's OK to use external systems such as a database, an Elastic index, etc. in your solution. But this is certainly not required to complete the basic requirements of the challenge. Keep in mind that our goal here is to see some code of yours; if you only implement a thin API on top of a DB we won't have much to look at.

Our advice is that if you choose to use an external search system, you had better be doing something really truly awesome with it.

Sample responses

These responses are meant to provide guidance. The exact values can vary based on the data source and scoring algorithm

Near match

GET /suggestions?q=Londo&latitude=43.70011&longitude=-79.4163

{
  "suggestions": [
    {
      "name": "London",
      "latitude": "42.98339",
      "longitude": "-81.23304",
      "score": 0.9
    },
    {
      "name": "London",
      "latitude": "39.88645",
      "longitude": "-83.44825",
      "score": 0.5
    },
    {
      "name": "London",
      "latitude": "37.12898",
      "longitude": "-84.08326",
      "score": 0.5
    },
    {
      "name": "Londontowne",
      "latitude": "38.93345",
      "longitude": "-76.54941",
      "score": 0.3
    }
  ]
}

No match

GET /suggestions?q=SomeRandomCityInTheMiddleOfNowhere

{
  "suggestions": []
}

Deliverable

• Add a README with a curl example on how to consume your service (must be the address of the service deployed)
• You need to upload your code to a public hosting repository site (GitHub, Gitlab, Bitbucket, etc)
• When your done, share with us the link of the us