Generate Service From Oriented Imagery Dataset (Oriented Imagery)

Summary

Generates a hosted feature service with an oriented imagery layer from an input oriented imagery dataset.

Usage

  • The tool allows you to customize settings when publishing an oriented imagery dataset as an oriented imagery layer to ArcGIS Online or an ArcGIS Enterprise portal. Oriented imagery layers cannot be created in ArcGIS Enterprise portals earlier than 11.2. This tool is an alternative to the standard ArcGIS AllSource sharing workflow that includes oriented imagery-specific options.

  • This tool can be used to publish local image files as feature attachments to the oriented imagery layer. This allows you to store the images as part of the oriented imagery feature service, and control access to the images using layer permissions.

  • The oriented imagery viewer supports services with TIFF and JPG image formats as attachments. The maximum file size that can be uploaded is 2 GB.

Parameters

LabelExplanationData Type
Input Oriented Imagery Dataset

The input oriented imagery dataset from which the hosted feature service will be created.

Oriented Imagery Layer
Output Service Name

The name of the output feature service that will be created.

String
Portal Folder
(Optional)

The folder in the ArcGIS Online or ArcGIS Enterprise portal where the service will be added.

String
Share With
(Optional)

Specifies the sharing level of the output service item.

  • PrivateOnly the owner of the item will have access. This is the default.
  • OrganizationAll members of your organization will have access
  • PublicPeople outside your organization will have access
String
Add footprint layer to the service

Specifies whether the footprint layer will be added to the output service.

  • Checked—The feature class defined in the Footprint Item property of the dataset will be added to the service as a sublayer. This is the default
  • Unchecked—The footprint layer will not be added to the service.
Boolean
Add images as attachments
(Optional)

Specifies whether images will be added as attachments to the output service. Images can only be added as attachments when the images are on local disk or network storage.

  • Checked—The images referenced in the ImagePath field of the oriented imagery dataset will be added to the service as attachments.
  • Unchecked—The images will not be added to the service as attachments. This is the default.
Boolean
Tags
(Optional)

The service item tags separated by commas.

String
Summary
(Optional)

A summary of the service item

String

Derived Output

LabelExplanationData Type
Output Service Item

The path to the output feature service item.

String

arcpy.management.GenerateServiceFromOrientedImageryDataset(in_oriented_imagery_dataset, service_name, {portal_folder}, {share_with}, add_footprint, {attach_images}, {tags}, {summary})
NameExplanationData Type
in_oriented_imagery_dataset

The input oriented imagery dataset from which the hosted feature service will be created.

Oriented Imagery Layer
service_name

The name of the output feature service that will be created.

String
portal_folder
(Optional)

The folder in the ArcGIS Online or ArcGIS Enterprise portal where the service will be added.

String
share_with
(Optional)

Specifies the sharing level of the output service item.

  • PRIVATEOnly the owner of the item will have access. This is the default.
  • ORGANIZATIONAll members of your organization will have access
  • PUBLICPeople outside your organization will have access
String
add_footprint

Specifies whether the footprint layer will be added to the output service.

  • FOOTPRINTThe feature class defined in the Footprint Item property of the dataset will be added to the service as a sublayer. This is the default.
  • NO_FOOTPRINTThe footprint layer will not be added to the service.
Boolean
attach_images
(Optional)

Specifies whether images will be added as attachments to the output service. Images can only be added as attachments when the images are on local disk or network storage.

  • ATTACHThe images referenced in the ImagePath field of the oriented imagery dataset will be added to the service as attachments.
  • NO_ATTACHThe images will not be added to the service as attachments. This is the default.
Boolean
tags
(Optional)

The service item tags separated by commas.

String
summary
(Optional)

A summary of the service item

String

Derived Output

NameExplanationData Type
out_service_item

The path to the output feature service item.

String

Code sample

GenerateServiceFromOrientedImageryDataset example 1 (Python window)

The following Python window script demonstrates how to use the GenerateServiceFromOrientedImageryDataset function in immediate mode.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.oi.GenerateServiceFromOrientedImageryDataset(
    "C:/OrientedImageryExample/MyOI.gdb/MyOrientedImageryDataset", 
    service_name="oi_service",
    portal_folder="Test",
    share_with="PRIVATE",
    add_footprint="FOOTPRINT",
    attach_images="ATTACH")

Environments

This tool does not use any geoprocessing environments.