Learn how to overlay, merge, join, and dissolve features in feature data with the Map Viewer, ArcGIS APIs, and the spatial analysis service .
Average home value by census block in San Francisco.
Combine analyses allow you to merge, overlay, and join multiple sources of feature data to create new feature data . In most cases, the input feature collections or layers need to contain the same type of geometry.
In this tutorial, you use the Dissovle boundaries , Overlay layers , or Join features operations to find a range of average home values within San Francisco. You can perform the combine analyses either in Map Viewer or programmatically using the ArcGIS Python, ArcGIS REST JS, and ArcGIS REST APIs.
The analyses include:
Creating a feature layer containing census blocks for San Francisco. Appending (joining) housing information to the census block feature layer. Creating a new feature layer of census blocks with neighborhood information. Styling the feature data based on average home value. Performing spatial analyses results in service transaction fees. Completing all of the analyses in this tutorial will cost approximately $2.40 or 24 credits.
Learn more about transaction fees in the FAQ .
Prerequisites Copy the web map The tutorial web map contains predefined layers to use as the starting point for the analyses outlined in the steps below.
Go to the Combine data tutorial web map and click Sign in .
Verify that you have the following layers by toggling the visibility on and off:
San Francisco Neighborhoods San Francisco Housing Data Click Save > Save As > Save Map to save a copy.
Create a city boundary layer When performing an analysis, it is often useful to have a study area layer that you can use to clip features from other layers. Use the Dissolve Boundaries operation on the San Francisco Neighborhoods
Steps to use the Map Viewer Steps to use ArcGIS Python, REST JS, and REST APIs In the top bar , click Analysis > Manage Data > Dissolve Boundaries .
Set the following parameters:
1. Choose an area layer whose boundaries will be dissolved : SF Neighborhoods . 2. Choose dissolve method : Areas that overlap or are adjacent . Set the Result layer name to: San Francisco Boundary.
Click Show credits . The analysis will consume USD $0.0092 (.092 credits).
Click Run Analysis .
Implement user authentication to access the spatial analysis service. Define the parameters of the request. Execute the operation. Note : This is a long transaction managed with a job request. Handle the results. APIs ArcGIS API for Python ArcGIS API for Python ArcGIS REST JS
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
from arcgis import GIS
from arcgis.features.analysis import dissolve_boundaries
portal = GIS(username= "<USERNAME>" , password= "<PASSWORD>" )
neighborhoods = "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/SF_Neighborhoods/FeatureServer/0"
results = dissolve_boundaries(
input_layer=neighborhoods,
multi_part_features= True ,
# output_name="<OUTPUT NAME>" if you want to save the results as a hosted feature layer.
)
result_features = results.query()
print ( f"The resulting layer contains { len (result_features.features)} new records" )
# show results in notebook with the map widget
map_widget = portal. map ( "San Francisco, CA" )
map_widget.add_layer(result_features)
map_widget
Service requests 1. Get the analysis service URL 2. Submit job 3. Check job status 4. Get results
Request HTTP HTTP cURL
Use dark colors for code blocks Copy
1
2
3
4
5
POST arcgis.com/sharing/rest/portals/self HTTP/1.1
Content-Type : application/x-www-form-urlencoded
&f=json
&token= < ACCESS_TOKEN >
Response (JSON)
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
{
"helperServices" : {
// Other parameters
"analysis" : {
"url" : "https://<YOUR_ANALYSIS_SERVICE>/arcgis/rest/services/tasks/GPServer"
},
"geoenrichment" : {
"url" : "https://geoenrich.arcgis.com/arcgis/rest/services/World/GeoenrichmentServer"
}
}
}
Request HTTP HTTP cURL
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
POST <YOUR_ANALYSIS_SERVICE>/arcgis/rest/services/tasks/GPServer/DissolveBoundaries/submitJob HTTP/1.1
Content-Type : application/x-www-form-urlencoded
f=json
&token=<ACCESS_TOKEN>
&inputLayer={ "url" : "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/SF_Neighborhoods/FeatureServer/0" }
&multiPartFeatures= true
&outputName={ "serviceProperties" :{ "name" : "San Francisco Boundary" }}
Response (JSON)
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
{
"jobId" : "<JOB_ID>" ,
"jobStatus" : "esriJobSubmitted" ,
"results" : {},
"inputs" : {},
"messages" : []
}
Request HTTP HTTP cURL
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
POST <YOUR_ANALYSIS_SERVICE> /arcgis/ rest /services/ tasks /GPServer/ DissolveBoundaries /jobs/ <JOB_ID> HTTP/ 1.1
Content-Type: application/x-www-form-urlencoded
f=json
&token=<ACCESS_TOKEN>
Response (JSON)
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
// Executing job
{
"jobId" : "<JOB_ID>" ,
"jobStatus" : "esriJobExecuting" ,
"results" : {},
"inputs" : {},
"messages" : []
}
// Job succeeded
{
"jobId" : "<JOB_ID>" ,
"jobStatus" : "esriJobSucceeded" ,
"results" : {
"dissolvedLayer" : {
"paramUrl" : "results/dissolvedLayer"
}
},
"inputs" : {},
"messages" : []
}
Request HTTP HTTP cURL
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
POST <YOUR_ANALYSIS_SERVICE> /arcgis/ rest /services/ tasks /GPServer/ DissolveBoundaries /jobs/ <JOB_ID> /results/ dissolvedLayer HTTP/ 1.1
Content-Type: application/x-www-form-urlencoded
f=json
&token=<ACCESS_TOKEN>
Response (JSON)
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
{
"paramName" : "dissolvedLayer" ,
"dataType" : "GPString" ,
"value" : {
"url" : "<SERVICE_URL>" ,
"itemId" : "<ITEM_ID>"
}
}
The resulting layer is a boundary of the city without any neighborhood attributes.
Get the census blocks feature layer Census blocks are statistical areas bounded by roads, property lines, and can correspond to city blocks. The blocks will provide a more detailed view of the distribution of home values in San Francisco. Retrieve the U.S. Census Blocks feature layer from Living Atlas to use in the tutorial.
Steps to use the Map Viewer Steps to use ArcGIS Python, REST JS, and REST APIs In the top bar , click Add > Browse Living Atlas Layers and type the following: U.S. Census Blocks, published by Esri_US_Federal_Data.
Select the layer > Add to Map .
Click on the features to display a popup and familiarize yourself with its attributes.
For each block , you should see the block number and its area for both land and water in square meters.
Implement user authentication to access the spatial analysis service. Define the parameters of the request. Execute the operation. Note : This is a long transaction managed with a job request. Handle the results. APIs ArcGIS API for Python ArcGIS API for Python ArcGIS REST JS
Expand
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
from arcgis.gis import GIS
portal = GIS()
item = gis.content.get( "d795eaa6ee7a40bdb2efeb2d001bf823" )
print (item)
Service request Request HTTP HTTP cURL
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
GET https://www.arcgis.com/sharing/rest/content/items/d795eaa6ee7a40bdb2efeb2d001bf823?f=pjson HTTP/ 1.1
Response (JSON)
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
{
"id" : "d795eaa6ee7a40bdb2efeb2d001bf823" ,
"owner" : "Esri_US_Federal_Data" ,
"orgId" : "FiaPA4ga0iQKduv3" ,
"created" : 1624991014000 ,
"modified" : 1648737887000 ,
"guid" : null ,
"name" : "US_Census_Blocks_v1" ,
"title" : "U.S. Census Blocks" ,
"type" : "Feature Service" ,
"typeKeywords" : [
"ArcGIS Server" ,
"Data" ,
"Feature Access" ,
"Feature Service" ,
"Service" ,
"Singlelayer" ,
"Hosted Service" ,
"View Service"
],
}
Find census blocks within the city boundary The U.S. Census Blocks hosted layer contains over eight million features. To limit these features to only those within San Francisco, use the Overlay layers operation.
The analysis creates new feature data based upon the input layer (from which you wish to extract features), the overlay layer (defining the area to extract), and a specified overlay operation : intersect, union, or erase. For this overlay analysis, you use the intersect method.
Union overlay method It is possible to use the union method to combine census blocks with the boundary layer. With this method, the resulting layer contains all features from both layers. For instance, all census blocks both within and outside of the boundary layer. The union method is only applicable with feature layers that contain polygons.
Steps to use the Map Viewer Steps to use ArcGIS Python, REST JS, and REST APIs In the top bar , click Analysis > Manage Data > Overlay layers .
Set the following parameters:
Choose input layer : U.S. Census Blocks . Choose overlay layer : San Francisco Boundary . Choose overlay method : Intersect .Output : Areas . Result layer name : Census blocks in San Francisco. Check Use current map extent .
Click Show credits . The analysis will consume approximately USD $.7 (7 credits).
Click Run Analysis .
Implement user authentication to access the spatial analysis service. Define the parameters of the request. Execute the operation. Note : This is a long transaction managed with a job request. Handle the results. APIs ArcGIS API for Python ArcGIS API for Python ArcGIS REST JS
Expand
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
from arcgis import GIS
from arcgis.features.analysis import overlay_layers
portal = GIS(username= "<USERNAME>" , password= "<PASSWORD>" )
census_blocks = "https://services2.arcgis.com/FiaPA4ga0iQKduv3/arcgis/rest/services/US_Census_Blocks_v1/FeatureServer/0"
neighborhoods = "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/SF_Neighborhoods/FeatureServer/0"
process_extent = {
"extent" : {
"xmin" : - 13644958.135312138 ,
"ymin" : 4535593.984072592 ,
"xmax" : - 13611765.355779344 ,
"ymax" : 4556652.38536513 ,
"spatialReference" : { "wkid" : 102100 , "latestWkid" : 3857 },
},
}
results = overlay_layers(
input_layer=census_blocks,
overlay_layer=neighborhoods,
overlay_type= "intersect" ,
output_type= "Input" ,
context=process_extent,
# output_name="<OUTPUT NAME>" if you want to save the results as a hosted feature layer.
)
result_features = results.query()
print (
f"The overlay result layer contains { len (result_features.features)} new records"
)
# show results in map widget
map_widget = portal. map ( "San Francisco, CA" )
map_widget.add_layer(result_features)
map_widget
Service requests 1. Get the analysis service URL 2. Submit job 3. Check job status 4. Get results
Request HTTP HTTP cURL
Use dark colors for code blocks Copy
1
2
3
4
5
POST arcgis.com/sharing/rest/portals/self HTTP/1.1
Content-Type : application/x-www-form-urlencoded
&f=json
&token= < ACCESS_TOKEN >
Response (JSON)
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
{
"helperServices" : {
// Other parameters
"analysis" : {
"url" : "https://<YOUR_ANALYSIS_SERVICE>/arcgis/rest/services/tasks/GPServer"
},
"geoenrichment" : {
"url" : "https://geoenrich.arcgis.com/arcgis/rest/services/World/GeoenrichmentServer"
}
}
}
Request HTTP HTTP cURL
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
POST <YOUR_ANALYSIS_SERVICE>/arcgis/rest/services/tasks/GPServer/OverlayLayers/submitJob HTTP/ 1.1
Content- Type : application/x-www-form-urlencoded
f=json
&token=<ACCESS_TOKEN>
&inputLayer={ "url" : "https://services2.arcgis.com/FiaPA4ga0iQKduv3/arcgis/rest/services/US_Census_Blocks_v1/FeatureServer/0" }
&overlayLayer={ "url" : "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/SF_Neighborhoods/FeatureServer/0" }
&overlayType=intersect
&outputType=Input
&context={ "extent" :{ "xmin" :- 13645221.01621096 , "ymin" : 4536093.156176513 , "xmax" :- 13611302.08490946 , "ymax" : 4557036.901926624 , "spatialReference" :{ "wkid" : 102100 , "latestWkid" : 3857 }}}
&outputName={ "serviceProperties" :{ "name" : "Census blocks in San Francisco " }}
Response (JSON)
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
{
"jobId" : "<JOB_ID>" ,
"jobStatus" : "esriJobSubmitted" ,
"results" : {},
"inputs" : {},
"messages" : []
}
Request HTTP HTTP cURL
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
POST <YOUR_ANALYSIS_SERVICE> /arcgis/ rest /services/ tasks /GPServer/ FindExistingLocations /jobs/ <JOB_ID> HTTP/ 1.1
Content-Type: application/x-www-form-urlencoded
f=json
&token=<ACCESS_TOKEN>
Response (JSON)
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
{
"jobId" : "<JOB_ID>" ,
"jobStatus" : "esriJobSubmitted" ,
"results" : {},
"inputs" : {},
"messages" : []
}
// Executing job
{
"jobId" : "<JOB_ID>" ,
"jobStatus" : "esriJobExecuting" ,
"results" : {},
"inputs" : {},
"messages" : []
}
// Job succeeded
{
"jobId" : "<JOB_ID>" ,
"jobStatus" : "esriJobSucceeded" ,
"results" : {
"outputLayer" : {
"paramUrl" : "results/outputLayer"
}
},
"inputs" : {},
"messages" : []
}
Request HTTP HTTP cURL
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
POST <YOUR_ANALYSIS_SERVICE> /arcgis/ rest /services/ tasks /GPServer/ FindExistingLocations /jobs/ <Job_ID> /results/ resultLayer?= null HTTP/ 1.1
Content-Type: application/x-www-form-urlencoded
f=json
&token=<ACCESS_TOKEN>
&returnType=data
Response (JSON)
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
{
"paramName" : "outputLayer" ,
"dataType" : "GPString" ,
"value" : {
"url" : "<SERVICE_URL>" ,
"itemId" : "<ITEM_ID>"
}
}
The overlay analysis returns feature data containing the census blocks within the boundary of San Francisco you created.
Join housing attributes to census blocks The census blocks do not contain any attributes with home value data in San Francisco. However, the San Francisco Housing hosted feature layer does. To add housing attributes to the Census blocks within San Francisco hosted feature layer, use the Join Features operation. The operation joins the attributes from the layers based on their spatial relationship.
Steps to use the Map Viewer Steps to use ArcGIS Python, REST JS, and REST APIs In the top bar , click Analysis > Summarize Data > Join Features .
Set the following parameters:
Choose target layer : Census blocks within San Francisco . Choose layer to join to target layer : San Francisco Housing . Click Choose a spatial relationship .
Select Intersects from the dropdown.
Select Join one to one .
Set the Result layer name to: Census blocks with data.
In the top bar , click Bookmarks > and choose Study Area to set map extent.
Check 'Use current map extent`.
Click Show credits . The analysis will consume approximately USD $.11 (11 credits).
Click Run Analysis .
Implement user authentication to access the spatial analysis service. Define the parameters of the request. Execute the operation. Note : This is a long transaction managed with a job request. Handle the results. APIs ArcGIS API for Python ArcGIS API for Python ArcGIS REST JS
Expand
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
from arcgis import GIS
from arcgis.features.analysis import join_features
portal = GIS(username= "<USERNAME>" , password= "<PASSWORD>" )
census_blocks = "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Census_blocks_within_San_Francisco/FeatureServer/0"
housing_data = "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/San_Francisco_Housing_Data/FeatureServer/0"
results = join_features(
target_layer=census_blocks,
join_layer=housing_data,
join_operation= "joinOneToOne" ,
spatial_relationship= "intersects" ,
join_type= "inner"
# output_name="<OUTPUT NAME>" if you want to save the results as a hosted feature layer.
)
result_features = results.query()
print (
f"The join features result layer contains { len (result_features.features)} new records"
)
# show results in notebook with the map widget
map_widget = portal. map ( "San Francisco, CA" )
map_widget.add_layer(result_features)
map_widget
Service requests 1. Get the analysis service URL 2. Submit job 3. Check job status 4. Get results
Request HTTP HTTP cURL
Use dark colors for code blocks Copy
1
2
3
4
5
POST arcgis.com/sharing/rest/portals/self HTTP/1.1
Content-Type : application/x-www-form-urlencoded
&f=json
&token= < ACCESS_TOKEN >
Response (JSON)
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
{
"helperServices" : {
// Other parameters
"analysis" : {
"url" : "https://<YOUR_ANALYSIS_SERVICE>/arcgis/rest/services/tasks/GPServer"
},
"geoenrichment" : {
"url" : "https://geoenrich.arcgis.com/arcgis/rest/services/World/GeoenrichmentServer"
}
}
}
Request HTTP HTTP cURL
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
POST <YOUR_ANALYSIS_SERVICE>/arcgis/rest/services/tasks/GPServer/JoinFeatures/submitJob HTTP/ 1.1
Content- Type : application/x-www-form-urlencoded
f=json
&token=<ACCESS_TOKEN>
&targetLayer={ "url" : "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Census_blocks_within_San_Francisco/FeatureServer/0" }
&joinLayer={ "url" : "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/San_Francisco_Housing_Data/FeatureServer/0" , "name" : "San Francisco Housing" }
&joinOperation=joinOneToOne
&spatialRelationship=intersects
&joinType=inner
&outputName={ "serviceProperties" :{ "name" : "Census blocks with housing data" }}'
Response (JSON)
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
{
"jobId" : "<JOB_ID>" ,
"jobStatus" : "esriJobSubmitted" ,
"results" : {},
"inputs" : {},
"messages" : []
}
Request HTTP HTTP cURL
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
POST <YOUR_ANALYSIS_SERVICE> /arcgis/ rest /services/ tasks /GPServer/ FindExistingLocations /jobs/ <JOB_ID> HTTP/ 1.1
Content-Type: application/x-www-form-urlencoded
f=json
&token=<ACCESS_TOKEN>
Response (JSON)
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
{
"jobId" : "<JOB_ID>" ,
"jobStatus" : "esriJobSubmitted" ,
"results" : {},
"inputs" : {},
"messages" : []
}
// Executing job
{
"jobId" : "<JOB_ID>" ,
"jobStatus" : "esriJobExecuting" ,
"results" : {},
"inputs" : {},
"messages" : []
}
// Job succeeded
{
"jobId" : "<JOB_ID>" ,
"jobStatus" : "esriJobSucceeded" ,
"results" : {
"outputLayer" : {
"paramUrl" : "results/outputLayer"
}
},
"inputs" : {},
"messages" : []
}
Request HTTP HTTP cURL
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
POST <YOUR_ANALYSIS_SERVICE> /arcgis/ rest /services/ tasks /GPServer/ FindExistingLocations /jobs/ <Job_ID> /results/ resultLayer?= null HTTP/ 1.1
Content-Type: application/x-www-form-urlencoded
f=json
&token=<ACCESS_TOKEN>
&returnType=data
Response (JSON)
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
{
"paramName" : "outputLayer" ,
"dataType" : "GPString" ,
"value" : {
"url" : "<SERVICE_URL>" ,
"itemId" : "<ITEM_ID>"
}
}
The resulting layer contains demographic information for each block, including the average home value.
Add neighborhood names Steps to use the Map Viewer Steps to use ArcGIS Python, REST JS, and REST APIs Find census blocks within neighborhoods The Census blocks with data feature layer contains all census blocks within the San Francisco boundary along with relevant housing attributes. But, the features within the layer do not contain the neighborhood name corresponding to each census block. Use the Overlay layers operation to create new feature data that contain housing and neighborhood attributes.
In the top bar , click Analysis > Manage Data > Overlay layers .
Set the following parameters:
Choose input layer : San Francisco Neighborhoods . Choose overlay layer : Census blocks with data . Choose overlay method : Intersect .Output : Areas . Result layer name : Census blocks with neighborhood names. Click Show credits . The analysis will consume approximately USD $0.6 (6 credits).
Click Run Analysis .
Click on a feature to see the neighborhood associated with each census block.
Style the layer The Census blocks within neighborhoods
In Content , select Census blocks with neighborhood names > Change Style .
Choose Average home value
Select Counts and Amounts (Color) > Options .
Check Classify Data > Manual Break with 5 classes. The Manual Break setting allows you to exclude homes with a value of 0 (outliers) when styling the map.
Click on the scale to set the class breaks based on value. For example, set the lowest value to 200,000 and the highest value to 2,250,000.
Click Symbols to select a yellow to red color ramp. Click Ok when done.
Click OK > Done to set the class breaks and styling.
In the top bar click Save to save your web map.
Find census blocks within neighborhoods Implement user authentication to access the spatial analysis service. Define the parameters of the request. Execute the operation. Note : This is a long transaction managed with a job request. Handle the results. APIs ArcGIS API for Python ArcGIS API for Python ArcGIS REST JS
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
from arcgis import GIS
from arcgis.features.analysis import overlay_layers
portal = GIS(username= "<USERNAME>" , password= "<PASSWORD>" )
census_blocks = "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Census_blocks_with_data/FeatureServer/0"
neighborhoods = "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/SF_Neighborhoods/FeatureServer/0"
results = overlay_layers(
input_layer=census_blocks,
overlay_layer=neighborhoods,
overlay_type= "intersect" ,
output_type= "Input" ,
)
result_features = results.query()
print (
f"The overlay result layer contains { len (result_features.features)} new records"
)
# show results in map widget
map_widget = portal. map ( "San Francisco, CA" )
map_widget.add_layer(result_features)
map_widget
Service requests 1. Get the analysis service URL 2. Submit job 3. Check job status 4. Get results
Request HTTP HTTP cURL
Use dark colors for code blocks Copy
1
2
3
4
5
POST arcgis.com/sharing/rest/portals/self HTTP/1.1
Content-Type : application/x-www-form-urlencoded
&f=json
&token= < ACCESS_TOKEN >
Response (JSON)
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
{
"helperServices" : {
// Other parameters
"analysis" : {
"url" : "https://<YOUR_ANALYSIS_SERVICE>/arcgis/rest/services/tasks/GPServer"
},
"geoenrichment" : {
"url" : "https://geoenrich.arcgis.com/arcgis/rest/services/World/GeoenrichmentServer"
}
}
}
Request HTTP HTTP cURL
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
POST <YOUR_ANALYSIS_SERVICE>/arcgis/rest/services/tasks/GPServer/OverlayLayers/submitJob HTTP/ 1.1
Content- Type : application/x-www-form-urlencoded
f=json
&token=<ACCESS_TOKEN>
&inputLayer={ "url" : "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Census_blocks_with_data/FeatureServer/0" }
&overlayLayer={ "url" : "https://services3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/SF_Neighborhoods/FeatureServer/0" }
&overlayType=intersect
&outputType=Input
&context={}
&outputName={ "serviceProperties" :{ "name" : "Census blocks with neighborhood names" }}
Response (JSON)
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
{
"jobId" : "<JOB_ID>" ,
"jobStatus" : "esriJobSubmitted" ,
"results" : {},
"inputs" : {},
"messages" : []
}
Request HTTP HTTP cURL
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
POST <YOUR_ANALYSIS_SERVICE> /arcgis/ rest /services/ tasks /GPServer/ FindExistingLocations /jobs/ <JOB_ID> HTTP/ 1.1
Content-Type: application/x-www-form-urlencoded
f=json
&token=<ACCESS_TOKEN>
Response (JSON)
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
{
"jobId" : "<JOB_ID>" ,
"jobStatus" : "esriJobSubmitted" ,
"results" : {},
"inputs" : {},
"messages" : []
}
// Executing job
{
"jobId" : "<JOB_ID>" ,
"jobStatus" : "esriJobExecuting" ,
"results" : {},
"inputs" : {},
"messages" : []
}
// Job succeeded
{
"jobId" : "<JOB_ID>" ,
"jobStatus" : "esriJobSucceeded" ,
"results" : {
"outputLayer" : {
"paramUrl" : "results/outputLayer"
}
},
"inputs" : {},
"messages" : []
}
Request HTTP HTTP cURL
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
POST <YOUR_ANALYSIS_SERVICE> /arcgis/ rest /services/ tasks /GPServer/ FindExistingLocations /jobs/ <Job_ID> /results/ resultLayer?= null HTTP/ 1.1
Content-Type: application/x-www-form-urlencoded
f=json
&token=<ACCESS_TOKEN>
&returnType=data
Response (JSON)
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
{
"paramName" : "outputLayer" ,
"dataType" : "GPString" ,
"value" : {
"url" : "<SERVICE_URL>" ,
"itemId" : "<ITEM_ID>"
}
}
Style the layer To learn how to style a feature layer, go to Visualization .
Use dark colors for code blocks Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
{
"renderer" : {
"authoringInfo" : {
"type" : "classedColor"
},
"type" : "classBreaks" ,
"field" : "AVGVAL_CY" ,
"minValue" : 200000 ,
"classBreakInfos" : [
{
The resulting layer should look something like this .
What's next? You performed a series of combine analyses to find the average home value by census block. Your web map should look something like this .
Learn how to use additional tools , APIs , and location services in these tutorials:
