Geocodificação e Pesquisa Geográfica

Os localizadores permitem a você encontrar endereços e lugares que você possa visualizar em um mapa, inserir como paradas para uma rota e carregar como entrada para análise espacial. Os localizadores do ArcGIS Online incluem a pesquisa geográfica e a geocodificação da seguinte forma:

  • Pesquisa Geográfica (também conhecida como pesquisa de local)—Localize um endereço ou ponto de interesse e aplique o zoom do mapa neste local. O resultado pode ser exibido no mapa, mas o resultado não é armazenado de nenhuma maneira para uso posterior. A pesquisa geográfica está disponível para qualquer um que acessar o Map Viewer, Map Viewer Classic, ou um aplicativo público que inclua uma pesquisa de local em um mapa. Não exige uma conta organizacional ou créditos de consumo (mas você é limitado a utilizar 1 milhão de pesquisas geográficas por mês).
  • Geocodificação—Converta um endereço para uma coordenada x,y e acrescente o resultado em um registro existente em um banco de dados. O mapeamento não está sempre envolvido, mas adicionar os resultados em um mapa pode ser parte de um fluxo de trabalho. A geocodificação em lote e a geocodificação reversa caem nesta categoria. Uma conta organizacional com o privilégio de geocodificação do conteúdo premium é exigida para acessar o ArcGIS World Geocoding Service, e quaisquer visualizações dele, para geocodificação em lote.

    Anotação:

    A geocodificação reversa não é suportada para visualizações do ArcGIS World Geocoding Service.

Por padrão, o ArcGIS Online utiliza o ArcGIS World Geocoding Service para localizar endereços, cidades, pontos de referência, nomes de negócios e códigos postais em mais de 100 países ao redor do mundo. Adicionalmente, o ArcGIS World Geocoding Service é utilizado para encontrar a localização das coordenadas x, y utilizando longitude e latitude, como também, sistemas de referência de coordenadas, como Sistema de Referência da Grade Militar (MGRS) e Grade Nacional dos Estados Unidos (USNG).

Se a sua organização deseja otimizar os resultados da pesquisa para endereços e locais de interesse, os membros com privilégios para criar conteúdo poderão criar uma nova visualização do ArcGIS World Geocoding Service para procurar somente tipos de locais específicos dentro de uma área de interesse. Por exemplo, você pode criar uma visualização de localizador para limitar resultados de pesquisa para um país em particular ou área, ou somente para retornar resultados que correspondem uma categoria específica, tal como, endereços de ruas ou aeroportos. Após criar uma visualização de localizador, os membros do papel de administrador padrão poderão configurar a organização de forma que utilizem sua visualização de localizador quando os membros executarem pesquisas geográficas.

Anotação:

A utilização do ArcGIS World Geocoding Service ou de visualizações deste localizador para geocodificação em lote (incluindo publicar arquivos CSV ou da Microsoft Excel como camadas de feição hospedadas) consome créditos. A utilização de localizadores para pesquisa geográfica não consome créditos.

Uma conta organizacional com o privilégio de geocodificação do conteúdo premium é exigida para utilizar as visualizações de localizador para geocodificação em lote.

Além disso, se a sua organização precisar de geocodificar endereços ou lugares com base em seus próprios dados, os administradores poderão configurar sua organização para utilizar seus próprios localizadores executando em um site do ArcGIS Server, para pesquisa geográfica, geocodificação ou ambos. Por exemplo, uma companhia de petróleo pode adicionar localizadores para procurar seus poços de petróleo ou uma cidade pode adicionar um localizador para encontrar seus hidrantes.

Se você inserir localizadores adicionais ou visualizações do localizador, os membros visualizarão uma seta na caixa de pesquisa geográfica e poderão escolher qual localizador ou visualização utilizar.

Criar uma visualização do localizador

Você pode criar uma nova visualização do ArcGIS World Geocoding Service para pesquisar apenas tipos de locais específicos em uma área de interesse. Por exemplo, você pode desejar uma visualização de localizador para limitar os resultados da pesquisa em áreas específicas, ou você pode desejar impor um nível específico de precisão quando os membros executarem a geocodificação de endereços em lote.

Para criar e configurar uma visualização de localizador, faça o seguinte:

  1. Verifique se você está registrado na sua organização e tem privilégios para criar conteúdo.
  2. Na guia Meu Conteúdo da página de conteúdo, clique em Novo item e clique em Localizador (visualização).
  3. Insira um título e, opcionalmente, escolha uma pasta na qual salvar o item do localizador e especifique as tags e o resumo para o localizador.
  4. Clique em Salvar para criar o item de visualização do localizador.

    A página do item para a visualização de localizador que você criou abre na guia Configurações .

  5. Na parte superior da guia Configurações , clique em Configurações do Localizador (visualização).
  6. No menu suspenso, selecione o tipo de local que você deseja localizar:
    • Todos os Tipos—Escolha esta opção se você não desejar restrições sobre os tipos de locais retornados.
    • Endereços, Códigos Postais e Locais Ocupados—Escolha esta opção para limitar os resultados para ruas, cidades, estados ou códigos postais.
    • Coordenadas—Escolha esta opção para limitar os resultados ao MGRS ou para um formato específico para latitude, longitude.
    • Lugares de Interesse—Escolha esta opção para limitar os resultados para os nomes de lugares ou pontos de referência.
  7. Se você escolheu uma categoria diferente de Todos os Tipos na etapa anterior, refine ainda mais o filtro de localização conforme necessário, selecionando as caixas para as categorias que você deseja pesquisar. Por exemplo:
    • Se você escolheu Endereços, Códigos Postais e Lugares Ocupados e deseja somente que o ArcGIS World Geocoding Service retorne correspondentes com o endereço ou melhor, marque as caixas Endereço de Ponto e Endereço de Rua .
    • Se você escolheu Coordenadas e deseja tornar a latitude, longitude, o formato aceito para coordenadas, marque a caixa Latitude, Longitude .
    • Se você escolheu Lugares de Interesse e deseja somente que o ArcGIS World Geocoding Service retorne correspondentes aos aeroportos, marque a caixa Aeroporto .
  8. Especifique onde você deseja procurar por locais como segue:
    • Em qualquer lugar no mundo—Selecione esta opção para procurar por locais globalmente.
    • Em países selecionados—Selecione esta opção para procurar por locais em países específicos. Pesquise ou procure os países que deseja e selecione-os um de cada vez até que você tenha criado todas as suas seleções.
      Anotação:

      Se os seus dados tiverem um valor de país, os resultados da pesquisa incluirão quaisquer países explicitamente definidos nos dados. No entanto, se os países não estiverem explicitamente definidos nos dados, os resultados serão restritos ao país ou aos países que você definir utilizando esta configuração da visualização de localizador.

    • Dentro de uma área especificada—Selecione esta opção para definir a extensão de uma área para procurar por locais. Clique em Configurar Área e defina a extensão. Clique em OK ao finalizar.
  9. Se você escolheu Endereços, Códigos Postais e Lugares Populosos ou Lugares de Interesse para o tipo de localização que deseja encontrar, escolha um dos seguintes para especificar sua preferência para exibir localizações:
    • No lado da rua (local de rota)
    • No centróide do telhado ou lote (local de endereço)
    Anotação:

    A preferência pode não estar disponível para todos os locais. Se a preferência selecionada não estiver disponível para uma localização, a localização será exibida com a precisão mais alta disponível.

  10. Especifique sua preferência para retornar nomes de cidades da seguinte maneira:
    • Conforme definido para o país—Mantenha esta opção selecionada para retornar o nome da cidade padrão definido para o país. Por exemplo, cidades nos Estados Unidos são retornadas por padrão utilizando o nome da cidade postal.
    • Nome da cidade postal—Selecione esta opção para retornar o nome da cidade postal principal, mesmo que seja diferente do nome da cidade digitado na pesquisa. O nome da cidade postal é o nome principal atribuído ao código postal do endereço. Por exemplo, o código postal 45420 em Ohio tem um valor principal da cidade postal de Dayton. Os endereços na cidade de Kettering recebem este código postal, o que significa que as pesquisas por endereços em Kettering são retornadas como endereços de Dayton. Se esta opção estiver selecionada e um membro da organização procurar por 2109 E Dorothy Ln, Kettering, OH, 45420, o rótulo da correspondência retornado será 2109 E Dorothy Ln, Dayton, Ohio, 45420, mesmo que o endereço esteja dentro dos limites da cidade de Kettering.
    • Nome da cidade local—Selecione esta opção para retornar o nome da cidade conhecido localmente, mesmo que seja diferente do nome da cidade digitado na pesquisa. O nome da cidade local é o nome da cidade na qual o endereço está localizado e pode ser diferente da cidade postal. Por exemplo, se esta opção estiver selecionada, uma pesquisa por 2109 E Dorothy Ln, Dayton, OH, 45420—um endereço em Kettering, Ohio—retornará o rótulo de correspondência de 2109 E. Dorothy Ln, Kettering, Ohio, 45420, mesmo que Dayton esteja incluído na cadeia de pesquisa e o código postal digitado tenha um valor postal da cidade de Dayton.
    • Nome da cidade correspondente—Selecione esta opção para retornar o valor do nome da cidade correspondente quando o nome da cidade digitado em uma pesquisa corresponder a qualquer um dos valores do nome da cidade local ou do nome da cidade postal.
    Anotação:

    Nem todos os endereços têm valores de cidade postal e cidade local atribuídos a eles. Se a cidade preferida solicitada não existir nos dados, um valor diferente da cidade será retornado com base nos formatos de endereço padrão.

  11. Especifique sua preferência para retornar nomes de rua da seguinte maneira:
    • Conforme definido para o país—Mantenha esta opção selecionada para retornar o nome de rua padrão. O nome de rua padrão é o nome de rua correspondente.
    • Nome de rua correspondente—Selecione esta opção para retornar o valor do nome de rua correspondente quando o nome de rua digitado em uma pesquisa corresponder a qualquer um dos nomes de rua atribuídos a um endereço.
    • Nome de rua principal—Selecione esta opção para retornar o nome de rua principal, mesmo que seja diferente do nome alternativo de rua digitado na pesquisa. O nome de rua principal é o nome principal atribuído a uma rua. Por exemplo, se esta opção estiver selecionada, uma pesquisa por CA-138, Pearblossom, CA retornará o rótulo de correspondência de Pearblossom Hwy, Pearblossom, California, 93553.
  12. Clique em Salvar para salvar suas configurações de visualização do localizador.
  13. Compartilhe sua visualização de localizador com o público ou com sua organização.

    Você deve compartilhar a visualização de localizador para disponibilizá-la aos membros da sua organização ou ao público. Após compartilhada, um administrador poderá adicioná-la na lista de localizadores da sua organização disponível para membros utilizarem para pesquisa geográfica ou geocodificação em lote.

    Anotação:

    Os usuários anônimos terão acesso somente à sua visualização do localizador se você compartilhá-la com o público. As visualizações de localizador que são compartilhadas com a organização e incluídas na lista de localizadores da organização são acessíveis somente aos membros da organização. Os usuários anônimos não poderão realizar pesquisas geográficas em nenhum dos aplicativos utilizando localizadores que são compartilhados somente com a organização.

Se a sua visualização de localizador for adicionada à lista de localizadores da organização, é recomendável que você habilite a proteção de exclusão no item do localizador para evitar a exclusão acidental. Após adicionada, se você decidir a exclusão da sua visualização de localizador no futuro, seu administrador deverá primeiro removê-la da lista de localizadores da organização.

Tipos de locais e categorias

Esta seção descreve os tipos de locais, categorias e subcategorias disponíveis quando você configura sua visualização de localizador.

Endereços, Códigos Postais e Lugares Ocupados

Quando você escolhe Endereços, Códigos Postais e Lugares Ocupados como os tipos de locais que você deseja encontrar, é possível refinar ainda mais os resultados da pesquisa na visualização do localizador, selecionando as categorias e subcategorias que deseja pesquisar. As seguintes categorias para Endereços, Códigos Postais e Lugares Ocupados estão disponíveis:

  • Endereço—A seleção desta categoria inclui automaticamente todas as subcategorias de endereços listadas na tabela abaixo. Esta categoria limita os resultados da pesquisa aos lugares que podem ser categorizados como endereços, enquanto filtra resultados para locais de interesse, códigos postais, países ou estados. Para resultados de pesquisa mais precisos, escolha qualquer combinação das subcategorias de endereço que atenda os requisitos da pesquisa.
  • Postal—A seleção desta categoria limita os resultados da pesquisa a qualquer tipo de correspondente do código postal, incluindo formatos de código postal de 5 dígitos e mais. Para limitar os resultados da pesquisa ao correspondentes que são pelo menos tão precisos, selecione ambas a categoria Postal e a categoria de nível superior Endereço .
  • Lugares Ocupados—A seleção desta categoria inclui automaticamente todas as subcategorias de lugares ocupados listadas na tabela abaixo. Esta categoria limita os resultados da pesquisa à divisões administrativas (ou limites), como cidades, províncias ou países, ao mesmo tempo que filtra resultados para endereços, locais de interesse e códigos postais. Para resultados de pesquisa mais precisos, escolha qualquer combinação das subcategorias de lugar ocupado que atenda os requisitos da pesquisa.

CategoriaSubcategoriaDescrição

Endereço

Endereço de Ponto

Um endereço de ponto é um endereço de rua com base em pontos que representam locais de edifícios e casas. Os endereços de ponto representam a localização do endereço no telhado, ou real. Normalmente, este é o nível de correspondência espacialmente mais exato. Os dados de referência contêm pontos de endereço com números de casas e nomes de ruas associados, juntamente com divisões administrativas e informações de código postal opcionais—por exemplo, 380 New York St, Redlands, CA, 92373.

Uma visualização de localizador configurada com esta subcategoria limita os resultados a estes pontos de endereço altamente precisos, o que permitirá a você evitar a correspondência com pontos de endereço menos precisos, caso necessário uma precisão muito alta na correspondência.

Endereço da Rua

Um endereço de rua é diferente de um endereço de ponto no qual o número da casa em um endereço de rua é interpolado a partir de uma variedade de números. Os dados de referência contêm linhas centrais da rua com intervalos de números da casa, juntamente com divisões administrativas e informações de código postal opcionais—por exemplo, 647 Haight St, San Francisco, CA, 94117.

Uma visualização de localizador configurada com esta subcategoria limita os resultados a um resultado interpolado. Se você deseja limitar os resultados para corresponder aqueles que são pelo menos tão precisos, você deverá selecionar esta subcategoria e a categoria Endereço de Ponto .

Interseccionar

Uma intersecção é um endereço de rua que consiste em uma intersecção de rua, juntamente com informações de código postal e estado opcionais, e cidade —por exemplo, Redlands Blvd & New York St, Redlands, CA, 92373.

Uma visualização de localizador configurada com esta subcategoria limita os resultados às interseções em vez dos endereços completos que existem em uma única rua.

Nome da Rua

Um nome de rua é semelhante a um endereço de rua, mas sem o número da casa. Contém linhas de centro da rua com nomes de ruas associados (sem intervalos de endereço numerados), juntamente com divisões administrativas e informações de código postal opcionais—por exemplo, W Olive Ave, Redlands, CA, 92373.

Uma visualização de localizador configurada com esta subcategoria limita os resultados somente aos nomes de ruas. Se você deseja limitar os resultados para corresponder aqueles que são pelo menos tão precisos, você deverá selecionar esta subcategoria, como também, as subcategorias Endereço de Ponto e Endereço de Rua .

Subendereço:

Um subendereço é um subconjunto de um endereço de ponto que representa um local do subconjunto de casas ou edifícios, como uma unidade de apartamento, andar ou edifício individual dentro de um complexo de edifícios—por exemplo, 3836 Emerald Ave, Suite C, La Verne, CA, 91750.

Uma visualização de localizador configurada com esta subcategoria limita os resultados para pontos de subendereço que incluem um número da casa, nome da rua e elementos de subendereço, juntamente com divisões administrativas e informações de código postal opcionais, enquanto deixa de fora outros tipos de correspondências de endereço.

Código Postal

Sem subcategorias

Uma visualização de localizador configurada com a categoria Postal retorna qualquer tipo de correspondência de código postal, incluindo 5 dígitos (por exemplo, 92373) e outros formatos de código postal. Para limitar os resultados aos correspondentes que são pelo menos tão precisos, selecione Postal e a categoria de superior Endereço .

Lugar Ocupado

Vizinhança

Um bairro é uma subseção de uma cidade, menor que um distrito e maior que um setor.

Cidade

Um localizador configurado com esta subcategoria limita os resultados somente para cidades—por exemplo, a cidade de Veneza na Itália.

Subregião

Uma subregião é um subconjunto de um estado ou província, como município nos Estados Unidos—por exemplo Adams County no estado de Wisconsin.

Região

Uma região é uma subseção de um país, tipicamente um estado ou província—por exemplo, a província de Ontário no Canada.

País

Um país é a divisão administrativa mais alta, também conhecida como uma nação—por exemplo, Japão.

Setor

Um setor é uma divisão administrativa maior que um bloco e menor que um bairro, representando uma subdivisão de um bairro ou distrito, ou uma coleção de blocos.

Bloco

Um bloco é a menor área administrativa para um país, representando uma subdivisão de um setor ou bairro, ou um bloco de cidade nomeado.

Distrito

Um distrito é uma divisão administrativa menor que uma cidade e maior que um bairro—por exemplo, um distrito municipal.

Área Metro

Uma área metropolitana (metro) é uma conglomeração urbana consistindo de uma grande cidade e cercada por cidades menores—por exemplo, Greater Tokyo.

Território

Um território é uma grande divisão administrativa, menor que um país e maior que um estado ou província—por exemplo, o território de Yukon no Canadá.

Zona

A zona é uma categoria que representa uma área administrativa não oficial que não pertence a um país, como uma área em disputa ou um agrupamento de outras zonas administrativas—por exemplo, América Central.

Coordenadas

Quando você escolhe Coordenadas como os tipos de locais que você deseja encontrar, é possível refinar ainda mais os resultados da pesquisa na visualização do localizador, selecionando as categorias que deseja pesquisar. Estas são descritas na tabela baixo.

CategoriaDescrição

Longitude, Latitude

Esta categoria representa coordenadas geográficas (x, y). X refere-se à longitude (coordenadas leste-oeste), e y refere-se à latitude (coordenadas norte-sul). As coordenadas são inseridas e retornadas como x, y.

Latitude, Longitude

Esta categoria representa coordenadas geográficas (x, y). X refere-se à longitude (coordenadas leste-oeste) e y refere-se à latitude (coordenadas norte-sul). As coordenadas são inseridas e retornadas como x, y.

MGRS

Esta categoria representa coordenadas do Sistema de Referência da Grade Military (MGRS)

USNG

Esta categoria representa o sistema de coordenadas da Grade Nacional dos Estados Unidos (USNG).

Locais de Interesse

Quando você escolhe Locais de Interesse como os tipos de locais que você deseja encontrar, é possível refinar ainda mais os resultados da pesquisa na visualização do localizador, selecionando as categorias que deseja pesquisar. Estas são descritas na tabela baixo.

CategoriaDescrição

Educação

Esta categoria representa todos os tipos de instituições educacionais, incluindo universidades, escolas primárias e escolas vocacionais.

Comidas

Esta categoria representa restaurantes de todos os tipos.

Compras e Serviços

Esta categoria representa todos os tipos de negócios comerciais ou de varejo.

Aeroporto

Esta categoria representa aeroportos, designados por nome ou por código de aeroporto.

Requisitos para configurar seus próprios localizadores

ArcGIS Online suporta localizadores executando no ArcGIS Server 10.0 e posterior como localizadores para pesquisa geográfica. Quando utilizados para pesquisa geográfica, os localizadores podem ser internos ou externos. Os localizadores internos funcionam somente para pesquisa geográfica quando Map Viewer Classic ou outros clientes do ArcGIS Online têm acesso a estes localizadores internos. Por exemplo, se a sua organização compartilhar aplicativos com o público, somente os usuários que têm acesso aos seus localizadores internos poderão encontrar lugares com estes aplicativos.

O ArcGIS Online também suporta localizadores que executam no ArcGIS Server 10.1 e posterior como geocodificadores para geocodificação em lote. Diferentemente da pesquisa geográfica, os localizadores externos que são hospedados fora do seu firewall são exigidos para geocodificação em lote. Isto é devido ao ArcGIS Online precisar de acesso à operação geocodeAddresses no seu localizador para executar a geocodificação em lote. Se o seu localizador externo for seguro, você deverá primeiro criar um item de serviço seguro no ArcGIS Online que armazena as credenciais exigidas para acessar seu localizador. Você pode então configurar a URL de serviço fornecida pelo item de serviço seguro como um localizador.

Ao configurar seu próprio localizador para geocodificação em lote, você deve provisionar recursos de computação suficientes para o seu localizador. ArcGIS Online envia muitas solicitações simultâneas ao executar a geocodificação em lote para melhorar o desempenho; portanto, seus próprios localizadores devem ter recursos de computação suficientes para lidar com solicitações simultâneas sem afetar severamente o tempo de processamento das solicitações.

O ArcGIS Online suporta localizadores de campo único do ArcGIS Server 10.0 e posterior. Os localizadores do ArcGIS Server 10.0 e localizadores internos podem ser utilizados para pesquisa geográfica, mas não para geocodificação em lote. Os localizadores externos do ArcGIS Server 10.1 ou posterior são exigidos para executar geocodificação em lote. Os localizadores internos funcionam somente para pesquisa geográfica quando Map Viewer, Map Viewer Classic, ou outros clientes do ArcGIS Online têm acesso a estes localizadores internos. Por exemplo, se a sua organização compartilhar aplicativos com o público, somente os usuários que têm acesso aos seus localizadores internos poderão encontrar lugares com estes aplicativos. ArcGIS Online itens de serviço seguros não são suportados atualmente no ArcGIS Desktop. Para geocodificação em lote, seu localizador precisa ser hospedado fora do seu firewall, assim o ArcGIS Online poderá acessar a operação geocodeAddresses no seu localizador para executar a geocodificação em lote.

Enriquecer camada com informações de endereço

Ao publicar uma camada de feição hospedada a partir de um arquivo (CSV) de valores separados por vírgula, você tem a opção de incluir informações de um processo de geocodificação como parte do sua camada de feição hospedada. Estas informações são geradas pelo localizador e armazenadas em campos na camada de feição hospedada.

Por padrão, somente as informações de localização (as coordenadas x, y) são incluídas na camada de feição hospedada. Há duas opções para incluir informações adicionais na camada de feição hospedada:

  • Anexar quatro campos que mostram o quão bem os endereços são correspondidos—Inclui os campos e valores status, score, match_addr e addr_type. Esses campos e valores são descritos na tabela a seguir.
  • Anexe 50 campos para informações de localização completas—Inclui todos os campos listados na tabela a seguir.

Esteja ciente que estes campos e valores adicionais aumentarão o tamanho da camada de feição hospedada. O quanto o tamanho da camada aumenta depende do número de registros em seu arquivo de entrada e da opção escolhida.

CampoDescrição

spatialReference

A referência espacial da saída corresponde a coordenadas do local, conforme especificado pelas propriedades wkid e latestWkid. O parâmetro de entrada outSR determina a referência espacial. Isso sempre é retornado por padrão.

address

Endereço correspondente completo retornado para solicitações de geocódigos findAddressCandidates e geocodeAddresses. Isso sempre é retornado por padrão.

location

As coordenadas do ponto da saída correspondem ao local, conforme especificado pelas propriedades x e y. A referência espacial das coordenadas x e y é definida pelo campo de saída spatialReference . Sempre retornado por padrão apenas para solicitações e geocódigos findAddressCandidates e geocodeAddresses. Consulte a descrição do parâmetro locationType para obter mais informações sobre como o campo de saída do local se relaciona com os atributos de saída X e Y.

ResultID

Retornado apenas para solicitações geocodeAddresses. Cada registro em uma resposta de geocódigo em lote inclui um valor ResultID, que é igual ao valor OBJECTID do registro de endereço de entrada correspondente. Pode ser usado para unir os campos de saída na resposta aos atributos na tabela de endereços original.

Loc_name

O nome do localizador usado para retornar um resultado correspondente específico.

Anotação:

O campo Loc_name é usado internamente pelo software ArcGIS e não se destina ao uso por aplicativos clientes.

Status

Indica se uma solicitação de geocódigo em lote resulta em um correspondente, valor próximo ou não correspondente.

Os valores possíveis incluem o seguinte:

  • M—Correspondente. O endereço retornado corresponde à solicitação e é o candidato com maior pontuação.
  • T—Valor próximo. O endereço retornado corresponde à solicitação, mas tem a mesma pontuação que um ou mais candidatos adicionais.
  • U—Não correspondente. Nenhum endereço corresponde à solicitação.

Score

Um número de 1 a 100, indicando o grau em que os tokens de entrada em uma solicitação de geocodificação correspondem aos componentes de endereço em um registro candidato. Uma pontuação de 100 representa uma combinação perfeita, enquanto as pontuações mais baixas representam uma precisão correspondente decrescente. Score é sempre retornado por padrão.

Match_addr

Endereço completo retornado de a solicitação de geocódigo. O formato é baseado nos padrões de endereço do país em que o endereço está localizado.

LongLabel

Uma versão mais longa de Match_addr contendo mais informações administrativas.

ShortLabel

Uma versão abreviada de Match_addr.

Addr_type

O nível correspondente de uma solicitação de geocódigo. Os níveis de correspondência suportados variam em diferentes países.

Os valores possíveis incluem o seguinte:

  • Subaddress—Um subconjunto de um PointAddress que representa uma localização de subendereço de casa ou edifício, como uma unidade de apartamento, andar ou prédio individual dentro de um complexo. Os valores de campo UnitName,UnitType, LevelName, LevelType, BldgName, e BldgType ajudam a distinguir subendereços que podem ser associados com o mesmo PointAddress. Os dados de referência consistem em feições de ponto com elementos de número da casa, nome da rua e subendereço associados, além de divisões administrativas e código postal opcional; por exemplo, 3836 Emerald Ave, Suite C, La Verne, CA, 91750.
  • PointAddress—Um endereço de rua com base em pontos que representam locais de casas e prédios. Normalmente, este é o nível de correspondência espacialmente mais exato. Os dados de referência contêm pontos de endereço com números de casas e nomes de ruas associados, além de divisões administrativas e código postal opcional. Os valores de saída X / Y e geometry para um PointAddress correspondente, representam o local de entrada da rua do endereço; esse é o local usado para operações de rotas. Os valores DisplayX e DisplayY representam o telhado ou local real do endereço. Exemplo: 380 New York St, Redlands, CA, 92373.
  • StreetAddress—Um endereço de rua que difere de PointAddress pois o número da casa é interpolado de um intervalo de números. Os dados de referência contêm linhas do centro da rua com intervalo de números de casas, além de divisões administrativas e informações opcionais de códigos postais, por exemplo, 647 Haight St, San Francisco, CA, 94117.
  • StreetInt—Um endereço de rua que consiste em um cruzamento de ruas, juntamente com a cidade e informações opcionais sobre estado e código. Isso é derivado dos dados de referência StreetAddress, por exemplo, Redlands Blvd & New York St, Redlands, CA, 92373.
  • StreetAddressExt—Um correspondente de endereço interpolado que é retornada quando o parâmetro matchOutOfRange=true e o número da casa de entrada excedem o intervalo de números da casa para o segmento de rua correspondente.
  • DistanceMarker—Um endereço de rua que representa a distância linear ao longo de uma rua, geralmente em quilômetros ou milhas, de um local de origem designado. Exemplo: Carr 682 KM 4, Barceloneta, 00617.
  • StreetMidBlock—O ponto médio estimado de um intervalo de números de casas ao longo de um segmento de rua que corresponde a um quarteirão. A localização retornada para um StreetMidBlock correspondente é mais precisa do que um StreetName correspondente, mas menos precisa do que um StreetAddress correspondente. Atualmente funcional apenas para os EUA. Exemplo: 100 Block of Grant Ave, Millville, New Jersey.
  • StreetName—Semelhante a um endereço, mas sem o número da casa. Os dados de referência contêm linhas centrais de ruas com nomes de ruas associados (sem intervalos de endereços numerados), além de divisões administrativas e código postal opcional, por exemplo W Olive Ave, Redlands, CA, 92373.
  • Locality—Um nome de local representando um local preenchido. O campo de saída Type fornece informações mais detalhadas sobre o tipo de local preenchido. Valores Type possíveis para o correspondente Locality incluem Block, Sector, Neighborhood,District, City, MetroArea, County, State or Province,Territory, Country, e Zone. Exemplo: Bogotá, COL
  • PostalLoc—Uma combinação de código postal e nome da cidade. Os dados de referência são normalmente uma união de limites postais e administrativos (localidade), por exemplo 7132 Frauenkirchen.
  • PostalExt—Um código postal com uma extensão adicional, como o Serviço Postal dos Estados Unidos ZIP+4. Os dados de referência são pontos de código postal com extensões, por exemplo, 90210-3841.
  • Postal—Código postal. Os dados de referência são pontos de código postal, por exemplo, 90210 USA.
  • POI—Pontos de interesse. Os dados de referência consistem em empresas, pontos de referência e feições geográficas, por exemplo, Starbucks.
  • LatLong—Um par de coordenadas x/y. O LatLongaddr_type é retornado quando um par de coordenadas x/y, como 117.155579,32.703761, for a entrada da pesquisa.
  • XYXY é o correspondente baseado na suposição de que a primeira coordenada da entrada é longitude e a segunda é latitude.
  • YXYX é retornado como Addr_type para o candidato que assume que latitude é o primeiro número na entrada, seguido por longitude.
  • MGRS—Um local do Sistema de Referência de Grade Militar (MGRS), como 46VFM5319397841.
  • USNG—Um local da Grade Nacional dos Estados Unidos (USNG), como 15TXN29753883. Este valor Addr_type é retornado somente quando o parâmetro category é definido para USNG em uma solicitação findAddressCandidates ou geocodeAddresses.

Type

O tipo de feição dos resultados retornados por uma pesquisa. O campo Type inclui somente um valor para candidatos com Addr_type = POI ou Locality. Como um exemplo, para Starbucks, Type=Coffee Shop.

PlaceName

O nome formal de um candidato correspondente de geocódigo, por exemplo, Paris ou Starbucks.

Place_addr

O endereço completo de um local, incluindo rua, cidade e região; por exemplo, 275 Columbus Ave, New York, New York.

Phone

O número de telefone principal de um local. Para outras pesquisas, como endereço, intersecção e código postal, o campo está vazio, por exemplo, Knott's Berry Farm, Phone=(714)220-5200.

URL

O URL do site da web primário de um lugar. Para outras pesquisas, como endereço, intersecção e código postal, o campo está vazio, por exemplo, na Universidade da Geórgia, URL =http://www.uga.edu/.

Rank

Um valor de número de ponto flutuante indicando a importância de um resultado em relação a outros resultados com o mesmo nome. Por exemplo, existem cidades na França e no Texas chamadas Paris. Paris, França, tem uma população maior do que Paris, Texas, por isso tem uma classificação mais elevada.Rank é usado para classificar resultados para consultas ambíguas, como Lincoln, onde nenhuma informação adicional (estado) está disponível. Os valores Rank são baseados na população ou no tipo de feição.

AddBldg

O nome de um edifício, por exemplo, Empire State Building.

AddNum

O valor alfanumérico que representa a parte de um endereço normalmente conhecido como número da casa ou número da construção, por exemplo, no endereço 380 New York Street, AddNum = 380.

Este valor é retornado para PointAddress e StreetAddress correspondentes somente.

AddNumFrom

Um valor que representa o número inicial de um intervalo de endereços. É relativo à direção da digitalização d e feição e nem sempre é o menor número no intervalo. Este valor é fornecido para resultados de StreetAddress.

AddNumTo

Um valor que representa o número final de um intervalo de endereços. É relativo à direção da digitalização da feição e nem sempre é o maior número no intervalo. Este valor é fornecido para resultados de StreetAddress.

AddRange

O intervalo completo do número da casa do segmento de rua onde se encontra um endereço, no formato AddNumFrom-AddNumTo. Por exemplo, o valor AddRange do endereço de rua 123 Main St pode ser 101-199.

Side

O lado da rua onde reside um endereço em relação à direção da digitalização da feição. Este valor não é relativo à direção da viagem ao longo da rua. Os possíveis valores são R (direita) e L (esquerda).

StPreDir

Elemento de endereço que define a direção de uma rua e ocorre antes do nome da rua principal, por exemplo, North em North Main Street.

StPreType

Um elemento de endereço que define o tipo principal de uma rua, por exemplo, o termo em Espanhol Avenida em Avenida Central ou o termo em Francês Rue em Rue Lapin.

StName

Um elemento de endereço que define o nome principal de uma rua, por exemplo, Main em North Main Street.

StType

Um elemento de endereço que define o tipo à direita de uma rua, por exemplo, "Street" em Main Street.

StDir

Um elemento de endereço que define a direção de uma rua, que ocorre após o nome da rua principal, por exemplo, North em Main Street North.

BldgName

O nome ou o número de uma subunidade de construção. Por exemplo, A em building A.

BldgType

A classificação de uma subunidade de construção. Exemplos são construção, hangar, torre.

LevelType

A classificação de uma subunidade de andar. Exemplos são piso, nível, departamento, ala.

LevelName

O nome ou o número de uma subunidade de andar. Por exemplo, 3 em level 3.

UnitType

A classificação de uma subunidade de unidade. Exemplos são unidade, apartamento, apartamento, escritório, suíte.

UnitName

O nome ou número de uma subunidade de unidade. Por exemplo, 2B em apartment 2B.

SubAddr

O valor completo da subunidade de um candidato com Addr_type=Subaddress que inclui <subunit type> + <subunit name>. Por exemplo, se o candidato de subendereço for uma unidade de apartamento, SubAddr = UnitType + UnitName. Exemplo: Apt 4B

StAddr

O endereço de um lugar, sem cidade e região; por exemplo, 275 Columbus Ave.

Block

O nome da divisão administrativa em nível de bloco de um candidato. Block é a menor área administrativa de um país. Pode ser descrito como uma subdivisão de setor ou bairro, ou um quarteirão de cidade nomeado. Não é comumente usado.

Sector

O nome da divisão administrativa em nível de setor de um candidato. Sector é uma subdivisão de bairro ou distrito ou representa uma coleção de quarteirões. Não é comumente usado.

Nbrhd

O nome da divisão administrativa em nível de bairro de um candidato. Nbhrhd é uma subseção de uma cidade ou distrito.

District

O nome da divisão administrativa em nível de distrito de um candidato. Subdivisão da cidade.

City

O nome da divisão administrativa no nível da cidade de um candidato. City é uma subdivisão de uma subregião ou região.

MetroArea

O nome da divisão administrativa no nível da área metropolitana de um candidato. Uma área urbana que consiste em uma cidade grande e nas cidades menores que a cercam. Pode interceptar potencialmente várias sub-regiões ou regiões. Um exemplo é Kolkata Metropolitan Area na Índia.

Subregion

O nome da divisão administrativa em nível de sub-região de um candidato. Subregion é uma subdivisão de uma região.

Region

O nome da divisão administrativa em nível de região de um candidato. Subdivisão de um país ou território. Normalmente, a maior área administrativa de um país, se a divisão administrativa Territory não for usada.

RegionAbbr

Nome da região abreviado. O valor RegionAbbr para Califórnia é CA.

Territory

O nome da divisão administrativa em nível de território de m candidato. Subdivisão de país. Não é comumente usado. O Sudeste macroregion do Brasil, que abrange os estados do Espírito Santo, Minas Gerais, Rio de Janeiro e São Paulo, é um exemplo.

Postal

Um elemento de endereço alfanumérico que define o código postal principal, por exemplo, V7M 2B4 para um código postal do Canadá e 92374 para um código postal dos EUA.

PostalExt

Um elemento de endereço alfanumérico que define a extensão do código postal, por exemplo, 8100 no código postal dos EUA 92373-8110.

Country

Um código de três caracteres para um país; por exemplo, Canadá = CAN. Uma lista de países e códigos suportados está disponível na Cobertura de dados. Este campo é retornado por findAddressCandidates e geocodeAddresses.

CountryCode

Um código de três caracteres para um país; por exemplo, Canadá = CAN. Uma lista de países e códigos suportados está disponível na Cobertura de dados. Este campo é igual ao campo de saída Country; a diferença é que ele só é retornado por reverseGeocode.

CntryName

O nome completo do país para um candidato a endereço; por exemplo, "日本" (Japão). O nome pode estar no mesmo idioma do endereço de entrada ou no idioma especificado pelo parâmetro langCode para a solicitação. Se o nome completo do país não estiver disponível no idioma especificado, será usado o idioma principal do país em que o candidato a endereço está. As informações sobre os idiomas suportados por país estão disponíveis em Cobertura de dados. Este campo é retornado por findAddressCandidates, geocodeAddresses e reverseGeocode.

LangCode

Um código de idioma com três caracteres que representa o idioma do endereço; por exemplo, ENG = English.

Distance

A distância física em metros de um candidato para um local especificado. O valor de saída Distance é calculado para cada candidato quando o parâmetro de entrada Location é passado em uma solicitação usando a operação findAddressCandidates . Se o parâmetro Location não for passado em uma solicitação, o valor de Distance será zero.

X

A coordenada x primária de um endereço retornado pelo ArcGIS World Geocoding Service na referência espacial WGS84 (WKID 4326).

Y

A coordenada y primária de um endereço retornado pelo ArcGIS World Geocoding Service na referência espacial WGS84 (WKID 4326).

DisplayX

A coordenada x exibe de um endereço retornado pelo ArcGIS World Geocoding Service na referência espacial WGS84 (WKID 4326). Para a maioria dos tipos de correspondentes, os valores X e DisplayX são os mesmos. Para correspondentes de Addr_typePointAddress e Subaddress especificamente, os valores podem ser diferentes. Em geral, para PointAddress e Subaddress correspondentes, DisplayX representa o valor da coordenada x do telhado do edifício ou do centróide da parcela do endereço, enquanto o valor X representa a coordenada x da localização do lado da rua do endereço. Há exceções no entanto. Algumas fontes de dados de endereço usadas pelo ArcGIS World Geocoding Service somente fornecem a localização do telhado de feições do PointAddress e Subaddress ; por outro lado, para algumas feições de PointAddress e Subaddress apenas a localização do lado da rua está disponível. Para tais casos, os valores X e DisplayX são equivalentes.

DisplayY

A coordenada y exibe de um endereço retornado pelo ArcGIS World Geocoding Service na referência espacial WGS84 (WKID 4326). Para a maioria dos tipos de correspondentes, os valores Y e DisplayY são os mesmos. Para correspondentes de Addr_typePointAddress e Subaddress especificamente, os valores podem ser diferentes. Em geral, para PointAddress e Subaddress correspondentes, DisplayY representa o valor da coordenada y do telhado do edifício ou do centróide da parcela do endereço, enquanto o valor Y representa a coordenada y da localização do lado da rua do endereço. Há exceções no entanto. Algumas fontes de dados de endereço usadas pelo ArcGIS World Geocoding Service somente fornecem a localização do telhado de feições do PointAddress e Subaddress ; por outro lado, para algumas feições de PointAddress e Subaddress apenas a localização do lado da rua está disponível. Para tais casos, os valores Y e DisplayY são equivalentes.

Xmin

A coordenada x mínima da extensão de exibição de uma feição retornada pelo ArcGIS World Geocoding Service. Os valores Xmin, Xmax, Ymin, e Ymax podem ser combinados para definir a extensão do mapa para exibir um resultado de geocódigo. As coordenadas de extensão usam a referência espacial WGS84.

Xmax

A coordenada x mínima da extensão de exibição de uma feição retornada pelo ArcGIS World Geocoding Service. Os valores Xmin, Xmax, Ymin, e Ymax podem ser combinados para definir a extensão do mapa para exibir um resultado de geocódigo. As coordenadas de extensão usam a referência espacial WGS84.

Ymin

A coordenada y mínima da extensão de exibição de uma feição retornada pelo ArcGIS World Geocoding Service. Os valores Xmin, Xmax, Ymin, e Ymax podem ser combinados para definir a extensão do mapa para exibir um resultado de geocódigo. As coordenadas de extensão usam a referência espacial WGS84.

Ymax

A coordenada y mínima da extensão de exibição de uma feição retornada pelo ArcGIS World Geocoding Service. Os valores Xmin, Xmax, Ymin, e Ymax podem ser combinados para definir a extensão do mapa para exibir um resultado de geocódigo. As coordenadas de extensão usam a referência espacial WGS84.

ExInfo

Uma coleção de strings da entrada que não podem ser correspondidas a nenhuma parte de um endereço e foram usadas para pontuar ou penalizar o resultado.

extent

O retângulo delimitador mínimo da feição de correspondente de saída, conforme especificado pelas propriedades xmin, ymin, xmax e ymax. A referência espacial das coordenadas x e y é definida pelo campo de saída spatialReference . Isto é sempre retornado por padrão apenas para solicitações de geocódigos do findAddressCandidates .