Busca por locais

#Busca por locais específicos

Para buscar um local cadastrado na API do QualP, você deve utilizar a URL abaixo através do método GET;

http://api.qualp.com.br/places/locations/<integration_id>

O parâmetro integration_id refere-se ao id de integração cadastrado.

O retorno desta requisição, caso o local seja encontrado, será o seguinte:

{
    "id": 4,
    "user_id": 1439,
    "uf_id": 16,
    "uf": "PR",
    "integration_id": "sdklfjklsdfsd",
    "area_polygon": null,
    "name": "LOCAL TESTE DESENVOLVIMENTO",
    "cpf_cnpj": "10841201943",
    "description": "esse é um local de teste",
    "cep": "00000-00",
    "city": "Ponta Grossa",
    "street": "RODOVIA BR 158",
    "number": "5",
    "neighbourhoods": "Centro",
    "complement": "Não tem",
    "latitude": "-15.8772692",
    "longitude": "-52.3144175",
    "additional_information": "teste trizy",
    "deleted_at": null,
    "created_at": "2020-08-14T13:59:23.000000Z",
    "updated_at": "2020-08-14T13:59:23.000000Z",
    "location_areas": [],
    "categories": [
        {
            "user_id": 1439,
            "integration_id": "987654321",
            "name": "Test",
            "description": null,
            "deleted_at": null,
            "created_at": "2020-08-14T13:59:02.000000Z",
            "updated_at": "2020-08-14T13:59:02.000000Z",
            "pivot": {
                "location_id": 4,
                "category_id": 1
            }
        }
    ],
    "location_contact": [],
    "products": [],
    "services": []
}

#Busca por locais próximos a um ponto

Para buscar locais que estão próximos a um determinado ponto, você deve utilizar a URL abaixo através do método GET

http://api.qualp.com.br/places/locations/distance

Os parâmetros necessários para realizar uma consulta via GET para a nossa api são mostrados abaixo:

{
    "location": "-25.43998,-49.27654",
    "distance": 5000,
    "category": "Postos"
}

• location: Este parâmetro é obrigatório, você informa o ponto pelo qual deseja obter locais próximos. Pode ser passado uma string com um CEP, nome de rua, cidade ou mesmo um objeto contendo uma latitude e uma longitude.
• distance: Este parâmetro é obrigatório, você informa a ditância em metros.
• category: Este parâmetro é opcional, você informa o nome ou o integration_id da categoria, dessa forma somente os locais pertencentes a essa categoria serão retornados.

O retorno desta requisição, caso locais sejam encontrados, será o seguinte:

[
  {
    "id": 4,
    "user_id": 1439,
    "uf_id": 16,
    "uf": "PR",
    "integration_id": "sdklfjklsdfsd",
    "area_polygon": null,
    "name": "LOCAL TESTE DESENVOLVIMENTO",
    "cpf_cnpj": "10841201943",
    "description": "esse é um local de teste",
    "cep": "00000-00",
    "city": "Ponta Grossa",
    "street": "RODOVIA BR 158",
    "number": "5",
    "neighbourhoods": "Centro",
    "complement": "Não tem",
    "latitude": "-15.8772692",
    "longitude": "-52.3144175",
    "additional_information": "teste trizy",
    "deleted_at": null,
    "created_at": "2020-08-14T13:59:23.000000Z",
    "updated_at": "2020-08-14T13:59:23.000000Z",
    "categories": [
      {
        "user_id": 1439,
        "integration_id": "987654321",
        "name": "Test",
        "description": null,
        "deleted_at": null,
        "created_at": "2020-08-14T13:59:02.000000Z",
        "updated_at": "2020-08-14T13:59:02.000000Z",
        "pivot": {
          "location_id": 4,
          "category_id": 1
        }
      }
    ]
  },
  {
    "id": 4,
    "user_id": 1439,
    "uf_id": 16,
    "uf": "PR",
    "integration_id": "sdklfjklsdfsd2",
    "area_polygon": null,
    "name": "LOCAL TESTE DESENVOLVIMENTO2",
    "cpf_cnpj": "10841201943",
    "description": "esse é um local de teste2",
    "cep": "00000-00",
    "city": "Ponta Grossa",
    "street": "RODOVIA BR 158",
    "number": "5",
    "neighbourhoods": "Centro",
    "complement": "Não tem",
    "latitude": "-15.8772692",
    "longitude": "-52.3144175",
    "additional_information": "teste trizy",
    "deleted_at": null,
    "created_at": "2020-08-14T13:59:23.000000Z",
    "updated_at": "2020-08-14T13:59:23.000000Z",
    "categories": [
      {
        "user_id": 1439,
        "integration_id": "987654321",
        "name": "Test",
        "description": null,
        "deleted_at": null,
        "created_at": "2020-08-14T13:59:02.000000Z",
        "updated_at": "2020-08-14T13:59:02.000000Z",
        "pivot": {
          "location_id": 4,
          "category_id": 1
        }
      }
    ]
  }
]