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.
Parámetro | 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. |
mainAddress | Cadena | Entrada en una sola línea: si ningún otro campo de dirección está completado, entonces la entrada mainAddress 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 mainAddress 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
La siguiente tabla muestra las opciones específicas para Nueva Zelanda. Este campo personalizado corresponde a la operación de geocodificación y es un parámetro de entrada opcional. For the standard set of options available to all countries and their definitions, see the chapters covering Geocode Service and Reverse Geocode Service.
Nombre de la opción | Descripción |
---|---|
ReturnOriginalCoordinates | Cuando se configura en verdadero, devuelve los valores y en los campos de salida personalizados del candidato. |
Campos de salida de
La siguiente tabla muestra los campos de dirección devueltos para un candidato ubicado en Nueva Zelanda.
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.
Nombre | Descripción |
---|---|
ALIASED_SUBURB | Suburbio de alias de Nueva Zelanda. Una alternativa al nombre del suburbio oficialmente reconocido. |
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. |
NZL_MESHBLOCK_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. |
ORIGINAL_LATITUDE | El valor de latitud original. |
ORIGINAL_LONGITUDE | El valor de longitud original. |