Informar primeiro diário disponível ao pesquisar sobre uma cidade

[trevineju]

Descrição

Ao fazer uma busca selecionando uma cidade ou um grupo de cidades, aparece um componente informando o nível de cada cidade pesquisada.

Melhoria

Esse componente poderia ser adaptado para indicar a data da primeira edição disponível de cada uma dessas cidades. Por exemplo, adicionando a mensagem em frente aos nomes dos municípios:

(Rio de Janeiro (RJ) ) disponível desde ( DD / MM / AAAA )
(Mascote (BA) ) disponível desde ( DD / MM / AAAA )

isso ajudaria a transparecer que apesar destas (e outras) cidades estarem disponíveis, a série histórica delas é diferente

[emmenezes]

Oii, eu fiquei interessada pela issue, mas, pelo que entendi, o tipo retornado sobre as cidades é:

{
  "cities": [
    {
      "territory_id": "string",
      "territory_name": "string",
      "state_code": "string",
      "publication_urls": [
        "string"
      ],
      "level": ""
    }
  ]
}

Como poderíamos obter essa informação sobre data?

[trevineju]

Acho que podemos obter isso fazendo uma requisição na API, sem nenhuma palavra-chave, e usando os campos size e sort_by do endpoint de Gazettes.

Se usar sempre size=1 vai retornar um resultado. E se trocar o sort_by entre a ordenação crescente ou decrescente, vai retornar o diário mais velho e o mais novo no banco de dados.

Pegando dois exemplos:

Barreiras-BA

• Requisição para pegar a data inicial: https://queridodiario.ok.org.br/api/gazettes?territory_ids=2903201&excerpt_size=100&number_of_excerpts=1&pre_tags=&post_tags=&size=1&sort_by=ascending_date

  {
  "total_gazettes":3635,
  "gazettes":[{
      "territory_id":"2903201",
      "date":"2008-01-02",
      "scraped_at":"2023-07-14T14:05:05.400971",
      "url":"https://querido-diario.nyc3.cdn.digitaloceanspaces.com/2903201/2008-01-02/fc0322bd4b8827fa09f0fdb7954a732632826396.pdf",
      "territory_name":"Barreiras",
      "state_code":"BA",
      "excerpts":[],
      "edition":"601",
      "is_extra_edition":false,
      "txt_url":"https://querido-diario.nyc3.cdn.digitaloceanspaces.com/2903201/2008-01-02/fc0322bd4b8827fa09f0fdb7954a732632826396.txt"
      }]
  }

• Requisição para pegar a data final: https://queridodiario.ok.org.br/api/gazettes?territory_ids=2903201&excerpt_size=100&number_of_excerpts=1&pre_tags=&post_tags=&size=1&sort_by=descending_date

  {
  "total_gazettes":3635,
  "gazettes":[{
      "territory_id":"2903201",
      "date":"2024-11-01",
      "scraped_at":"2024-11-03T07:59:39.879597",
      "url":"https://querido-diario.nyc3.cdn.digitaloceanspaces.com/2903201/2024-11-01/2768c136eb18020ebf3014678e72faf6ae452aeb.pdf",
      "territory_name":"Barreiras",
      "state_code":"BA",
      "excerpts":[],
      "edition":"4283",
      "is_extra_edition":false,
      "txt_url":"https://querido-diario.nyc3.cdn.digitaloceanspaces.com/2903201/2024-11-01/2768c136eb18020ebf3014678e72faf6ae452aeb.txt"}]
  }

A exibição poderia ser algo como:

# opção 1 - deixando implícito que é até a atualidade
( Barreiras (BA) ) disponível desde ( 02 / 01 / 2008 ) 

# opção 2 - explicitando a data final
( Barreiras (BA) ) disponível desde ( 02 / 01 / 2008 ) até ( 01 / 11 / 2024 )

Camaquã-RS

• Requisição para pegar a data inicial: https://queridodiario.ok.org.br/api/gazettes?territory_ids=4303509&excerpt_size=100&number_of_excerpts=1&pre_tags=&post_tags=&size=1&sort_by=ascending_date
• Requisição para pegar a data final: https://queridodiario.ok.org.br/api/gazettes?territory_ids=4303509&excerpt_size=100&number_of_excerpts=1&pre_tags=&post_tags=&size=1&sort_by=descending_date

A exibição ficaria algo como:

# nesse caso, a data final é obrigatória visto que é uma data antiga
( Camaquã (RS) ) disponível desde ( 25 / 07 / 2019 ) até ( 25 / 09 / 2023 )