Points Of Interest (POIs)

• Overview
• Endpoints
• Instalação
  • Repositório
  • Configuração
• Úteis
• FAQ

Overview

Implementação do desafio Pontos de Interesse por GPS, do repositório backend-br.

Pontos de Interesse por GPS

A XY Inc. é uma empresa especializada na produção de excelentes receptores GPS (Global Positioning System). A diretoria está empenhada em lançar um dispositivo inovador que promete auxiliar pessoas na localização de pontos de interesse (POIs), e precisa muito de sua ajuda. Você foi contratado para desenvolver a plataforma que fornecerá toda a inteligência ao dispositivo! Esta plataforma deve ser baseada em serviços REST, de forma a flexibilizar a integração.

1. Construa um serviço para cadastrar pontos de interesse, com 3 atributos: Nome do POI, coordenada X (inteiro não negativo) e coordenada Y (inteiro não negativo). Os POIs devem ser armazenados em uma base de dados.

2. Construa um serviço para listar todos os POIs cadastrados.

3. Construa um serviço para listar POIs por proximidade. Este serviço receberá uma coordenada X e uma coordenada Y, especificando um ponto de referência, bem como uma distância máxima (d-max) em metros. O serviço deverá retornar todos os POIs da base de dados que estejam a uma distância menor ou igual a d-max a partir do ponto de referência.

Exemplo de Base de Dados:

• 'Lanchonete' (x=27, y=12)
• 'Posto' (x=31, y=18)
• 'Joalheria' (x=15, y=12)
• 'Floricultura' (x=19, y=21)
• 'Pub' (x=12, y=8)
• 'Supermercado' (x=23, y=6)
• 'Churrascaria' (x=28, y=2)

Exemplo de Uso:

Dado o ponto de referência (x=20, y=10) indicado pelo receptor GPS, e uma distância máxima de 10 metros, o serviço deve retornar os seguintes POIs:

• Lanchonete
• Joalheria
• Pub
• Supermercado

Endpoints

URLs de acesso:

Cadastrar POI

Cadastrar um ponto de interesse.

[POST] {{dns}}/pois

Request

{
    "name": "Pub",
    "point": {
        "x_coordinate": 12,
        "y_coordinate": 8
    }
}

Response

HTTP/1.1 201 Created
Content-Type: application/json

{
    "name": "Pub",
    "point": {
        "x_coordinate": 12,
        "y_coordinate": 8
    }
}

Listar POIs

Listar todos os pontos de interesse cadastrados, ou, utilizando os filtros, apenas os pontos de interesse cadastrados, que estejam a uma distância menor ou igual a distance a partir do ponto de referência (x_coordinate e y_coordinate).

[GET] {{dns}}/pois?x_coordinate=20&y_coordinate=10&distance=10

Request

Response

HTTP/1.1 200 OK
Content-Type: application/json

[
    {
        "name": "Pub",
        "point": {
            "x_coordinate": 12,
            "y_coordinate": 8
        }
    }
]

Instalação

Repositório

Para clonar o repositório usando a linha de comando, execute:

git clone https://github.com/gustavofreze/points-of-interest.git

Configuração

make configure

Úteis

• Para todos os containers do projeto:

  make stop

• Remove todos os containers e networks criados pelo projeto:

  make clean

• Remove todos os containers, networks e imagens criados pelo projeto:

  make clean-all

FAQ

• Existe algum trade-off em modelar a lógica de obter os pontos de interesse, com base no ponto de referência, nos modelos?

  Sim, para uma aplicação de produção, em que o banco de dados pode crescer exponencialmente. Em uma situação em que você tem um número enorme de pontos para processar, uma limitação de memória seria inerente. Então, faria sentido, essa lógica estar no banco de dados.