Поделиться через

ArcGIS PaaS

  • Reference

ArcGIS PaaS connects your automated workflows to resources from your ArcGIS organization. Access geoenrichment, geocoding, and routing services to add demographics and location information to your data.

This connector is available in the following products and regions:

Service Class Regions
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Esri Power Automate Support
URL https://community.esri.com/t5/arcgis-for-power-automate-questions/bd-p/arcgis-for-power-automate-questions
Email [email protected]
Connector Metadata
Publisher Esri, Inc.
Website https://www.esri.com/en-us/arcgis/products/arcgis-for-microsoft-365/
Privacy policy https://www.esri.com/en-us/privacy/privacy-statements/privacy-statement
Categories IT Operations; Business Intelligence

The ArcGIS PaaS connector allows you to achieve location intelligence by leveraging the location based services available from the ArcGIS Platform to enhance understanding, insight, and decision-making. It provides the capabilities to geoenrich your business data, spatially enable information from external data sources, and create optimized routes within your Flows.

Documentation

For additional documentation and information please visit Get started with ArcGIS Connectors for Power Automate

Prerequisites

An API key is required to use this connector. Sign up for a ArcGIS Developer account.

How to get an API key

  1. Sign in to https://developers.arcgis.com
  2. Click "API keys"
  3. Click "New API Key" to create a new API key
  4. Provide a title and description for the API key to create one.
  5. Before proceeding, remember to configure services. This will depend on the actions you plan to use in the connector.

WARNING: Services accessed through your API key will incur a charge to your account; you should keep the API key secure. Pricing information can be found here.

Get started with ArcGIS PaaS connector

To use the actions in ArcGIS PaaS connector, the underlying service for the API key needs to be configured with appropriate service. Learn more about configuring service for API key here.

The below table describes the action and the underlying service:

Action Service
Geoenrichment Geoenrichment
Find address candidate Geocoding
Geocode addresses Geocoding
Point to point routing Routing

If the result of a Find address candidate or Geocode addresses action will store the results, configure the Geocoding (stored) service instead.

Limitations

When using the Geocode addresses action, for large datasets the input to the action will need to be batched or chunked into multiple individual requests.

Name Limit
Geocode addresses 150 rows per request
Get data from Feature Layer 1000 rows per request without geometry
Get data from Feature Layer 150 rows per request with geometry
Geometry lookups 1 geometry per request
Point to point routing 150 stops per request

Creating a connection

The connector supports the following authentication types:
Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API Key securestring The API Key for this api True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Convert date and time format

Convert to and from Epoch Unix timestamp and string format.
Create point geometry

Create point geometry object from Longitude (X) and Latitude (Y)
Find address candidate

Locate a single address using a geocode service resource. This resource provides information about candidates, including the address, location, and match score. The result of this operation is a list of address candidates.
Find address candidate [DEPRECATED]

This action has been deprecated. Please use Find address candidate instead.

Locate a single address using a geocode service resource. This resource provides information about candidates, including the address, location, and match score. The result of this operation is a list of address candidates.
Geocode addresses

Find multiple (batch) addresses, place-names, and businesses and then display that information on a map. This data can be added to an existing dataset or you can create a new one. This data can be used to create new maps in all ArcGIS for Microsoft 365 products.
Geocode addresses [DEPRECATED]

This action has been deprecated. Please use Geocode addresses instead.

Find multiple (batch) addresses, place-names, and businesses and then display that information on a map. This data can be added to an existing dataset or you can create a new one. This data can be used to create new maps in all ArcGIS for Microsoft 365 products.
Geoenrichment

Get facts about a location or area. Using the GeoEnrichment service, you can get information about the people, places, and businesses in a specific area or within a certain distance or drive time from a location.
Geoenrichment [DEPRECATED]

This action has been deprecated. Please use Geoenrichment instead.

Get facts about a location or area. Using the GeoEnrichment service, you can get information about the people, places, and businesses in a specific area or within a certain distance or drive time from a location. (deprecated)
Point to point routing

Create point-to-point routes. Points in a route can visited in the order you specify or in the order that minimizes overall travel time or distance. Routes represent the quickest or shortest path along roads to visit stops or point locations.

Convert date and time format

Operation ID:
TimeConversionHelper

Convert to and from Epoch Unix timestamp and string format.

Parameters

Name Key Required Type Description
Date Time
 dateTime True string

Time as Unix epoch in seconds or milliseconds or as a string.

Returns

Name Path Type Description
Date and time in string format
 stringTime string

Date and time in string format
Date and time as a Unix time stamp in seconds
 unixTimeStampSeconds number

Date and time as a Unix time stamp in seconds
Date and time as a Unix time stamp in milliseconds
 unixTimeStampMilliseconds number

Date and time as a Unix time stamp in milliseconds

Create point geometry

Operation ID:
CreatePointGeometryHelper

Create point geometry object from Longitude (X) and Latitude (Y)

Parameters

Name Key Required Type Description
Longitude (X)
 x True number

Longitude (X)
Latitude (Y)
 y True number

Latitude (Y)
Spatial reference system
 srs string

Select spatial reference system

Returns

Name Path Type Description
Geometry
 geometry object

Point geometry object

Find address candidate

Operation ID:
FindAddressCandidate

Locate a single address using a geocode service resource. This resource provides information about candidates, including the address, location, and match score. The result of this operation is a list of address candidates.

Parameters

Name Key Required Type Description
Store results?
 forStorage True boolean

Specifies whether the results of the operation will be persisted.
Address
 address string

Address
Region
 region string

Region
City
 city string

City
ZIP or postal code
 postal string

ZIP or postal code
Country
 country string

Select a country
Match type
 locationType string

Specifies whether to use rooftop or street entrance location for the geometry output
Spatial reference system
 srs string

Select spatial reference system

Returns

Name Path Type Description
Full address
 address string

The locations of your data listed either as single line or multi-line results
Country code
 countryCode string

The country where the locations are based
City
 city string

The city where the locations are based
Longitude (X)
 Geometry.x number

Longitude (X)
Latitude (Y)
 Geometry.y number

Latitude (Y)
Score
 score number

Match score.

Find address candidate [DEPRECATED]

Operation ID:
FindAddressCandidates

This action has been deprecated. Please use Find address candidate instead.

Locate a single address using a geocode service resource. This resource provides information about candidates, including the address, location, and match score. The result of this operation is a list of address candidates.

Parameters

Name Key Required Type Description
Store results?
 forStorage True boolean

Specifies whether the results of the operation will be persisted.
Address
 address string

Address
Region
 region string

Region
City
 city string

City
ZIP or postal code
 postal string

ZIP or postal code
Country
 country string

Select a country
Match type
 locationType string

Specifies whether to use rooftop or street entrance location for the geometry output
Spatial reference system
 srs string

Select spatial reference system

Returns

Name Path Type Description
Full address
 address string

The locations of your data listed either as single line or multi-line results
Country code
 countryCode string

The country where the locations are based
City
 city string

The city where the locations are based
Longitude (X)
 Geometry.x number

Longitude (X)
Latitude (Y)
 Geometry.y number

Latitude (Y)
Score
 score number

Match score.

Geocode addresses

Operation ID:
GeocodeAddressesV2

Find multiple (batch) addresses, place-names, and businesses and then display that information on a map. This data can be added to an existing dataset or you can create a new one. This data can be used to create new maps in all ArcGIS for Microsoft 365 products.

Parameters

Name Key Required Type Description
Addresses
 addresses True string

Array of addresses with well formed fields

Returns

The outputs of this operation are dynamic.

Geocode addresses [DEPRECATED]

Operation ID:
GeocodeAddresses

This action has been deprecated. Please use Geocode addresses instead.

Find multiple (batch) addresses, place-names, and businesses and then display that information on a map. This data can be added to an existing dataset or you can create a new one. This data can be used to create new maps in all ArcGIS for Microsoft 365 products.

Parameters

Name Key Required Type Description
Addresses
 addresses True string

Array of addresses with well formed fields

Returns

Name Path Type Description
Spatial reference ID
 spatialReference.wkid number

Well-known ID
locations
 locations array of object

Array of geocoded locations
Address
 locations.address string

Full address
Address ID
 locations.attributes.ResultID number

This value contains the ID of your geocoding request. Use this value for specifying the item to act on in other actions such as matching Ids in a list.
Longitude (X)
 locations.location.x number
Latitude (Y)
 locations.location.y number

Geoenrichment

Operation ID:
Geoenrich_V2

Get facts about a location or area. Using the GeoEnrichment service, you can get information about the people, places, and businesses in a specific area or within a certain distance or drive time from a location.

Parameters

Name Key Required Type Description
Country
 country True string

Select a country to see available data collections
Data collection
 datacollection True string

Select a data collection
Variable
 parameter True string

Select a variable from the collection
Buffer type
 buffertype True string

Type of buffer around the location
body
 body True dynamic

Returns

Name Path Type Description
Value of the variable
 value number

Geoenrichment variable value
Name of the variable
 parameterName string

The name of the variable that is being analyzed during the geoenrichment process.
Units
 units string

Parameter units

Geoenrichment [DEPRECATED]

Operation ID:
Geoenrich

This action has been deprecated. Please use Geoenrichment instead.

Get facts about a location or area. Using the GeoEnrichment service, you can get information about the people, places, and businesses in a specific area or within a certain distance or drive time from a location. (deprecated)

Parameters

Name Key Required Type Description
Study area
 studyarea True string

Address or geometry
Country
 country True string

Select a country to see available data collections
Data collection
 datacollection True string

Select a data collection
Variable
 parameter True string

Select a variable from the collection
Buffer type
 areatype string

Type of buffer around the location
query
 query dynamic
Spatial reference system
 srs string

Select spatial reference system

Returns

Name Path Type Description
Value of the variable
 value number

Geoenrichment variable value
Name of the variable
 parameterName string

The name of the variable that is being analyzed during the geoenrichment process.
Units
 units string

Parameter units

Point to point routing

Operation ID:
GetRoute

Create point-to-point routes. Points in a route can visited in the order you specify or in the order that minimizes overall travel time or distance. Routes represent the quickest or shortest path along roads to visit stops or point locations.

Parameters

Name Key Required Type Description
Routing stops
 stops True string

Stops as Latitude (Y) and Longitude (X), features, or feature service
Travel mode
 travelModeName string

Choose the mode of transportation for the analysis
Find best route
 findBestSequence boolean

Specify whether the service should reorder stops to find the optimized route
Preserve first stop
 preserveFirstStop boolean

Indicate whether the service should keep the first stop fixed when reordering the stops
Return directions
 returnDirections boolean

Specify whether the service should generate driving directions for each route

Returns

Name Path Type Description
Directions
 Directions array of object
Direction text
 Directions.text string
Name
 Name string

Name of the route
Distance in kilometers
 Kilometers number

Route distance in kilometers
Distance in miles
 Miles number

Route distance in miles
Travel time
 TravelTime number

Estimated travel time in minutes
Route geometry
 Geometry object

Geometry object of the route