Extent

摘要

范围是在地图单位下提供左下角和右上角坐标指定的一个矩形。

说明

Extent 对象支持用于比较范围的等于 (==) 和不等于 (!=) 运算符。

注：

当用作 ArcGIS Spatial Analyst 扩展模块 工具（创建常量栅格、创建正态栅格、创建随机栅格、按矩形提取、按掩膜提取和地形转栅格）的输入时，这些工具仅使用 XMin、YMin、XMax 和 YMax 值。

语法

 Extent  ({XMin}, {YMin}, {XMax}, {YMax}, {ZMin}, {ZMax}, {MMin}, {MMax}, {spatial_reference})

参数	说明	数据类型
XMin	范围的 XMin 值。	Double
YMin	范围的 YMin 值。	Double
XMax	范围的 XMax 值。	Double
YMax	范围的 YMax 值	Double
ZMin	范围 ZMin 值。 如果没有 z 值，则值为 None。	Double
ZMax	范围的 ZMax 值。 如果没有 z 值，则值为 None。	Double
MMin	范围的 MMin 值。 如果没有 m 值，则值为 None。	Double
MMax	范围的 MMax 值。 如果没有 m 值，则值为 None。	Double
spatial_reference	范围的空间参考。	SpatialReference

属性

属性	说明	数据类型
JSON (只读)	范围的 JSON 表示作为字符串。 提示： 通过 json 模块的 loads 函数，返回的字符串可转换至字典。	String
MMax (只读)	范围的 MMax 值。 如果没有 m 值，则值为 None。	Double
MMin (只读)	范围的 MMin 值。 如果没有 m 值，则值为 None。	Double
XMax (只读)	范围的 XMax 值。	Double
XMin (只读)	范围的 XMin 值。	Double
YMax (只读)	范围的 YMax 值	Double
YMin (只读)	范围的 YMin 值。	Double
ZMax (只读)	范围的 ZMax 值。 如果没有 z 值，则值为 None。	Double
ZMin (只读)	范围 ZMin 值。 如果没有 z 值，则值为 None。	Double
depth (只读)	范围深度值。 如果没有深度值，则值为 None。	Double
geohash (只读)	范围的 geohash 字符串。	String
geohashCovers (只读)	范围内最多四个最长的 geohash 字符串的列表。	String
geohashNeighbors (只读)	范围的 geohash 相邻字符串的列表。	String
height (只读)	范围的高度值。	Double
lowerLeft (只读)	左下属性：返回一个点对象。	Point
lowerRight (只读)	右下属性：返回一个点对象。	Point
polygon (只读)	将范围返回为面对象。	Polygon
spatialReference (只读)	范围的空间参考。	SpatialReference
upperLeft (只读)	左上属性：返回一个点对象。	Point
upperRight (只读)	右上属性：返回一个点对象。	Point
width (只读)	范围宽度。	Double

方法概述

方法	说明
contains (second_geometry, {relation})	指定基础几何是否包含比较几何。 contains 方法与 within 方法相反。 本图仅显示 True 关系。
crosses (second_geometry)	指定两个几何是否相交于较小形状类型的几何。 如果两条折线仅共用公共点（至少有一个点不是端点），则这两条折线交叉。 如果折线和面在面的内部共享一条折线（不等于整条折线）或一个公共点（对于垂直线），那么该折线与面交叉。 本图仅显示 True 关系。
disjoint (second_geometry)	指定基础几何和比较几何是否具有公共点。 此方法返回 False 时，两个几何相交。 本图仅显示 True 关系。
equals (second_geometry)	指定基础几何和比较几何是否具有相同的形状类型，并在平面中定义相同的点集。 这仅是 2D 的比较；已忽略 m 值和 z 值。 本图仅显示 True 关系。
overlaps (second_geometry)	指定两个几何的交集是否具有与其中一个输入几何相同的形状类型，并且不等于任一输入几何。 本图仅显示 True 关系。
projectAs (spatial_reference, {transformation_name})	将几何从一个空间参考投影到另一个空间参考。 当几何对象和目标空间参考没有公共基准面时，请指定 transformation_name 参数值。 有关详细信息，请参阅地理基准面变换和 ListTransformations。 当满足以下条件时，将执行垂直变换： 几何对象具有 z 坐标。 几何对象的空间参考和 spatial_reference 参数值均具有垂直坐标系。 transformation_name 参数值为垂直变换。 当 transformation_name 参数值是垂直变换，并且几何对象和目标空间参考都没有垂直坐标系时，函数将运算失败，并显示 ValueError 异常。 如果几何对象或 spatial_reference 参数值具有未知空间参考，则输出几何的空间参考将是 spatial_reference 参数值的空间参考。 不建议使用未知空间参考进行分析。 projectAs 方法不会修改 m 值（如果存在）。
touches (second_geometry)	指定几何的边界是否相交。 当两个几何的交集不为空，但它们内部的交集为空时，说明两个几何接触。 例如，仅当点与折线的一个终点重合时，才表示点与折线接触。 本图仅显示 True 关系。
within (second_geometry, {relation})	指定基础几何是否位于比较几何之内。 within 方法是与 contains 方法相反的运算符。 本图仅显示 True 关系。 如果基础几何是这些几何的交集且其内部交集不为空，则基础几何位于比较几何之内。 within 方法是 Clementini 运算符，在空的基础几何中除外。

方法

contains (second_geometry, {relation})

参数	说明	数据类型
second_geometry	A second geometry.	Object
relation	Specifies the spatial relationship type that will be used. BOUNDARY—The relationship has no restrictions for interiors or boundaries. CLEMENTINI— Interiors of geometries must intersect. This option is equivalent to specifying None. This is the default. PROPER— Boundaries of geometries must not intersect. (默认值为 None)	String

返回值

数据类型	说明
Boolean	返回此几何是否包含第二个几何。

crosses (second_geometry)

参数	说明	数据类型
second_geometry	A second geometry.	Object

返回值

数据类型	说明
Boolean	返回两个几何是否相交于较小形状类型的几何。

disjoint (second_geometry)

参数	说明	数据类型
second_geometry	A second geometry.	Object

返回值

数据类型	说明
Boolean	返回两个几何是否具有公共点。

equals (second_geometry)

参数	说明	数据类型
second_geometry	A second geometry.	Object

返回值

数据类型	说明
Boolean	返回两种几何是否具有相同的形状类型，并在平面中定义相同的点集。

overlaps (second_geometry)

参数	说明	数据类型
second_geometry	A second geometry.	Object

返回值

数据类型	说明
Boolean	返回两个几何的交集是否具有与其中一个输入几何相同的尺寸。

projectAs (spatial_reference, {transformation_name})

参数	说明	数据类型
spatial_reference	The spatial reference to which the geometry will be projected. The value can be a SpatialReference object or the coordinate system name.	SpatialReference
transformation_name	The geotransformation name. With ArcGIS Pro, if you do not specify a transformation, none will be applied. With ArcGIS Server, if you do not specify a transformation, a fallback transformation will be applied.	String

返回值

数据类型	说明
Object	经投影的几何。

touches (second_geometry)

参数	说明	数据类型
second_geometry	A second geometry.	Object

返回值

数据类型	说明
Boolean	返回几何的边界是否相交。

within (second_geometry, {relation})

参数	说明	数据类型
second_geometry	A second geometry.	Object
relation	Specifies the spatial relationship type that will be used. BOUNDARY—The relationship has no restrictions for interiors or boundaries. CLEMENTINI— Interiors of geometries must intersect. This option is equivalent to specifying None. This is the default. PROPER— Boundaries of geometries must not intersect. (默认值为 None)	String

返回值

数据类型	说明
Boolean	返回基础几何是否位于比较几何之内。

代码示例

范围示例

显示要素的范围对象属性。

import arcpy

feature_class = 'c:/Data/Florida.gdb/airports'

# Fetch each feature from the cursor and examine the extent properties
for row in arcpy.da.SearchCursor(feature_class, ['SHAPE@', 'CNTY_NAME']):
    extent = row[0].extent
    print('Extent of county {}:'.format(row[1]))
    print('XMin: {}, YMin: {}'.format(extent.XMin, extent.YMin))
    print('XMax: {}, YMax: {}'.format(extent.XMax, extent.YMax))