Extent

摘要

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

说明

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

注：

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

语法

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

参数	说明	数据类型
XMin	范围 XMin 值。	Double
YMin	范围 YMin 值。	Double
XMax	范围 XMax 值。	Double
YMax	范围 YMax 值。	Double
ZMin	范围 ZMin 值。如果无 z 值，则为“无”。	Double
ZMax	范围 ZMax 值。如果无 z 值，则为“无”。	Double
MMin	范围 MMin 值。如果无 m 值，则为“无”。	Double
MMax	范围 MMax 值。如果无 m 值，则为“无”。	Double

属性

属性	说明	数据类型
JSON (只读)	返回一个字符串形式的范围 JSON 制图表达。 提示： 通过 json 模块的 loads 函数，返回的字符串可转换至字典。	String
MMax (只读)	范围 MMax 值。如果无 m 值，则为“无”。	Double
MMin (只读)	范围 MMin 值。如果无 m 值，则为“无”。	Double
XMax (只读)	范围 XMax 值。	Double
XMin (只读)	范围 XMin 值。	Double
YMax (只读)	范围 YMax 值。	Double
YMin (只读)	范围 YMin 值。	Double
ZMax (只读)	范围 ZMax 值。如果无 z 值，则为“无”。	Double
ZMin (只读)	范围 ZMin 值。如果无 z 值，则为“无”。	Double
depth (只读)	范围深度值。如果无深度，则为“无”。	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)	指明基础几何和比较几何是否未共用任何点。 如果 disjoint 返回 False，则两个几何相交。 本图仅显示 True 关系。
equals (second_geometry)	指示原几何和参照几何的 shape 类型是否相同并在平面中定义相同点集。这仅是 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	第二个几何。	Object
relation	空间关系类型。 BOUNDARY— 关系对内部或边界没有任何限制。 CLEMENTINI— 几何内部必须相交。指定 CLEMENTINI 等于指定 None。这是默认设置。 PROPER— 几何边界不得相交。 (默认值为 None)	String

返回值

数据类型	说明
Boolean	返回的布尔值 True 表示该几何包含第二个几何。

crosses (second_geometry)

参数	说明	数据类型
second_geometry	第二个几何。	Object

返回值

数据类型	说明
Boolean	返回布尔值为 True 指明两个几何相交于较小形状类型的几何。

disjoint (second_geometry)

参数	说明	数据类型
second_geometry	第二个几何。	Object

返回值

数据类型	说明
Boolean	返回布尔值 True 表示两个几何未共用任何点。

equals (second_geometry)

参数	说明	数据类型
second_geometry	第二个几何。	Object

返回值

数据类型	说明
Boolean	返回布尔值为 True 表示两个几何的 shape 类型相同并在平面中定义了相同点集。

overlaps (second_geometry)

参数	说明	数据类型
second_geometry	第二个几何。	Object

返回值

数据类型	说明
Boolean	返回布尔值为 True 表示两个几何的交集具有与其中一个输入几何相同的尺寸。

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 AllSource, 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	第二个几何。	Object

返回值

数据类型	说明
Boolean	返回布尔值为 True，表示几何的边界相交。

within (second_geometry, {relation})

参数	说明	数据类型
second_geometry	第二个几何。	Object
relation	空间关系类型。 BOUNDARY— 关系对内部或边界没有任何限制。 CLEMENTINI— 几何内部必须相交。指定 CLEMENTINI 等于指定 None。这是默认设置。 PROPER— 几何边界不得相交。 (默认值为 None)	String

返回值

数据类型	说明
Boolean	返回布尔值 True 表示该几何被包含在另一个几何之内。

代码示例

范围示例

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

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))