Add working with arcgis_geometry

[kgalliher]

Add a guide that demonstrates what the arcgis_geometry package is and how to use it. This will help differentiate between the arcgis.geometry usage and the Rust backed package.

---

Checklist

Please go through each entry in the below checklist and mark an 'X' if that condition has been met. Every entry should be marked with an 'X' to be get the Pull Request approved.

• All imports are in the first cell?
  • First block of imports are standard libraries
  • Second block are 3rd party libraries
  • Third block are all arcgis imports? Note that in some cases, for samples, it is a good idea to keep the imports next to where they are used, particularly for uncommonly used features that we want to highlight.
• All GIS object instantiations are one of the following?
  • gis = GIS()
  • gis = GIS('home') or gis = GIS('pro')
  • gis = GIS(profile="your_online_portal")
  • gis = GIS(profile="your_enterprise_portal")
• If this notebook requires setup or teardown, did you add the appropriate code to ./misc/setup.py and/or ./misc/teardown.py?
• If this notebook references any portal items that need to be staged on AGOL/Python API playground, did you coordinate with a Python API team member to stage the item the correct way with the api_data_owner user?
• If the notebook requires working with local data (such as CSV, FGDB, SHP, Raster files), upload the files as items to the Geosaurus Online Org using api_data_owner account and change the notebook to first download and unpack the files.
• Code simplified & split out across multiple cells, useful comments?
• Consistent voice/tense/narrative style? Thoroughly checked for typos?
• All images used like <img src="base64str_here"> instead of <img src="https://some.url">? All map widgets contain a static image preview? (Call mapview_inst.take_screenshot() to do so)
• All file paths are constructed in an OS-agnostic fashion with os.path.join()? (Instead of r"\foo\bar", os.path.join(os.path.sep, "foo", "bar"), etc.)
• Is your code formatted using Jupyter Black? You can use Jupyter Black to format your code in the notebook.
• If this notebook showcases deep learning capabilities, please go through the following checklist:
  • Are the inputs required for Export Training Data Using Deep Learning tool published on geosaurus org (api data owner account) and added in the notebook using gis.content.get function?
  • Is training data zipped and published as Image Collection? Note: Whole folder is zipped with name same as the notebook name.
  • Are the inputs required for model inferencing published on geosaurus org (api data owner account) and added in the notebook using gis.content.get function? Note: This includes providing test raster and trained model.
  • Are the inferenced results displayed using a webmap widget?
• IF YOU WANT THIS SAMPLE TO BE DISPLAYED ON THE DEVELOPERS.ARCGIS.COM WEBSITE, ping @jyaistMap so he can add it to the list for the next deploy.

[review-notebook-app]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[review-notebook-app]

View / edit / reply to this conversation on ReviewNB

jyaistMap commented on 2026-09-29T00:09:43Z
----------------------------------------------------------------

I think the first couple sentences need to announce this as a new library. We've not documented this at all in the past or had any kind of beta release. So I don't believe the community will have heard of it:

The Python API 2.4.4 release introduces the arcgis_geometry library, a platform-independent Python package for geometry representations and operations, powered by high-performance Rust core libraries. The arcgis_geometry package delivers a unified, faster geometry API across the ArcGIS ecosystem.

The arcgis_geometry library is now included as the premier geometry engine rather than relying on 3rd party libraries such as Shapely or PySHP and without needing an arcpy license. Working with geometries is ready to go out of the box. The arcgis.geometry module still ships with the Python API 2.4.4 release, so you can still use your code as written in previous releases. but it will note utilize the Rust core libraries with thier attending performance improvements.

kgalliher commented on 2026-09-29T14:44:59Z
----------------------------------------------------------------

Moved this into an alert div at the top.

[review-notebook-app]

View / edit / reply to this conversation on ReviewNB

jyaistMap commented on 2026-09-29T00:09:43Z
----------------------------------------------------------------

Neither of the notes are displaying in a local build of the Developer Website as appearing separate from the rest of the text when submitting them as _html_. I submitted #2555 that uses the markdown note format so they display like this:

I'm confused by the second note in the context of the third sentence: The note says "When using Jupyter/ArcGIS Notebooks interface..." - to me the phrase ArcGIS Notebooks encompasses Pro, Enterprise (configure with Notebook Server), and/or ArcGIS Online interfaces. Each of these environments has arcpy in them and the instruction is to just call it in a cell and it'll display as an SVG graphic. But then the last sentence states "If you are running this guide in an environment with arcpy,then to visualize the geometries as SVG graphics...". does this last sentence mean to say "If you are running this guide in an environment without arcpy...."

kgalliher commented on 2026-09-29T14:45:47Z
----------------------------------------------------------------

Replaced this note with the introduction. I'm not sure what the whole OOP note is trying to do. I removed it here as it is also in part 3.

[jyaistMap]

• I submitted #2555. See note as to why. Let me know if you're cool with that. Had a couple questions, too.

[kgalliher]

Moved this into an alert div at the top.

---

View entire conversation on ReviewNB

[kgalliher]

Replaced this note with the introduction. I'm not sure what the whole OOP note is trying to do. I removed it here as it is also in part 3.

---

View entire conversation on ReviewNB

[review-notebook-app]

View / edit / reply to this conversation on ReviewNB

jyaistMap commented on 2026-09-29T16:22:31Z
----------------------------------------------------------------

This is rendering strangely in a local build. It looks like images are missing:

"