SpatialReference
サマリ
Each part of the spatial reference has a number of properties, especially the coordinate system, which defines what map projection options are used to define horizontal coordinates.
説明
A SpatialReference can be easily created from existing datasets and PRJ files:
- Use a PRJ file as an argument to the SpatialReference class.
import arcpy, os prjFile = os.path.join(arcpy.GetInstallInfo()["InstallDir"], "Coordinate Systems/Geographic Coordinate Systems/North America/NAD 1983.prj") spatialRef = arcpy.SpatialReference(prjFile)
- Describe a dataset and access its spatialReference property.
dataset = "C:/Data/Landbase.gdb/Wetlands" spatialRef = arcpy.Describe(dataset).spatialReference
Which spatial reference properties are available depends on the coordinate system used. In the properties list below, those properties only available with a Projected Coordinate system are denoted with a 1; properties available only with a Geographic Coordinate system are denoted with a 2.
構文
パラメータ | 説明 | データ タイプ |
prjFile |
The projection file used to populate the spatial reference object. | String |
プロパティ
プロパティ | 説明 | データ タイプ |
MDomain (読み取り専用) |
The extent of the measure domain. | String |
MFalseOriginAndUnits (読み取り専用) |
The measure false origin and units. | String |
MResolution (読み書き) |
The measure resolution. | Double |
MTolerance (読み書き) |
The measure tolerance. | Double |
XYResolution (読み書き) |
The xy resolution. | Double |
XYTolerance (読み書き) |
The xy tolerance. | Double |
ZDomain (読み取り専用) |
The extent of the Z domain. | String |
ZFalseOriginAndUnits (読み取り専用) |
The Z false origin and units. | String |
ZResolution (読み書き) |
The Z resolution property. | Double |
ZTolerance (読み書き) |
The Z tolerance property. | Double |
abbreviation (読み書き) |
The abbreviated name of the spatial reference. | String |
alias (読み書き) |
The alias of the spatial reference. | String |
domain (読み取り専用) |
The extent of the xy domain. | String |
factoryCode (読み書き) |
The factory code of the spatial reference. | Integer |
falseOriginAndUnits (読み取り専用) |
The false origin and units. | String |
hasMPrecision (読み取り専用) |
Indicates whether or not m-value precision information has been defined. | Boolean |
hasXYPrecision (読み取り専用) |
Indicates whether or not xy precision information has been defined. | Boolean |
hasZPrecision (読み取り専用) |
Indicates whether or not z-value precision information has been defined. | Boolean |
isHighPrecision (読み書き) |
Indicates whether or not the spatial reference has high precision set. | Boolean |
name (読み書き) |
The name of the spatial reference. | String |
remarks (読み書き) |
The comment string of the spatial reference. | String |
type (読み書き) |
The type of the spatial reference. | String |
usage (読み取り専用) |
The usage notes. | String |
PCSCode (読み書き) |
The projected coordinate system code.1 | Integer |
PCSName (読み書き) |
The projected coordinate system name.1 | String |
azimuth (読み書き) |
The azimuth of a projected coordinate system.1 | Double |
centralMeridian (読み書き) |
The central meridian of a projected coordinate system.1 | Double |
centralMeridianInDegrees (読み書き) |
The central meridian (Lambda0) of a projected coordinate system in degrees.1 | Double |
centralParallel (読み書き) |
The central parallel of a projected coordinate system.1 | Double |
classification (読み取り専用) |
The classification of a map projection.1 | String |
falseEasting (読み書き) |
The false easting of a projected coordinate system.1 | Double |
falseNorthing (読み書き) |
The false northing of a projected coordinate system.1 | Double |
latitudeOf1st (読み書き) |
The latitude of the first point of a projected coordinate system.1 | Double |
latitudeOf2nd (読み書き) |
The latitude of the second point of a projected coordinate system.1 | Double |
linearUnitCode (読み書き) |
The linear unit code.1 | Integer |
linearUnitName (読み書き) |
The linear unit name.1 | String |
longitude (読み書き) | The longitude value of this prime meridian.1 | Double |
longitudeOf1st (読み書き) |
The longitude of the first point of a projected coordinate system.1 | Double |
longitudeOf2nd (読み書き) |
The longitude of the second point of a projected coordinate system.1 | Double |
longitudeOfOrigin (読み書き) |
The longitude of origin of a projected coordinate system.1 | Double |
projectionCode (読み書き) |
The projection code.1 | Integer |
projectionName (読み書き) |
The projection name.1 | String |
scaleFactor (読み書き) |
The scale factor of a projected coordinate system.1 | Double |
standardParallel1 (読み書き) |
The first parallel of a projected coordinate system.1 | Double |
standardParallel2 (読み書き) |
The second parallel of a projected coordinate system.1 | Double |
GCSCode (読み書き) |
The geographic coordinate system code.2 | Integer |
GCSName (読み書き) |
The geographic coordinate system name.2 | String |
angularUnitCode (読み書き) |
The angular unit code.2 | Integer |
angularUnitName (読み書き) |
The angular unit name.2 | String |
datumCode (読み書き) |
The datum code.2 | Integer |
datumName (読み書き) |
The datum name.2 | String |
flattening (読み書き) |
The flattening ratio of this spheroid.2 | Double |
longitude (読み書き) |
The longitude value of this prime meridian.2 | Double |
primeMeridianCode (読み書き) |
The prime meridian code.2 | Integer |
primeMeridianName (読み書き) |
The prime meridian name.2 | String |
radiansPerUnit (読み取り専用) |
The radians per angular unit.2 | Double |
semiMajorAxis (読み書き) |
The semi-major axis length of this spheroid.2 | Double |
semiMinorAxis (読み書き) |
The semi-minor axis length of this spheroid.2 | Double |
spheroidCode (読み書き) |
The spheroid code.2 | Integer |
spheroidName (読み書き) |
The spheroid name.2 | String |
メソッドの概要
メソッド | 説明 |
create () |
Creates the spatial reference object using properties. |
createFromFile (prj_file) |
Creates the spatial reference object from a projection file. |
exportToString () |
Exports the object to its string representation. |
loadFromString (string) |
Restore the object using its string representation. The exportToString method can be used to create a string representation. |
setDomain (x_min, x_max, y_min, y_max) |
Sets the XY domain. |
setFalseOriginAndUnits (false_x, false_y, xy_units) |
Sets the XY false origin and units. |
setMDomain (m_min, m_max) |
Sets the M domain. |
setZDomain (z_min, z_max) |
Sets the Z domain. |
setMFalseOriginAndUnits (false_m, m_units) |
Sets the M false origin and units. |
setZFalseOriginAndUnits (false_z, z_units) |
Sets the Z false origin and units. |
メソッド
パラメータ | 説明 | データ タイプ |
prj_file |
The projection file used to populate the spatial reference object. | String |
データ タイプ | 説明 |
String |
The string representation of the object. |
パラメータ | 説明 | データ タイプ |
string |
The string representation of the object. | String |
パラメータ | 説明 | データ タイプ |
x_min |
The minimum x-value. | Double |
x_max |
The maximum x-value. | Double |
y_min |
The minimum y-value. | Double |
y_max |
The maximum y-value. | Double |
パラメータ | 説明 | データ タイプ |
false_x |
The false x value. | Double |
false_y |
The false y value. | Double |
xy_units |
The xy units. | String |
パラメータ | 説明 | データ タイプ |
m_min |
The minimum m-value. | Double |
m_max |
The maximum m-value. | Double |
パラメータ | 説明 | データ タイプ |
z_min |
The minimum z-value. | Double |
z_max |
The maximum z-value. | Double |
パラメータ | 説明 | データ タイプ |
false_m |
The false m-value. | Double |
m_units |
The m units. | Double |
パラメータ | 説明 | データ タイプ |
false_z |
The false z-value. | Double |
z_units |
The false z units. | Double |
コードのサンプル
For each feature class in a workspace, print the name of its spatial reference.
import arcpy from arcpy import env # Set the workspace environment # env.workspace = "C:/base/base.gdb" # Get a list of the feature classes in the input folder # fcs = arcpy.ListFeatureClasses() # Loop through the list # for fc in fcs: # Create the spatial reference object # sr = arcpy.Describe(fc).spatialReference # If the spatial reference is unknown # if sr.name == "Unknown": print fc + " has an unknown spatial reference\n" # Otherwise, print out the feature class name and # spatial reference # else: print fc + ": " + sr.name + "\n"
Create a SpatialReference using a .prj file.
import arcpy prjFile = "c:/Program Files/ArcGIS/Desktop10.0/Coordinate Systems/Projected Coordinate Systems" + \ "/Continental/North America/USA Contiguous Equidistant Conic.prj" # Create a spatial reference object using a projection file # sr = arcpy.SpatialReference(prjFile)
Create a SpatialReference from a factory code.
import arcpy # Create a spatial reference object using a factory code # sr = arcpy.SpatialReference() sr.factoryCode = 3857 sr.create()