Canadá (CAN)
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 Canadá.
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 Canadá.
| 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 |
|---|---|---|---|---|---|---|---|
| TomTom MultiNet Canada Data | Sí | Sí | Sí | Sí | Sí | Sí | Sí |
| Puntos NAVTEQ en inglés, francés | Sí | Sí | Sí | No | No | Sí | No |
- Statistics Canada PCCF (códigos postales) y FSA Boundaries
- Canada Post Address Range Data
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
Las direcciones de Canadá pueden 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: 5500 Explorer Drive |
| areaName1 | Cadena | Especifica la provincia. Opcional. |
| areaName2 | Cadena | No se utiliza. |
| areaName3 | Cadena | Especifica el nombre de la ciudad o el pueblo. Opcional. |
| areaName4 | Cadena | Especifica el área de diseminación y área de enumeración (Dissemination Area y Enumeration Area, DA/ EA). Opcional. |
| postalCode | Cadena | Canadá utiliza un código postal de seis caracteres. Por lo general, los primeros tres caracteres están separados de los otros tres por medio de un espacio. Los primeros tres caracteres indican el código FSA, y los otros tres caracteres corresponden al código LDU. La geocodificación de direcciones físicas (de calles) solo requiere FSA, en tanto la geocodificación de códigos postales requiere el código postal completo (FSALDU). Usted elige si desea que aparezca un espacio entre los primeros y los últimos tres caracteres del código postal. Si se mantiene siempre el mismo formato, se agiliza el proceso de geocodificación. Opcional. |
| country | Cadena | El código de país de tres letras ISO 3166-1 Alpha 3. Para Canadá, el código de país es CAN. Obligatorio para la geocodificación directa. |
Pautas de direcciones para Canadá
Siga estas recomendaciones para asegurarse de que los datos de entrada de calle tengan el mejor formato posible para una óptima coincidencia y geocodificación.
- Números de casilla de oficina postal: las direcciones de casillas postales y rutas rurales no pueden geocodificarse. Estos datos de entrada del usuario se respetan y se realiza un intento de arrojar información de casillas postales y rutas rurales, pero no se utilizará para fines de geocodificación.
- Direcciones de carreteras: las direcciones de carreteras (como por ejemplo Hwy 401) pueden geocodificarse.
- Números de casas y letras de departamentos: elimine los espacios entre el número de casa y la letra del departamento (apartamento). La dirección 123 A Main Street no se geocodificará correctamente porque el geocodificador supone que el nombre de la calle es A. Existen dos opciones posibles para solucionar esto: no incluir la letra del departamento o eliminar el espacio entre el número de la casa y la letra del departamento.
- Números de casas e información de unidades: el número de casa indica la ubicación de la dirección. Los datos de unidad pueden ingresarse en uno de los siguientes dos formatos, tal como se muestra en estos ejemplos:
- 99-123 Main St, donde 99 es el número de unidad. En este formato, no se especifica el tipo de unidad. El número 99 puede hacer referencia a una habitación (suite), departamento, unidad, piso o cualquier tipo de unidad que sea válido.
- 123 Main St. Apt 99, donde Apt es el tipo de unidad y 99 indica el número de la unidad. En este formato, debe especificar un tipo de unidad válido (como Apt o Suite), pues de lo contrario la dirección no se geocodificará correctamente. - Sufijos direccionales: utilice sufijos direccionales siempre que sea posible. Esto es especialmente importante en municipios y ciudades, como por ejemplo Calgary, que constan en su mayoría de calles asignadas con números. Estas calles solo pueden distinguirse por medio de estos sufijos direccionales y los tipos de calles. Estos datos también permiten distinguir direcciones en calles que cambian de orientación. Por ejemplo: 123 Main St W y 123 Main St E tienen coordenadas muy diferentes.
- Tipos de calles: distinguen calles diferentes con el mismo nombre. Por ejemplo, Main Avenue y Main Street son dos entidades completamente diferentes. Si bien el uso de tipos de calles no es esencial, agrega precisión a los datos. Para acceder a una lista de tipos de calles válidos, visite el sitio www.canadapost.com.
- Nombre de la ciudad: no abrevie los nombres de las ciudades. Si se desconoce la ciudad, puede dejar este dato en blanco, aunque esto puede afectar la exactitud de la geocodificación.
- Nombre de la provincia: puede usar el nombre completo de la provincia (por ejemplo, Ontario), aunque se recomienda usar la abreviatura de dos caracteres (en este caso, ON) para reducir la probabilidad de que haya errores al ingresar los datos. Si no hay un código postal, debe ingresar la provincia y la ciudad para la geocodificación.
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:
[address_number][street_info][area_name_3][area_name_1][post_code_1][post_code_2]
- [address_number] es opcional.
- [street_info] consiste en el nombre de la calle, tipo de calle y cualquier tipo de unidad, valor de unidad o información direccional previa o posterior (por ejemplo, Este, Oeste, etc.).
- [area_name_3] es la ciudad o pueblo.
- [area_name_1] es la provincia.
- [postal_code_1] es la parte FSA del código postal.
- [postal_code_2] es la parte LDU del código postal.
Para obtener los mejores resultados, escriba una coma entre la información de dirección y la información de la última línea (por ejemplo, ciudad y código postal).
Opciones personalizadas
La siguiente tabla muestra las opciones específicas para Canadá. Estas opciones personalizadas son parámetros de entrada opcionales y, a menos que se indique lo contrario, están disponibles para la geocodificación y la geocodificación inversa.
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 |
|---|---|
| KEY_MUST_HAVE_LDU | Cuando es verdadero, no devuelve coincidencias que no tengan el código postal FSA LDU completo. Default = false. |
| USE_ADDRESS_POINT_INTERPOLATION | Cuando se configura en true, utiliza la interpolación de punto de dirección. Opción predeterminada = false. Solo se admite en la geocodificación hacia delante. Nota: La función de interpolación de punto de dirección exige que tenga instalado un conjunto de datos de geocodificación de nivel de punto.
|
| USE_CENTERLINE_OFFSET | Cuando se configura en true, calcula el desplazamiento de línea central para las direcciones de punto. Opción predeterminada =false. Solo se admite en la geocodificación hacia delante. Nota: La función de línea central exige que tenga instalado un conjunto de datos de geocodificación de nivel de punto.
Las coincidencias de punto de línea central se indican por medio de un código de resultado que comienza con SC. |
| CENTERLINE_OFFSET | Cuando USE_CENTERLINE_OFFSET está habilitado, especifica la distancia de desplazamiento del punto en relación con la línea central. Default = 0. Solo se admite en la geocodificación directa. |
| CENTERLINE_OFFSET_UNIT | Cuando USE_CENTERLINE_OFFSET está habilitado, especifica el tipo de unidad para el desplazamiento de línea central. Valores válidos = pies, metros. Valor predeterminado = metros. Solo se admite en la geocodificación hacia delante. |
Campos de salida de
La siguiente tabla muestra los campos de dirección devueltos para un candidato ubicado en Canadá.
| 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 provincia. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| areaName2 | No se utiliza. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| areaName3 | El pueblo o la ciudad. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| areaName4 | Área de diseminación y área de enumeración (Dissemination Area y Enumeration Area, DA/ EA). | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| dataType |
El valor numérico devuelto representa un proveedor de datos.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| postCode1 | Parte FSA del código postal. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| postCode2 | Parte LDU del código postal. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| country | El código de país de tres letras ISO 3166-1 Alpha 3. Para Canadá, el código de país es CAN. | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 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 | Consulte la siguiente sección para conocer las definiciones de los campos personalizados. |
Campos de salida personalizados
La siguiente tabla muestra los campos de salida específicos para Canadá. A menos que se indique lo contrario, estos campos se pueden devolver para la geocodificación directa e inversa.
| Nombre de campo | Descripción |
|---|---|
| CENSUS_CD | La división de censo (Census Division, CD) en la que se encuentra la dirección. |
| CENSUS_CMA | El área metropolitana de censo (Census Metropolitan Area, CMA) en la que se encuentra la dirección. |
| CENSUS_CSD | La subdivisión de censo (Census Subdivision, CSD) en la que se encuentra la dirección. |
| CENSUS_CT | El distrito de censo (Census Tract, CT) en el que se encuentra la dirección. |
| CENSUS_DA | El área de diseminación (Dissemination Area, DA) en la que se encuentra la dirección. |
| FORMATTED_STREET_RANGE | Los datos del rango con formato de la dirección. Este campo solo se devuelve para candidatos de centroide postal. |