Caraca @LucasHT22 certeza que a issue ajudou sim, começando que não fazia ideia da existência disso! 😱

Vou ler um cadinho pra entender como funciona e se parece viável agregar isso tipo na v2 do cep ou numa possível v3 🤓 🤘

(ou talvez criar uma /pluscode/v1 👀 )

@LucasHT22 obrigado por trazer a informação!

Conversamos aqui, e pensamos em uma nova rota para a API, algo como pluscode/v1/:plusCode.

O input seria um plusCode, e o output seria a latitude a longitude. Seria essa a sua ideia também?

@murilohns Cara, acho que depende da intenção de uso, se a ideia é encontrar um Plus Code, aí Input seria a latitude/longitude e output seria o Plus Code, se for o contrário, encontar a latitude/longitude, o Input seria o Plus Code e a output a latitude/longitude.

A considerar que o Plus Code é usado para substituir o CEP em lugares que não tem, para mim, faria mais sentido a input ser a latitude/longitude e a output o Plus Code.

Qualquer coisa pode me chamar! :)

@LucasHT22 como a intenção do plus code é retornar uma localização mais exata, pra mim o que faz sentido é a partir de um plus code retornar uma latitude e longitude

existe algum caso de uso que você precise de um plus code, invés da latitude e longitude? 🤔

Considerando o cenário que você trouxe, essa feature caberia melhor no endpoint de cep/v2, dado que já temos a latitude e longitude (aproximada) do CEP.

Mas ainda assim, voltamos ao problema inicial da issue, que é "Lugares sem CEP" 🤔

@murilohns tem razão! Faz mais sentido mesmo.
Não, não tenho aplicação que precise :)

Olá, turma!

Adianto que esta é minha primeira vez contribuindo para um projeto open source. Estava dando uma olhada na lista de issues e fiquei absolutamente fascinado a funcionalidade sugerida pelo LucasHT22. Não sou mestre em nada, nem trabalho com desenvolvimento, mas acredito que tenha conhecimento suficiente para implementar (talvez com alguma ajudinha ou outra, rs).

Primeiramente, talvez seja interessante usar a nomenclatura do projeto Open Location Code, em vez da marca Plus Codes. Ambos são do Google, mas não sei até que ponto pode-se/deve-se usar a marca. Não sei se faz sentido.

Dois cenários possíveis

Um serviço que utiliza coordenadas geográficas para gerar Open Location Codes

Imaginei este cenário sendo usado através de um aplicativo para celular, que use a localização em tempo real para gerar um Open Location Code. O Google Maps já faz isso, mas essa funcionalidade permite desvincular isso deles (sou adepto do de-Googling haha).

Como o LucasHT22 mencionou, isso poderia ser usado em um projeto de mapeamento em uma comunidade, porém sem depender da API do Plus Codes ou usar o Google Maps. Ou simplesmente alguém que deseja gerar o Open Location Code para informar em outro lugar, como uma loja online.

Isso é possível com uma simples implementação do algoritmo de conversão do Open Location Code. Quando começar a trabalhar nisso, vou verificar melhor o que dá pra fazer.

Um serviço que utiliza Open Location Codes para obter detalhes da localização

Neste cenário (que é o que faz mais sentido mesmo), a requisição pode conter um Open Location Code completo com precisão normal ou extra (588MC9X8+G6 e 588MC9X8+G65, respectivamente). A resposta pode conter, além das coodenadas geográficas, informações sobre cidade, bairro e rua.

Isso é possível usando esta pesquisa do OpenStreetMap, que já é usada no fetchGeocoordinateFromBrazilLocation.js no endpoint dos CEPs.

A resposta para a conversão do Open Location Code mencionado acima (588MC9X8+G65) poderia ser:

{
  "state": "São Paulo",
  "city": "São Paulo",
  "suburb": "Sé",
  "road": "Praça da Sé",
  "location": {
    "type": "Point";
    "coordinates": {
      "longitude": "-46.6346253",
      "latitude": "-23.5511226",
    }
  }
}

Isso tudo, novamente, usando o algoritmo implementado no Open Location Code.

Uma limitação

Por fim, um comentário sobre uma limitação que existe, mas seria bacana encontrar uma maneira de implementar no futuro. Os códigos podem ser ainda mais curtos, substituindo os quatro primeiros caracteres por uma string posicionada no final do código. Por exemplo, o código 588MC9X8+G65 pode ser representado por "C9X8+G65 São Paulo, SP". Isso se dá pelo fato de que existem muitos Open Location Codes terminados em C9X8+G65. Porém entendo que seja inevitável implementar desta maneira sem um banco de dados para relacionar os 160k de locais possíveis.

Assim que possível vou começar a trabalhar em algumas coisas relacionadas a isso. Como falei, não tenho um grande conhecimento, mas vou aproveitar a empolgação e direcionar um pouco de esforço pra contribuir de forma legalzinha pra o projeto.

Valeu, galera!

Olá @pckcml !

Primeira vez no open source? Que legal!

Fico feliz que você se interessou pela minha issue, me mantenha atualizado sobre o andamento! Se precisar de alguma ajuda, posso ajudar :)

O plus code não é uma versão proprietária do geohash?