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 inclui pesquisa geográfica e 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:

    Algumas propriedades de visualização do localizador não são suportadas para geocodificação reversa.

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 da pesquisa para um país ou área em particular, ou somente para retornar resultados que correspondem a 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 organização petrolífera pode adicionar localizadores para pesquisar 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.

Tipos de locais e categorias

Esta seção descreve os tipos de locais, categorias e subcategorias disponíveis quando você configura a 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, que permite a você evitar a correspondência a pontos de endereço menos precisos, caso necessário uma precisão 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 a 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 cinco 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 um 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 de valores separados por vírgula, você tem a opção de incluir informações de um processo de geocodificação como parte da 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 no arquivo de entrada e da opção escolhida. A tabela a seguir descreve os campos que você pode anexar a uma camada de feição hospedada publicada de um arquivo .csv:

CampoDescriçãoTipos de solicitação compatíveis

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.

findAddressCandidates

geocodeAddresses

reverseGeocode

address

O endereço correspondente completo retornado para solicitações de geocódigo findAddressCandidates e geocodeAddresses.

Exemplo: 380 New York St, Redlands, Califórnia, 92373

findAddressCandidates

geocodeAddresses

address (reverseGeocode only)

O endereço completo de um local, incluindo o número da casa e o nome da rua.

Exemplo: 380 New York St.

Anotação:
Isso é diferente do campo address que é retornado nas respostas findAddressCandidates e nas solicitações geocodeAddresses. Somente é devolvido para reverseGeocode. É análogo ao campo de saída StAddr para findAddressCandidates e geocodeAddresses.

reverseGeocode

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 . 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.

findAddressCandidates

geocodeAddresses

reverseGeocode

ResultID

Isto é 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.

geocodeAddresses

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.

findAddressCandidates

geocodeAddresses

Status

Indica se uma solicitação de geocódigo resulta em uma correspondência, um empate ou não há correspondência.

Os valores possíveis são os seguintes:

  • M—Correspondido. O endereço retornado corresponde à solicitação e é o candidato com maior pontuação.
  • T—Amarrado. 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.

findAddressCandidates

geocodeAddresses

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.

findAddressCandidates

geocodeAddresses

Match_addr

O endereço completo retornado para 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.

findAddressCandidates

geocodeAddresses

reverseGeocode

LongLabel

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

findAddressCandidates

geocodeAddresses

reverseGeocode

ShortLabel

Uma versão abreviada do valor Match_addr.

findAddressCandidates

geocodeAddresses

reverseGeocode

Addr_type

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

Os valores possíveis são os seguintes:

  • Subaddress—Um subconjunto de um valor 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 valore de campo UnitName,UnitType, LevelName, LevelType, BldgName e BldgType ajudam a distinguir subendereços que podem estar associados ao mesmo valor PointAddress. Os dados de referência consistem em feições de ponto com um número de casa associado, nome de rua e elementos de subendereço, juntamente com divisões administrativas e código postal opcional. 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 do valor PointAddress, pois o número da casa é interpolado de um intervalo de números. Os dados de referência contêm linhas centrais de ruas com intervalos de números de casas, juntamente com divisões administrativas e informações opcionais de código postal. Exemplo: 647 Haight St, São 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. Exemplo: Redlands Blvd e New York St, Redlands, CA, 92373.
  • StreetAddressExt—Um correspondente de endereço interpolado que é retornada quando 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 StreetNamecorrespondente, mas menos precisa do que um StreetAddress correspondente. Este valor é atualmente funcional apenas para os Estados Unidos. Exemplo: 100 Block of Grant Ave, Millville, Nova 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), juntamente com divisões administrativas e código postal opcional. 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 combinação de limites postais e limites administrativos (localidades). 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. Exemplo: 90210-3841.
  • Postal—Um código postal. Os dados de referência são pontos de código postal. Exemplo: 90210 EUA.
  • POI—Pontos de interesse. Os dados de referência consistem em empresas, pontos de referência e feições geográficas. Exemplo: Starbucks.
  • LatLong—Um par de coordenadas x/y. O LatLongaddr_type será retornado quando um par de coordenadas x/y, como 117.155579,32.703761 for a entrada da pesquisa.
  • XY— é o correspondente baseado na suposição de que a primeira coordenada da entrada é longitude e a segunda é latitude.
  • YX— Este é 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.

findAddressCandidates

geocodeAddresses

reverseGeocode

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. Por exemplo, para Starbucks, Type=Coffee Shop.

findAddressCandidates

geocodeAddresses

reverseGeocode

PlaceName

O nome formal de um candidato à correspondência de geocódigo. Exemplo: Paris ou Starbucks.

findAddressCandidates

geocodeAddresses

reverseGeocode

Place_addr

O endereço completo de um lugar, incluindo rua, cidade e região. Exemplo: 275 Columbus Ave, Nova York, Nova York.

findAddressCandidates

geocodeAddresses

Phone

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

findAddressCandidates

geocodeAddresses

URL

A URL do site principal de um local de interesse (POI). Exemplo: a Universidade da Geórgia, URL =http://www.uga.edu/. Para outras pesquisas, como endereço, intersecção e código postal, o campo está vazio.

findAddressCandidates

geocodeAddresses

Rank

Um valor numérico de ponto flutuante que indica a prioridade 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 que Paris, Texas, por isso tem uma classificação mais alta. O campo 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.

findAddressCandidates

geocodeAddresses

AddBldg

O nome de um edifício. Exemplo: Edifício Empire State.

findAddressCandidates

geocodeAddresses

AddNum

O valor alfanumérico que representa a parte de um endereço normalmente conhecida como número de casa ou número de edifício. Exemplo: no endereço 380 New York Street, AddNum = 380.

Este valor é retornado para PointAddress e StreetAddress correspondentes somente.

findAddressCandidates

geocodeAddresses

reverseGeocode

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.

findAddressCandidates

geocodeAddresses

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.

findAddressCandidates

geocodeAddresses

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 123 Main St, pode ser 101-199.

findAddressCandidates

geocodeAddresses

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).

Anotação:

Side é um campo antigo que é mantido apenas para oferecer suporte a aplicativos que esperam que ele esteja presente na resposta de REST. O campo está vazio para a maioria dos endereços retornados pelo serviço de geocodificação. Não deve ser usado para propósitos de análise.

findAddressCandidates

geocodeAddresses

StPreDir

Um elemento de endereço que define a direção de uma rua e ocorre antes do nome da rua principal. Exemplo: Norte na North Main Street.

findAddressCandidates

geocodeAddresses

StPreType

Um elemento de endereço que define o tipo principal de uma rua. Exemplo: o termo Espanhol Avenida na Avenida Central ou o termo francês Rue na Rue Lapin.

findAddressCandidates

geocodeAddresses

StName

Um elemento de endereço que define o nome principal de uma rua. Exemplo: Principal na Rua Principal Norte.

findAddressCandidates

geocodeAddresses

StType

Um elemento de endereço que define o tipo final de uma rua. Exemplo: Rua na Rua Principal.

findAddressCandidates

geocodeAddresses

StDir

Um elemento de endereço que define a direção de uma rua, que ocorre após o nome da rua principal. Exemplo: Norte na Rua Principal Norte.

findAddressCandidates

geocodeAddresses

BldgName

O nome ou o número de uma subunidade de construção. Exemplo: A no edifício A.

findAddressCandidates

geocodeAddresses

BldgType

A classificação de uma subunidade do edifício. Exemplos são edifícios, hangar e torre.

findAddressCandidates

geocodeAddresses

LevelType

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

findAddressCandidates

geocodeAddresses

LevelName

O nome ou o número de uma subunidade de andar. Exemplo: 3 no nível 3.

findAddressCandidates

geocodeAddresses

UnitType

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

findAddressCandidates

geocodeAddresses

UnitName

O nome ou número de uma subunidade de unidade. Exemplo: 2B no apartamento 2B.

findAddressCandidates

geocodeAddresses

SubAddr

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

findAddressCandidates

geocodeAddresses

StAddr

O endereço de um local, sem cidade e região. Exemplo: Avenida Columbus, 275.

findAddressCandidates

geocodeAddresses

Block

O nome da divisão administrativa em nível de bloco de um candidato. O valor 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.

findAddressCandidates

geocodeAddresses

reverseGeocode

Sector

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

findAddressCandidates

geocodeAddresses

reverseGeocode

Nbrhd

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

findAddressCandidates

geocodeAddresses

Neighborhood

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

Anotação:
Isso é análogo ao campo de saída Nbhrhd para solicitações de findAddressCandidates e geocodeAddresses.

reverseGeocode

District

O nome da divisão administrativa em nível de distrito de um candidato. Tal como uma subdivisão de uma cidade.

findAddressCandidates

geocodeAddresses

reverseGeocode

City

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

findAddressCandidates

geocodeAddresses

reverseGeocode

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. O valor pode interceptar potencialmente várias subregiões ou regiões. Um exemplo é a Área Metropolitana de Calcutá, na Índia.

findAddressCandidates

geocodeAddresses

reverseGeocode

Subregion

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

findAddressCandidates

geocodeAddresses

reverseGeocode

Region

O nome da divisão administrativa em nível de região de um candidato. É uma 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.

findAddressCandidates

geocodeAddresses

reverseGeocode

RegionAbbr

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

findAddressCandidates

geocodeAddresses

reverseGeocode

Territory

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

findAddressCandidates

geocodeAddresses

reverseGeocode

Postal

Um elemento de endereço alfanumérico que define o código postal principal. Exemplo: V7M 2B4 para um código postal canadense e 92374 para um código postal dos Estados Unidos.

findAddressCandidates

geocodeAddresses

reverseGeocode

PostalExt

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

findAddressCandidates

geocodeAddresses

reverseGeocode

Country

Um código de 3 caracteres para um país. Exemplo: Canadá é CAN. Uma lista de países e códigos suportados está disponível na Cobertura de dados de geocódigo. Este campo é retornado pelas operações findAddressCandidates e geocodeAddresses.

findAddressCandidates

geocodeAddresses

CountryCode

Um código de 3 caracteres para um país. Exemplo: Canadá é CAN. Uma lista de países e códigos suportados está disponível na Cobertura de dados de geocódigo.

Anotação:
Isso é análogo ao campo de saída Country para solicitações de findAddressCandidates e geocodeAddresses.

reverseGeocode

CntryName

O nome completo do país para um candidato a endereço. 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, o idioma principal do país onde está o candidato será usado. As informações sobre os idiomas suportados por país estão disponíveis em Cobertura de dados de geocódigo. Este campo é retornado pelas operações findAddressCandidates, geocodeAddresses e reverseGeocode.

findAddressCandidates

geocodeAddresses

reverseGeocode

LangCode

Um código de idioma de 3 caracteres que representa o idioma do endereço. Exemplo: ENG é inglês.

findAddressCandidates

geocodeAddresses

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.

findAddressCandidates

X

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

findAddressCandidates

geocodeAddresses

Y

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

findAddressCandidates

geocodeAddresses

DisplayX

A coordenada x exibe 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_type, PointAddress e Subaddress especificamente, os valores podem ser diferentes. Em geral, para PointAddress e Subaddress correspondentes, DisplayX representa o valor da coordenada x de telhado do edifício ou centróide de lote 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 das feições PointAddress e Subaddress. No entanto, para algumas feições PointAddress e Subaddress, apenas a localização do lado da rua está disponível. Para estes casos, os valores X e DisplayX são equivalentes.

findAddressCandidates

geocodeAddresses

DisplayY

A coordenada y exibe 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_type, PointAddress e Subaddress especificamente, os valores podem ser diferentes. Em geral, para PointAddress e Subaddress correspondentes, DisplayY representa o valor da coordenada y de telhado do edifício ou centróide de lote 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 das feições PointAddress e Subaddress. No entanto, para algumas feições PointAddress e Subaddress, apenas a localização do lado da rua está disponível. Para estes casos, os valores Y e DisplayY são equivalentes.

findAddressCandidates

geocodeAddresses

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.

findAddressCandidates

geocodeAddresses

Xmax

A coordenada x máxima 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.

findAddressCandidates

geocodeAddresses

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.

findAddressCandidates

geocodeAddresses

Ymax

A coordenada y máxima 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.

findAddressCandidates

geocodeAddresses

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.

findAddressCandidates

geocodeAddresses

extent

O retângulo delimitador mínimo da feição correspondente de saída conforme especificado pelos valores de campo 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 .

findAddressCandidates