Nueva Zelanda (NZL)
En esta sección se definen los conjuntos de datos de geocodificación, las operaciones y la información de los campos de entrada y salida que se admiten para Nueva Zelanda.
Conjuntos de datos de geocodificación admitidos
En la siguiente tabla se enumeran los conjuntos de datos de geocodificación admitidos con los niveles de geocodificación disponibles para Nueva Zelanda.
| Conjunto de datos de geocodificación | Centroide de ciudad | Centroide de barrio/pueblo | Centroide postal | Centroide de calle | Dirección de calle interpolada | Dirección de nivel de punto | Punto de interés |
|---|---|---|---|---|---|---|---|
| Critchlow English | Sí | Sí | Sí | Sí | Sí | Sí | Sí |
Operaciones admitidas
- Geocodificación: toma una o más direcciones como datos de entrada y devuelve coordenadas de latitud/longitud e información adicional.
- Geocodificación inversa: toma una o más coordenadas de latitud y longitud como datos de entrada y devuelve la dirección de la ubicación.
Campos de entrada
La dirección de entrada puede incluir algunos o todos los elementos de dirección que se indican a continuación.
| Nombre de campo | Tipo | Descripción |
|---|---|---|
| PlaceName | Cadena | Especifica el nombre del edificio, nombre del lugar, punto de interés (POI), nombre de empresa o firma relacionada con la dirección de entrada. Opcional. |
| MainAddressLine | Cadena | Entrada en una sola línea: si ningún otro campo de dirección está completado, entonces la entrada MainAddressLine se considerará como una entrada en una sola línea. La entrada en una sola línea puede consistir en varios campos de entrada de dirección, que se ingresan en el orden típico utilizado en el país para las direcciones. Para obtener información más detallada, consulte la sección "Entrada en una sola línea" a continuación. Dirección física: si los componentes de la dirección postal (ciudad, código postal, etc.) se proporcionan por separado o en el campo lastLine, entonces el contenido de MainAddressLinemainAddress se considerará como parte de la dirección física y puede incluir un nombre de empresa, un número de casa, nombres de edificios y nombres de calles. Opcional. Entrada de intersección de calles: para ingresar una intersección, especifique los nombres de las dos calles separados por el carácter "&&" (ampersand doble). |
| lastLine | Cadena | La última línea de la dirección. Opcional. Por ejemplo: 56 Namata Road |
| areaName1 | Cadena | Especifica la región. Una región en una división administrativa del país. Opcional. |
| areaName2 | Cadena | No se utiliza. |
| areaName3 | Cadena | Especifica la ciudad o pueblo. Opcional. |
| areaName4 | Cadena | Especifica el suburbio. Opcional. |
| postalCode | Cadena | El código postal de cuatro dígitos. El primer dígito representa la región geográfica. Los dígitos ubicados en segundo y tercer lugar representan el área de clasificación postal. El último dígito representa un área urbana, punto de entrega rural u oficina postal específica. Opcional. |
| country | Cadena | El código de país de tres letras ISO 3166-1 Alpha 3. Para Nueva Zelanda, el código de país es NZL. Obligatorio para la geocodificación directa. |
Pautas de direcciones para Nueva Zelanda
Siga estas recomendaciones para asegurarse de que los datos de entrada de dirección tengan el mejor formato posible para una óptima coincidencia y geocodificación. Para obtener información adicional acerca de las direcciones de Nueva Zelanda, consulte el sitio web del servicio postal de ese país: www.nzpost.co.nz.
- Campos obligatorios: las direcciones deben incluir una ciudad o un código postal.
- Alias de suburbios: el geocodificador admite el uso de los nombres de uso local de los suburbios, además de los nombres reconocidos de forma oficial. Por ejemplo, Rosedale es un alias del nombre oficial del suburbio Hargest.
- Tipos de vías públicas: el sistema admite por completo y reconoce los tipos de vías públicas y sus abreviaturas comunes en los datos de entrada y salida.
- Abreviaturas y palabras comunes: el geocodificador reconoce las palabras comunes, datos direccionales, indicadores de números de casas y abreviaturas utilizadas en las direcciones, y puede geocodificar estas direcciones correctamente.
- Números, equivalentes numéricos y ordinales: las calles con número se asignan a sus equivalentes con nombres. Los números ordinales también se reconocen en las direcciones de entrada.
Entrada en una sola línea
En lugar de ingresar cada componente de dirección en campos separados, puede ingresar la dirección completa en el campo de entrada mainAddress con los elementos de dirección ordenados de la siguiente manera:
[unit_info][address_number][street_info][areaName4][areaName3][postal_code]
Donde:- [unit_info] es el tipo de unidad o valor. Opcional.
- [address_number] es opcional.
- [street_info] consiste en el nombre de la calle, tipo de calle e información direccional previa o posterior (por ejemplo, Este, Oeste, etc.).
- [areaName4] es el barrio.
- [areaName3] es la ciudad.
- [postal_code] es el código postal de cuatro dígitos.
- Se requiere [areaName3] o [postal_code].
Para obtener los mejores resultados, escriba una coma entre la información de dirección y la información de la última línea.
Opciones personalizadas
No existen opciones personalizadas para Nueva Zelanda.
Campos de salida de dirección analizada
La siguiente tabla muestra los campos de dirección analizada devueltos para un candidato ubicado en Nueva Zelanda.
- Para devolver los campos de Dirección analizada: en el menú desplegable Filtros por país, seleccione Valores globales predeterminados. Luego, en la pestaña Valores de devolución, seleccione Dirección analizada.
- Para devolver todos los campos de salida: en el menú desplegable Filtros por país, seleccione Valores globales predeterminados. Luego, en la pestaña Valores de devolución, seleccione Devolver toda la información disponible.
| Nombre de campo | Descripción |
|---|---|
| mainAddressLine | Dirección de calle que puede incluir el nombre de la empresa, el número de casa, los nombres de edificios y los nombres de las calles. |
| addressLastLine | La última línea de la dirección. |
| placeName | Nombre del edificio, nombre del lugar, punto de interés (POI), nombre de la empresa o firma relacionada con la dirección. |
| areaName1 | La región. |
| areaName2 | No se utiliza. |
| areaName3 | La ciudad o pueblo. |
| areaName4 | El barrio. |
| postCode1 | El código postal de 4 dígitos. |
| postCode2 | No se utiliza. |
| country | El código de país de tres letras ISO 3166-1 Alpha 3. Para Nueva Zelanda, el código de país es NZL. |
| addressNumber | El número de dirección. |
| streetName | El nombre de la calle o el camino. |
| unitType | Tipo de unidad, por ejemplo, APT, STE, etc. |
| unitValue | El número o valor de la unidad, por ejemplo, "3B". |
| customFields | La siguiente tabla muestra los campos personalizados para Nueva Zelanda. |
Campos de salida personalizados
La siguiente tabla muestra los campos de salida específicos para Nueva Zelanda. A menos que se indique lo contrario, estos campos se pueden devolver para la geocodificación directa e inversa.
- To return one or more of these custom output fields: In Management Console, use the Country Filter dropdown menu and select New Zealand. Then, on the Return Values tab, select the desired output field(s).
- To return all custom output fields: In Management Console, use the Country Filter dropdown menu and select New Zealand. Luego, en la pestaña Valores de devolución, seleccione Devolver toda la información disponible.
| Nombre | Descripción |
|---|---|
| NZL.Aliased Suburb | Suburbio de alias de Nueva Zelanda. Una alternativa al nombre del suburbio oficialmente reconocido. Para incluir este campo en el resultado, seleccione: checkbox. |
| NZL.KEY UFI | El UFI de Nueva Zelanda. El identificador único (UFI) identifica el segmento de calle al que pertenece la dirección geocodificada. Los UFI son números de hasta 7 dígitos, asignados por el correo de Nueva Zelanda, que identifican de forma única cada punto de entrega postal. El UFI siempre se devuelve si está disponible, pero no se puede utilizar el UFI para entrada. Para incluir este campo en el resultado, seleccione: checkbox. |
| NZL.NZL Mesh Block ID | El identificador de meshblock de Nueva Zelanda. Un "meshblock" es la unidad geográfica más pequeña respecto de la cual la Oficina de Estadística de Nueva Zelanda recaba datos estadísticos. Los meshblocks pueden tener diferentes tamaños, lo que abarca desde una parte de un bloque urbano a grandes extensiones de terrenos rurales. Para incluir este campo en el resultado, seleccione: checkbox. |
| NZL.Original Latitude | El valor de latitud original. Para incluir este campo en el resultado, seleccione: checkbox. |
| NZL.Original Longitude | El valor de longitud original. Para incluir este campo en el resultado, seleccione: checkbox. |