Skip to content

Intro to ParquetLayer

This sample uses the ParquetLayer to display a sample parquet file in a Map. The ParquetLayer enables visualization of Parquet files and is a columnar storage format optimized for efficiently handling big data and distributed environments. Its columnar structure, compression capabilities, and schema support make it ideal for analytics and query-heavy workloads.

Creating a ParquetLayer

To create a ParquetLayer, set the urls property to one or more Parquet files that share the same geometry type and column schema. Parquet files must use either GZIP or Snappy compression, or be uncompressed.

The geometry encoding is automatically detected if the file contains Geoparquet metadata. If metadata is not present, the layer attempts to infer geometry from columns latitude and longitude values. If this automatic detection fails, the encoding must be specified manually.

In this example, we load a GZIP-compressed Parquet file containing LONGITUDE and LATITUDE fields for each water well in Kansas. Given the clear definition of these fields, the geometry is automatically detected, and the layer is configured seamlessly.

Use dark colors for code blocksCopy
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
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
      // create a ParquetLayer instance and add it to the map
      // kansas water wells parquet file (gzip compressed and location encoded)
      const layer = new ParquetLayer({
        urls: [
          "https://jsapi.maps.arcgis.com/sharing/rest/content/items/6ab6f959c1684eb5a54db91644a89747/data",
        ],
        title: "Kansas water wells",
        orderBy: [
          {
            field: "DEPTH_OF_COMPLETED_WELL",
            order: "descending",
          },
        ],
        effect: "drop-shadow(2px, 2px, 2px, lightgray)",
        renderer: createClassBreaksRenderer(),
        popupTemplate: {
          title: "Water well info",
          content: [
            {
              type: "fields",
              fieldInfos: [
                {
                  fieldName: "COUNTY",
                  label: "County",
                },
                {
                  fieldName: "LOCATION_DIRECTIONS",
                  label: "Directions to location",
                },
                {
                  fieldName: "STATUS",
                  label: "Status",
                },
                {
                  fieldName: "USE_DESC",
                  label: "Usage description",
                },
                {
                  fieldName: "ESTIMETED_YIELD",
                  label: "Estimated yield",
                },
                {
                  fieldName: "DEPTH_OF_COMPLETED_WELL",
                  label: "Depth of well (ft)",
                },
                {
                  fieldName: "FILE_URL",
                  label: "Well file",
                },
                {
                  fieldName: "KGS_URL",
                  label: "Kansas Geological Survery info",
                },
              ],
            },
          ],
        },
      });

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.