Geocodificação com teto
Pode deduplicar o cadastro, estimar créditos pela tabela oficial, parar acima do teto aprovado e separar os endereços de baixa pontuação para revisão.
Entrega: estimativa, pontos e fila de revisãoOcto para serviços e REST do ArcGIS
Tudo tem URL. O teto de créditos é seu.
No ArcGIS, camadas, ferramentas de geoprocessamento, geocodificação, rotas e frota são serviços com endereço HTTP. Dá para automatizar com curl ou Python, em Linux inclusive. O Octo pode estimar o custo antes de gastar, escrever scripts que só simulam até alguém aprovar e montar as filas de revisão: endereços de baixa pontuação, conflitos de sincronização, pedidos fora da janela. Gastar créditos, escrever em produção e enviar endereços (que são dado pessoal) continuam sendo decisões de pessoas habilitadas do cliente.
Geocodificação armazenada40créditos por 1.000 no ArcGIS Online
Lote direto, serviço mundial1000endereços por chamada (sugere 150)
Frota (VRP), modo job2.000pedidos e 100 rotas por job
Fontes15listadas no fim da página
01
O que o Octo faz com os serviços.
Seis entregas possíveis, tiradas do levantamento. Todas partem de leitura e simulação; escrita em produção, publicação e gasto de créditos ficam com quem o cliente habilitar.
Sincronização com sistema legado
Pode puxar o que mudou em campo com extractChanges, aplicar o delta do ERP com applyEdits e conferir as contagens dos dois lados no fim.
Rotas, frota e áreas de serviço
Pode montar o job de roteirização (VRP) a partir de planilhas, com janela de horário e capacidade, e devolver um relatório por veículo e os pedidos que não couberam.
Entrega: rotas propostas para o despachanteExtração paginada e indicadores
Pode baixar camadas inteiras com resultOffset, conferir o total com returnCountOnly e calcular indicadores por grupo no próprio servidor.
Publicação preparada
Propõe o fluxo de publicação por script (arcpy: rascunho, StageService, UploadServiceDefinition) para a pessoa habilitada rodar e conferir.
Credenciais de escopo mínimo
Pode desenhar uma credencial por finalidade (só geocodificar, só ler uma camada), com validade e rodízio de chaves, sempre fora do código.
Entrega: matriz de credenciais e privilégios
02
Oito braços, uma chamada de serviço.
O mesmo ciclo do Octo, aplicado à REST API do ArcGIS. Cada braço tem um papel estreito; quem gasta créditos, escreve em produção e publica são pessoas habilitadas do cliente.
-
Descoberta
Lê os serviços
ArcGIS Online ou Enterprise, versão, descrição de cada serviço: capacidades,
maxRecordCount, paginação, ChangeTracking, formatos aceitos. -
Dados
Fixa chaves e contagens
Qual campo liga o mapa ao ERP, com índice único; sistema de coordenadas; quantos registros cada lado tem antes de começar.
-
Segurança
Credencial mínima e LGPD
Uma credencial por finalidade, só em variável de ambiente. Endereço é dado pessoal: o envio a serviço externo é decidido antes, com o cliente.
-
Arquitetura
Escolhe a operação
Lote direto ou job por arquivo;
applyEditsouappend; síncrono ousubmitJob. O custo pela tabela oficial entra na escolha. -
Desenvolvimento
Escreve o script
Em
curlou Python, com simulação por padrão, teto de créditos, retomada e repetição em erro temporário. Roda em Linux. -
Revisão
Confere pelo conteúdo
Contagem dos dois lados,
usage_costcontra a estimativa, amostra de pontos no mapa. Resposta 200 não prova que deu certo. -
Publicação
Entrega para quem executa
Só com o seu ok, e pela pessoa habilitada: a execução com
--executar, a carga em produção, a publicação da camada. -
Documentação
Registra o que vale no seu ambiente
Versão do serviço, parâmetros, custo real e data de cada execução. A próxima estimativa parte do custo medido, não da tabela.
O Octo não gasta créditos acima do teto combinado, não escreve em serviço de produção e não publica camadas. Isso cabe a pessoas habilitadas do cliente.
03
Cada tarefa, o seu caminho.
O critério que o Octo usa para escolher a operação. Preços e limites são os da documentação da Esri consultada em 29/10/2026.
| Tarefa | Caminho | Observação |
|---|---|---|
| Baixar uma camada inteira | query com resultOffset e resultRecordCount | Exige supportsPagination; conferir com returnCountOnly |
| Indicador por grupo | query com outStatistics | Calculado no servidor, sem baixar feições |
| Editar poucos registros | applyEdits com rollbackOnFailure=true | Escrita em produção: pessoa habilitada |
| O que mudou desde ontem | extractChanges com layerServerGens | Exige ChangeTracking |
| Geocodificar 100 mil ou mais | Job BatchGeocode com arquivo CSV | 40 créditos por 1.000 no ArcGIS Online |
| Rotas de frota com janela | VRP por submitJob | Até 2.000 pedidos e 100 rotas por job |
| Distância entre muitos pares | Matriz origem-destino | 0,5 crédito por 1.000 pares no ArcGIS Online |
| Publicar ou sobrescrever camada | arcpy: rascunho, StageService, UploadServiceDefinition | Exige ArcGIS Pro, que roda em Windows |
04
Do script avulso à rotina.
Três degraus. Cada um só faz sentido depois que o anterior mostrou resultado no seu ambiente.
Proposta, não promessa
Leitura e estimativa
Com acesso de leitura, o Octo descreve os serviços e estima o custo dos trabalhos que você tem em mente.
- Inventário de capacidades de cada serviço
- Extração paginada conferida por contagem
- Custo estimado pela tabela oficial, já com dedup
Procedimentos com simulação
Geocodificação, sincronização e roteirização passam a rodar com simulação aprovada e teto de créditos.
- Filas de revisão em vez de conferência total
- Conflitos e não atendidos com motivo
- Custo real comparado com a estimativa
Rotina noturna acompanhada
A sincronização e as cargas viram rotina agendada no ambiente do cliente, com alerta quando a conferência falha.
- Estado que só avança com contagens batendo
- Histórico de custo por execução
- Rodízio de chaves antes do vencimento
05
Confirmado em fonte.
Cada ponto abaixo tem fonte publicada pelo fabricante, pelo projeto ou pelo órgão responsável. As fontes estão na seção seguinte.
4
pontos com fonte publicada, cada um com a referência indicada ao lado.
- ConfirmadoPreço da geocodificação
- Geocodificação armazenada, que inclui o lote direto e o job por arquivo: 40 créditos por 1.000 no ArcGIS Online ou US$ 4 por 1.000 no ArcGIS Location Platform. A cobrança é por resultado devolvido;
suggesté grátis.Fonte: ArcGIS Geocoding service; Understand credits (ArcGIS Online) - ConfirmadoLote e frota: limites
- O serviço mundial de geocodificação informa
MaxBatchSize1000 eSuggestedBatchSize150. O job de frota aceita até 2.000 pedidos, 100 rotas, 200 pedidos por rota e 4 horas de execução; a tabela de preços lista 1.000 créditos por 1.000 rotas de frota.Fonte: descrição do GeocodeServer lida em 29/10/2026; SolveVehicleRoutingProblem; ArcGIS Routing service - ConfirmadoMudanças incrementais e upsert
extractChangesexige ChangeTracking; no ArcGIS Online, um serviço hospedado não pode ter Sync e ChangeTracking juntos. O upsert doappendnão é aceito com sync ou changeTracking ligados e casa por ObjectID, GlobalID ou campo com índice único (upsertMatchingField).Fonte: Extract Changes e Append (Feature Service), developers.arcgis.com- ConfirmadoTokens e chaves
- Token de aplicativo por
client_credentials: validade padrão de 120 minutos, máximo de 20.160. Chaves de API valem no máximo um ano, até duas por credencial, com privilégios escolhidos. API Pythonarcgis2.4.4 publicada em 20/10/2026.Fonte: Token (OAuth 2.0); API key credentials; PyPI
06
O que o Octo faz e o que fica com vocês.
O Octo prepara tudo, mas não assina. O documento que vale continua com quem responde por ele.
O Octo prepara
Levanta, calcula, organiza e gera os documentos: planilhas, relatórios, mapas e minutas.
Entrega: material pronto para conferirA sua equipe confere
O profissional habilitado confere o que o Octo entregou antes de assinar. Se algo não fecha, volta para o Octo com a correção.
Etapa: conferência por quem assinaQuem assina
O Octo não assina. Projeto, laudo, ART/RRT, prestação de contas e qualquer documento oficial continuam assinados pelo profissional habilitado da empresa ou do órgão: aqui, o responsável técnico pelo mapa ou pelo levantamento.
Assinatura: responsável técnico pelo mapa ou levantamento
07
Fontes.
Documentação da Esri usada no levantamento, consultada em 29/10/2026.
- ArcGIS Geocoding serviceOperações e preços
- geocodeAddressesLote direto
- BatchGeocodeJob por arquivo
- ArcGIS Routing servicePreços de rota, área de serviço, matriz e frota
- SolveVehicleRoutingProblemFrota, modo job, limites
- ArcGIS GeoEnrichment servicePreços
- ArcGIS Elevation servicePreços e acesso
- Understand creditsCréditos no ArcGIS Online
- Query (Feature Service/Layer)Paginação e estatística
- Apply EditsEdição em lote
- AppendCarga e upsert
- Extract ChangesMudanças incrementais
- Token (OAuth 2.0)client_credentials e validade
- API key credentialsPrivilégios e expiração
- FeatureSharingDraft (arcpy)Publicação por script
Seus serviços, automatizados dentro do teto.
O diagnóstico começa só com leitura: a descrição dos seus serviços e uma estimativa de custo do trabalho que você tem em mente. Você recebe uma proposta e decide com ela na mão.