Краткая информация
Объекты FeatureSet являются упрощенным представлением класса пространственных объектов. Они представляют собой особый элемент данных, который содержит не только схему, но и данные. Объект FeatureSet – это также метод, с помощью которого данные объекта передаются и получаются с сервера.
Обсуждение
Примечание:
При загрузке класса объектов в новый FeatureSet и изменении FeatureSet с помощью инструмента геообработки, который изменяет вход как инструмент Вычислить поле или функции, подобной UpdateCursor, исходный класс объектов также будет изменен.
Синтаксис
FeatureSet ({table})| Параметр | Описание | Тип данных |
table | The features to load into the FeatureSet object. The input can be a catalog path to a feature class, a URL to a hosted feature layer, a JSON with the syntax {"url":"<url>", "serviceToken":"<ServiceToken>"} to load data from external sources that require an access token, or an Esri (FeatureSet) JSON string. An Esri JSON (.json) is a standard for encoding feature (geometry and attribute) data as a JSON object. | String |
Свойства
| Свойство | Описание | Тип данных |
| JSON (только чтение) | Возвращает представление геометрии Esri JSON в виде строки. Подсказка:Возвращаемая строка может быть конвертирована в словарь с помощью функции loads модуля json. | String |
Обзор метода
| Метод | Описание |
| load (table_path, {where_clause}, {time_filter}, {renderer}, {is_renderer}) | Импротирует таблицу в объект FeatureSet. |
| save (table_path) | Экспорт в таблицу. |
Методы
load (table_path, {where_clause}, {time_filter}, {renderer}, {is_renderer})| Параметр | Описание | Тип данных |
table_path | The features to load into the FeatureSet object. The input can be a catalog path to a feature class, a URL to a hosted feature layer, a JSON with the syntax {"url":"<url>", "serviceToken":"<ServiceToken>"} to load data from external sources that require an access token, or an Esri JSON string. | String |
where_clause | An SQL expression used to select a subset of records. For more information on SQL syntax, see SQL reference for query expressions used in ArcGIS. (Значение по умолчанию — None) | String |
time_filter | The time instant or the time extent to query. The time filter can only be applied to hosted feature layers, and the layer must be time-enabled. A time instant should be formatted as a string, for example, "1199145600000" ((1 Jan 2008 00:00:00 GMT). A time extent should be a comma-delimited string, for example: "1199145600000, 1230768000000" (1 Jan 2008 00:00:00 GMT to 1 Jan 2009 00:00:00 GMT). A null value specified for the start time or the end time will represent infinity for the start or the end time, respectively, for example: "null, 1230768000000". (Значение по умолчанию — None) | String |
renderer | The output FeatureSet symbology can be set using a string, or dictionary representation of either a JSON renderer or a JSON definition object. Learn more about JSON renderers and JSON definition objects. (Значение по умолчанию — None) | String |
is_renderer | Specifies the type of the value used with the renderer argument. Set to True if the value is a renderer object, and False if the value is a definition. (Значение по умолчанию — None) | Boolean |
Дополнительные аргументы могут быть только позиционными, передать их по именованным аргументам нельзя. Например, если целью является только указание символов, то дополнительные аргументы where_clause и time_filter нужно пропустить с помощью None.
save (table_path)
| Параметр | Описание | Тип данных |
table_path | Создаваемая выходная таблица. | String |
Пример кода
Загрузить данные в класс пространственных объектов и вставить в FeatureSet.
import arcpy
arcpy.env.overwriteOutput = True
arcpy.ImportToolbox("http://flame7/arcgis/services;BufferByVal",
"servertools")
# List of coordinates
coordinates = [[-117.196717216, 34.046944853],
[-117.186226483, 34.046498438],
[-117.179530271, 34.038016569],
[-117.187454122, 34.039132605],
[-117.177744614, 34.056765964],
[-117.156205131, 34.064466609],
[-117.145491191, 34.068261129],
[-117.170825195, 34.073618099],
[-117.186784501, 34.068149525],
[-117.158325598, 34.03489167]]
# Create an in_memory feature class to initially contain the coordinate pairs
feature_class = arcpy.CreateFeatureclass_management(
"in_memory", "tempfc", "POINT")[0]
# Open an insert cursor
with arcpy.da.InsertCursor(feature_class, ["SHAPE@XY"]) as cursor:
# Iterate through list of coordinates and add to cursor
for (x, y) in coordinates:
cursor.insertRow([(x, y)])
# Create a FeatureSet object and load in_memory feature class
feature_set = arcpy.FeatureSet()
feature_set.load(feature_class)
results = arcpy.BufferPoints_servertools(feature_set)Загрузите подмножество данных из ArcGIS Living Atlas of the World в FeatureSet и задайте символы.
import arcpy
# Set data
in_data = "https://services.arcgis.com/P3ePLMYs2RVChkJx/arcgis/rest/services/USA_States_Generalized/FeatureServer/0"
query = "STATE_NAME = 'California'"
renderer = '''{
"renderer": {
"type": "simple",
"symbol": {
"type": "esriSFS",
"style": "esriSFSSolid",
"color": [
255,
0,
0,
255
],
"outline": {
"type": "esriSLS",
"style": "esriSLSSolid",
"color": [
110,
110,
110,
255
],
"width": 2
}
},
"label": "",
"description": "",
"rotationType": "geographic",
"rotationExpression": ""
}
}'''
# Create empty FeatureSet
feature_set = arcpy.FeatureSet()
# Load data into FeatureSet with query
feature_set.load(in_data, query, None, renderer, True)Создаёт FeatureSet из строки JSON Esri.
import arcpy
# Set data
data_json = '''{
"objectIdFieldName": "objectid",
"globalIdFieldName": "globalid",
"geometryType": "esriGeometryPoint",
"spatialReference": {
"wkid": 102100,
"latestWkid": 3857
},
"fields": [
{
"name": "objectid",
"alias": "OBJECTID",
"type": "esriFieldTypeOID"
},
{
"name": "requestid",
"alias": "Service Request ID",
"type": "esriFieldTypeString",
"length": 25
},
{
"name": "requesttype",
"alias": "Problem",
"type": "esriFieldTypeString",
"length": 100
},
{
"name": "comments",
"alias": "Comments",
"type": "esriFieldTypeString",
"length": 255
}
],
"features": [
{
"geometry": {
"x": -9809161.170230601,
"y": 5123045.5266209831
},
"attributes": {
"objectid": 246362,
"requestid": "1",
"requesttype": "Sidewalk Damage",
"comments": "Pothole"
}
},
{
"geometry": {
"x": -9074857.9234435894,
"y": 4982391.2604217697
},
"attributes": {
"objectid": 246382,
"requestid": "2",
"requesttype": "Pothole",
"comments": "Jhh"
}
}
]
}'''
# Create FeatureSet from Esri JSON
feature_set = arcpy.FeatureSet(data_json)