Comparar
Geocode AI vs. OpenStreetMap bruto
Todo limite que servimos vem do OpenStreetMap. A questão é se você quer cuidar sozinho das consultas, da montagem dos polígonos, do cache e da validação.
| Por conta própria | Geocode AI | |
|---|---|---|
| Fonte dos dados | OpenStreetMap | OpenStreetMap |
| Busca por nome | Busca do Nominatim | search_boundaries (grátis) |
| Polígono por id | polygon_geojson do Nominatim ou Overpass, depois montar a relação | get_boundary, uma chamada |
| Reversa: todos os limites em um ponto | Várias chamadas ao Overpass ou ao Nominatim | reverse_boundaries, uma chamada |
| Subdivisões de um limite | Consulta de área no Overpass, filtrar vizinhos por conta própria | list_children (grátis) |
| Lotes de ponto em polígono | Seu próprio PostGIS ou Turf | contains_points |
| Simplificado para mapas | Simplificar por conta própria | low / medium / high / full |
| Formatos | GeoJSON ou OSM XML | GeoJSON, KML, WKT, GML, SVG |
| Limites de uso | Nominatim público: cerca de 1 requisição por segundo, sem uso intenso | Limites do plano; cache para todos |
| Custo | Grátis (seus servidores e seu tempo) | Plano grátis, depois por unidade |
| Descrever uma área em palavras |
O que fazer por conta própria envolve
O OpenStreetMap armazena um limite administrativo como uma relação: uma lista de vias que, juntas, formam anéis externos e internos. Para obter um polígono utilizável, você encontra a relação (normalmente com o Nominatim), busca as vias que a compõem (o polygon_geojson do Nominatim, o Overpass ou um serviço de polígonos), costura tudo em anéis fechados, corrige autointerseções e decide o que fazer com exclaves e enclaves.
Depois você precisa da hierarquia: em qual condado fica uma cidade, ou quais distritos uma cidade tem. Consultas de área no Overpass respondem isso, mas também retornam vizinhos que compartilham uma divisa, então você precisa filtrá-los pela geometria. Por fim, os servidores públicos pedem uso leve: a política de uso do Nominatim permite cerca de uma requisição por segundo e nenhum download em massa, então um produto que geocodifica os dados dos seus usuários precisa de um cache na frente.
O Geocode AI é esse cache e esse pipeline na forma de uma API: cada limite é buscado uma vez, validado, armazenado no PostGIS e servido a todos a partir daí, com a hierarquia, as exportações e as verificações de pontos por cima. As requisições ao upstream passam por uma única fila com limite de taxa, então respeitamos a política por você.