Guia de uso da ferramenta

Veja quando usar esta ferramenta, o que ela suporta e como os usuários a aplicam.

Fatos principais

Categoria: Data Processing
Tipos de entrada: text, select, checkbox, number
Tipo de saída: json
Cobertura de exemplos: 4
API pronta: Sim

Visão geral

O Mapeador de códigos de país e subdivisões ISO 3166 consulta identificadores como ISO alpha-2, alpha-3, código numérico, ccTLD, prefixo telefônico, COI, ONU M49, FIPS e ISO 3166-2. A pesquisa usa conjuntos de dados locais e retorna os resultados em JSON, incluindo fusos IANA e relações entre subdivisões e países.

Quando usar

Quando você precisa identificar um país a partir de um código ISO, domínio ccTLD, prefixo telefônico ou outro identificador.
Quando deseja consultar uma subdivisão administrativa usando um código ISO 3166-2, como US-CA.
Quando precisa comparar dados de países e subdivisões em uma resposta JSON estruturada, sem realizar chamadas de rede.

Como funciona

1Digite uma consulta, como USA, US, .us, 840 ou US-CA.
2Escolha o campo de pesquisa ou mantenha a opção Automático para tentar identificar o tipo de código.
3Ative Incluir subdivisões quando quiser consultar dados de subdivisões associadas ao país.
4Defina o limite de resultados entre 1 e 50 e execute a consulta para receber os dados em JSON.

Casos de uso

Validar e padronizar códigos de país em cadastros, tabelas e sistemas de dados.
Relacionar códigos ISO 3166-2 a seus países pai em aplicações que trabalham com estados, províncias ou outras subdivisões.
Consultar rapidamente ccTLDs, prefixos telefônicos, fusos IANA e identificadores internacionais durante análises ou integrações.

Exemplos

1. Inspecionar os códigos dos Estados Unidos

Analista de dados

Contexto

Uma analista recebeu uma tabela com o código USA e precisa verificar os principais identificadores internacionais do país.

Problema

Encontrar os códigos ISO, ccTLD, prefixo, COI, FIPS e fuso horário em uma única resposta estruturada.

Como usar

Informe USA no campo Consulta, mantenha Campo de pesquisa em Automático, desative Incluir subdivisões e use o limite padrão de 20 resultados.

{"query":"USA","searchBy":"auto","includeSubdivisions":false,"limit":20}

Resultado

A ferramenta resolve o país e retorna um registro JSON estruturado com os dados de código disponíveis.

2. Encontrar a subdivisão US-CA

Desenvolvedor

Contexto

Um desenvolvedor precisa associar o código ISO 3166-2 US-CA ao país correspondente em um cadastro territorial.

Problema

Consultar a subdivisão e identificar sua relação com o país pai.

Como usar

Informe US-CA no campo Consulta, selecione Subdivisão ISO 3166-2, mantenha Incluir subdivisões desativado e execute a pesquisa.

Perguntas frequentes

Quais identificadores podem ser consultados?

Você pode pesquisar por nome do país, ISO alpha-2, ISO alpha-3, código numérico, ccTLD, prefixo telefônico, COI, ONU M49, FIPS e subdivisão ISO 3166-2.

O que acontece se eu deixar o campo de pesquisa em Automático?

A ferramenta tenta identificar automaticamente o tipo de valor informado, como USA, .us, 840 ou US-CA.

A ferramenta consulta dados pela internet?

Não. Ela usa conjuntos de dados locais integrados e não realiza chamadas de rede.

Posso consultar subdivisões de um país?

Sim. Ative Incluir subdivisões para incluir subdivisões ISO 3166-2 relacionadas ao país.

Qual é o formato do resultado?

O resultado é retornado em JSON estruturado.

{"query":"US-CA","searchBy":"subdivision","includeSubdivisions":false,"limit":20}

3. Pesquisar um país pelo domínio ccTLD

Profissional de suporte técnico

Contexto

Um profissional recebeu o domínio .us e precisa confirmar a qual país ele corresponde.

Problema

Resolver um ccTLD sem consultar manualmente uma tabela de códigos.

Como usar

Digite .us no campo Consulta e selecione ccTLD em Campo de pesquisa.

{"query":".us","searchBy":"tld","includeSubdivisions":false,"limit":20}

Resultado

A ferramenta retorna o registro do país associado ao domínio informado em JSON.

Mapeador de códigos de país e subdivisões ISO 3166

O que esta ferramenta ajuda você a fazer

Executar esta ferramenta

Exemplos compatíveis com esta ferramenta

Continue com ferramentas e temas relacionados

Veja quando usar esta ferramenta, o que ela suporta e como os usuários a aplicam.

Fatos principais

Visão geral

Quando usar

Como funciona

Casos de uso

Exemplos

1. Inspecionar os códigos dos Estados Unidos

2. Encontrar a subdivisão US-CA

Perguntas frequentes

Exemplos de Códigos QR

Exemplos de Comentários de Código

Amostras de codigo

Amostras de Documentação de Código

Redator de Logs

Validador de Chave Estrangeira

Código de Chamada Internacional

Calculadora de Flecha Máxima de Viga

3. Pesquisar um país pelo domínio ccTLD