Importar puntos de estructura de parcelas (Parcela)

Resumen

Importa datos de puntos desde una clase de entidad de punto de origen a la clase de entidad de puntos de estructura de parcelas. Los puntos de estructura de parcelas que coinciden o están dentro de una tolerancia de proximidad de los puntos de origen se pueden actualizar con los datos de puntos importados. Si la capa de puntos de origen tiene una selección, solo se importará la información del punto seleccionado.

Los puntos se pueden importar para retirar y reemplazar las posiciones de los puntos de estructura de parcelas existentes o para actualizar las posiciones de los puntos de estructura de parcela existentes. Los puntos también se pueden importar a una estructura de parcelas vacía o a un área donde no existan puntos.

Los puntos de estructura de parcelas existentes se pueden actualizar de las siguientes maneras:

  • Los puntos se pueden retirar y se pueden crear puntos nuevos con posiciones actualizadas (x,y,z) desde los puntos importados.
  • Los puntos existentes se pueden actualizar con posiciones (x,y,z) desde los puntos de origen. Los atributos también se pueden actualizar. Los puntos de estructura de parcelas existentes se mantendrán activos (no históricos).

Si los puntos de estructura de parcelas de destino satisfacen los requisitos de búsqueda y filtrado y si la clase de entidad de punto de origen tiene valores z, se actualizarán las coordenadas x, y, z de forma de los puntos de estructura de parcelas. Si la clase de entidad de punto de origen no tiene valores z, solo se actualizarán las coordenadas x,y de forma de los puntos de estructura de parcelas y los valores z existentes no se modificarán. Si se actualizan las coordenadas x,y de forma de los puntos de estructura de parcelas, los polígonos y las líneas de parcela conectados se actualizarán para que coincidan con las nuevas ubicaciones de coordenadas.

Al crear puntos, se pueden asignar a un registro de parcela nuevo o existente.

Uso

  • Esta herramienta modificará los datos de la estructura de parcelas de destino. Es posible que los valores de atributo de puntos de estructura de parcelas se modifiquen. Es posible que las geometrías de punto, línea y polígono de la estructura de parcelas se modifiquen. La herramienta no eliminará las entidades de la estructura de parcelas.

  • La herramienta puede actualizar tanto la geometría (coordenadas de forma) como los atributos, o solo la geometría de los puntos de la estructura de parcelas. Si se actualizan los atributos, los campos de punto de estructura de parcelas que coincidan con los campos de la clase de entidad de puntos de origen se actualizarán con los valores de atributo de los puntos de origen.

    Nota:
    Si los puntos de la estructura de parcelas existentes tienen el campo IsFixed establecido en Sí, estos puntos no se actualizarán haciendo coincidir los puntos importados. Para actualizar estos puntos, asegúrese de que su campo IsFixed esté establecido en No.

  • La distancia de búsqueda se aplica al comparar las coordenadas x,y de forma de los puntos de origen con las coordenadas x,y de forma de los puntos de estructura de parcelas. La distancia de búsqueda ignora los valores z.

  • Si las referencias espaciales de la clase de entidad de punto de origen y la estructura de parcelas de destino no coinciden, la herramienta proyectará la clase de entidad de punto de origen al sistema de coordenadas que utiliza la estructura de parcelas de destino. Si los datums geográficos de las referencias espaciales de la clase de entidad de punto de origen y la estructura de parcelas de destino no coinciden, se aplicará una transformación geográfica utilizando la transformación de datums predeterminados.

  • Si hay más de un punto de estructura de parcelas en la tolerancia de proximidad de un punto de origen, se reportará un conflicto con un mensaje de advertencia. Es posible reportar conflictos en una tabla de conflictos. Si se especifica una tabla de conflictos en el parámetro Tabla de conflictos, los Id. de objetos del punto de origen y de los puntos de estructura de parcelas se almacenarán en la tabla.

  • Al importar puntos nuevos para retirar puntos existentes, utilice la opción Retirar y reemplazar del parámetro Actualizar tipo. El registro especificado en el parámetro Nombre de registro retirará los puntos existentes.

Parámetros

EtiquetaExplicaciónTipo de datos
Puntos de origen

La clase de entidad de punto de origen que se utilizará para crear o actualizar puntos en la estructura de parcelas de destino.

Feature Layer
Estructura de parcela de destino

La estructura de parcelas de destino en la que se actualizarán o crearán puntos. La estructura de parcelas de destino puede provenir de una geodatabase de archivos, de una geodatabase corporativa conectada a la versión predeterminada o una geodatabase móvil, o bien de un servicio de entidades.

Parcel Layer
Método de puntos de coincidencia

Especifica el método que se utilizará para encontrar puntos de estructura de parcelas existentes que coincidan con los puntos de origen.

  • ProximidadLos puntos de estructura de parcelas que están dentro de la tolerancia de proximidad de los puntos de origen se harán coincidir con los puntos de origen y se actualizarán. Esta es la opción predeterminada.
  • Nombre y proximidadLos puntos de estructura de parcelas que están dentro de la tolerancia de proximidad y que tienen el mismo nombre que los puntos de origen se harán coincidir con los puntos de origen y se actualizarán.
  • Id. global y proximidadLos puntos de estructura de parcelas que están dentro de la tolerancia de proximidad y que tienen el mismo Id. global que los puntos de origen se harán coincidir con los puntos de origen y se actualizarán. Los Id. globales se almacenan en el campo Global ID de la clase de entidad de puntos de estructura de parcelas y en el campo Global ID especificado de la clase de entidad de origen.
String
Distancia de búsqueda
(Opcional)

La distancia que se utilizará para buscar los puntos de estructura de parcelas que están próximos a los puntos de origen.

Linear Unit
Actualizar tipo

Especifica el tipo de actualización que se aplicará a los puntos de estructura de parcelas que coincidan con los puntos de origen.

  • TodoSe actualizarán la geometría (x,y,z) y los campos de atributo coincidentes de puntos de estructura de parcelas. Si se actualiza la geometría de puntos de estructura de parcelas, las entidades de parcela coincidentes también se actualizarán. Esta es la opción predeterminada.
  • Geometría (x,y,z)Solo se actualizará la geometría (x,y,z) de los puntos de estructura de parcelas. Si se actualiza la geometría de puntos de estructura de parcelas, las entidades de parcela coincidentes también se actualizarán.
  • Retirar y reemplazarLos puntos de origen se importarán como puntos de estructura de parcelas nuevos. Todos los puntos de estructura de parcelas coincidentes se retirarán como históricos. El campo Retired By Record de cada punto de estructura de parcelas coincidente se rellenará con el Id. global del registro especificado en el parámetro Nombre de registro.
String
Nombre de registro
(Opcional)

El nombre del registro que se asociará con los nuevos puntos importados.

Si el registro existe en la estructura de parcelas de destino, los puntos nuevos se asociarán con el registro. Si el registro no existe, se creará uno. Si los puntos nuevos reemplazan puntos existentes y Actualizar tipo está establecido como Retirar y reemplazar, el registro se utilizará para retirar los puntos como históricos.

String
Campo de coincidencia
(Opcional)

El campo que se utilizará para hacer coincidir los puntos de origen con los puntos de estructura de parcelas al utilizar Nombre y proximidad o Id. global y proximidad para el parámetro Método de puntos de coincidencia. Al buscar por nombre, el campo de la clase de entidad de punto de origen debe ser del tipo Texto. Al buscar por Id. global, el campo de la clase de entidad de punto de origen debe ser del tipo GUID.

Field
Tabla de conflictos
(Opcional)

La ruta y el nombre de la tabla de salida que almacenará los conflictos. Si hay más de un punto de estructura de parcelas en la tolerancia de búsqueda de un punto de origen, los Id. de objeto de los puntos de origen y los puntos de estructura de parcelas se informarán en la tabla de conflictos.

Table
Actualizar y crear opciones
(Opcional)

Especifica si se actualizarán o crearán puntos, o ambos. Al especificar la opción Actualizar si hay coincidencias y crear si no hay coincidencias o Actualizar solo con coincidencia, hay parámetros opcionales disponibles para filtrar los puntos coincidentes de la estructura de parcela de destino.

Nota:

Los puntos existentes no se actualizarán si el campo IsFixed está establecido en Sí.

  • Actualizar si hay coincidencias y crear si no hay coincidenciasSe crearán puntos si no se encuentran puntos coincidentes utilizando los criterios de búsqueda. Si se encuentran puntos coincidentes utilizando los criterios de búsqueda, se actualizarán. Si lo desea, es posible filtrar los puntos coincidentes en la estructura de parcela de destino mediante una expresión SQL. Esta es la opción predeterminada.
  • Crear solo sin coincidenciaSe crearán puntos solo si no se encuentran puntos coincidentes utilizando los criterios de búsqueda. Si se encuentran puntos coincidentes utilizando los criterios de búsqueda, permanecerán sin cambios y no se crearán puntos.
  • Actualizar solo con coincidenciaLos puntos se actualizarán si se encuentran puntos coincidentes utilizando los criterios de búsqueda. Si lo desea, es posible filtrar los puntos coincidentes en la estructura de parcela de destino mediante una expresión SQL. Si no se encuentran puntos coincidentes, los puntos no se actualizarán.
String
Puntos de la estructura de parcela de destino
(Opcional)

La capa de puntos de la estructura de parcela que se filtrará mediante una expresión SQL. Esta capa de puntos debe proceder de la estructura de parcelas de destino.

Feature Layer
Filtrar puntos de la estructura de parcela de destino
(Opcional)

Una expresión SQL que filtra los puntos coincidentes que se encuentran en la capa de puntos de la estructura de parcela de destino. Por ejemplo, actualice únicamente los puntos coincidentes que no estén retirados como históricos (RetiredByRecord IS NULL).

SQL Expression

Salida derivada

EtiquetaExplicaciónTipo de datos
Estructura de parcelas actualizada

La estructura de parcelas actualizada.

Parcel Layer

arcpy.parcel.ImportParcelFabricPoints(source_points, target_parcel_fabric, match_point_method, {search_distance}, update_type, {record_name}, {match_field}, {conflicts_table}, {update_create_option}, {target_points}, {where_clause})
NombreExplicaciónTipo de datos
source_points

La clase de entidad de punto de origen que se utilizará para crear o actualizar puntos en la estructura de parcelas de destino.

Feature Layer
target_parcel_fabric

La estructura de parcelas de destino en la que se actualizarán o crearán puntos. La estructura de parcelas de destino puede provenir de una geodatabase de archivos, de una geodatabase corporativa conectada a la versión predeterminada o una geodatabase móvil, o bien de un servicio de entidades.

Parcel Layer
match_point_method

Especifica el método que se utilizará para encontrar puntos de estructura de parcelas existentes que coincidan con los puntos de origen.

  • PROXIMITYLos puntos de estructura de parcelas que están dentro de la tolerancia de proximidad de los puntos de origen se harán coincidir con los puntos de origen y se actualizarán. Esta es la opción predeterminada.
  • NAME_AND_PROXIMITYLos puntos de estructura de parcelas que están dentro de la tolerancia de proximidad y que tienen el mismo nombre que los puntos de origen se harán coincidir con los puntos de origen y se actualizarán.
  • GLOBALID_AND_PROXIMITYLos puntos de estructura de parcelas que están dentro de la tolerancia de proximidad y que tienen el mismo Id. global que los puntos de origen se harán coincidir con los puntos de origen y se actualizarán. Los Id. globales se almacenan en el campo Global ID de la clase de entidad de puntos de estructura de parcelas y en el campo Global ID especificado de la clase de entidad de origen.
String
search_distance
(Opcional)

La distancia que se utilizará para buscar los puntos de estructura de parcelas que están próximos a los puntos de origen.

Linear Unit
update_type

Especifica el tipo de actualización que se aplicará a los puntos de estructura de parcelas que coincidan con los puntos de origen.

  • ALLSe actualizarán la geometría (x,y,z) y los campos de atributo coincidentes de puntos de estructura de parcelas. Si se actualiza la geometría de puntos de estructura de parcelas, las entidades de parcela coincidentes también se actualizarán. Esta es la opción predeterminada.
  • GEOMETRY_XYZSolo se actualizará la geometría (x,y,z) de los puntos de estructura de parcelas. Si se actualiza la geometría de puntos de estructura de parcelas, las entidades de parcela coincidentes también se actualizarán.
  • RETIRE_AND_REPLACELos puntos de origen se importarán como puntos de estructura de parcelas nuevos. Todos los puntos de estructura de parcelas coincidentes se retirarán como históricos. El campo Retired By Record de cada punto de estructura de parcelas coincidente se rellenará con el Id. global del registro especificado en el parámetro Nombre de registro.
String
record_name
(Opcional)

El nombre del registro que se asociará con los nuevos puntos importados.

Si el registro existe en la estructura de parcelas de destino, los puntos nuevos se asociarán con el registro. Si el registro no existe, se creará uno. Si los puntos nuevos reemplazan puntos existentes y update_type es RETIRE_AND_REPLACE, el registro se utilizará para retirar los puntos como históricos.

String
match_field
(Opcional)

El campo que se utilizará para hacer coincidir los puntos de origen con los puntos de estructura de parcelas al utilizar NAME_AND_PROXIMITY o GLOBALID_AND_PROXIMITY para el parámetro match_point_method. Al buscar por nombre, el campo de la clase de entidad de punto de origen debe ser del tipo Texto. Al buscar por Id. global, el campo de la clase de entidad de punto de origen debe ser del tipo GUID.

Field
conflicts_table
(Opcional)

La ruta y el nombre de la tabla de salida que almacenará los conflictos. Si hay más de un punto de estructura de parcelas en la tolerancia de búsqueda de un punto de origen, los Id. de objeto de los puntos de origen y los puntos de estructura de parcelas se informarán en la tabla de conflictos.

Table
update_create_option
(Opcional)

Especifica si se actualizarán o crearán puntos, o ambos. Al especificar la opción UPDATE_AND_CREATE o UPDATE_ONLY, hay parámetros opcionales disponibles para filtrar los puntos coincidentes de la estructura de parcela de destino.

Nota:

Los puntos existentes no se actualizarán si el campo IsFixed está establecido en Sí.

  • UPDATE_AND_CREATESe crearán puntos si no se encuentran puntos coincidentes utilizando los criterios de búsqueda. Si se encuentran puntos coincidentes utilizando los criterios de búsqueda, se actualizarán. Si lo desea, es posible filtrar los puntos coincidentes en la estructura de parcela de destino mediante una expresión SQL. Esta es la opción predeterminada.
  • CREATE_ONLYSe crearán puntos solo si no se encuentran puntos coincidentes utilizando los criterios de búsqueda. Si se encuentran puntos coincidentes utilizando los criterios de búsqueda, permanecerán sin cambios y no se crearán puntos.
  • UPDATE_ONLYLos puntos se actualizarán si se encuentran puntos coincidentes utilizando los criterios de búsqueda. Si lo desea, es posible filtrar los puntos coincidentes en la estructura de parcela de destino mediante una expresión SQL. Si no se encuentran puntos coincidentes, los puntos no se actualizarán.
String
target_points
(Opcional)

La capa de puntos de la estructura de parcela que se filtrará mediante una expresión SQL. Esta capa de puntos debe proceder de la estructura de parcelas de destino.

Feature Layer
where_clause
(Opcional)

Una expresión SQL que filtra los puntos coincidentes que se encuentran en la capa de puntos de la estructura de parcela de destino. Por ejemplo, actualice únicamente los puntos coincidentes que no estén retirados como históricos (RetiredByRecord IS NULL).

SQL Expression

Salida derivada

NombreExplicaciónTipo de datos
updated_parcel_fabric

La estructura de parcelas actualizada.

Parcel Layer

Muestra de código

Ejemplo de ImportParcelFabricPoints (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la función ImportParcelFabricPoints para importar puntos a una estructura de parcelas en el modo inmediato.

import arcpy

arcpy.parcel.ImportParcelFabricPoints(
    "C:/Parcels/Database.gdb/UpdatePoints",
    "C:/Parcels/Database.gdb/County/CountyFabric", 'PROXIMITY', '0.1 Feet', 
    'ALL', 'Record001', None, "C:/Parcels/Database.gdb/ConflictsTable", 'UPDATE_AND_CREATE')

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

  • Basic: No
  • Standard: Sí
  • Advanced: Sí

Temas relacionados