\n",
+ "
\n",
+ "\n",
+ "
\n",
+ "
Esri - Water Resources\n",
+ " \n",
+ "
Esri's Water Resources GIS Platform provides tools and solutions for managing and analyzing water data to improve decision-making across sectors like watershed management, stormwater planning, and natural resource conservation. The platform supports data modeling, monitoring, and collaboration, offering resources like Arc Hydro, Living Atlas water datasets, and a vibrant Hydro Community. By leveraging geospatial technology, users can harness big data, simulate environmental impacts, and facilitate stakeholder engagement, enabling sustainable water resource management.
Document Link by NSGIC_Dev1\n",
+ "
Last Modified: January 06, 2025\n",
+ "
0 comments, 506 views\n",
+ "
\n",
+ "
- "
+ ]
+ },
+ "execution_count": 66,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "document = gis.content.get('c7b4e9240149481ea69af628513962fe')\n",
+ "document"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "22d7dab1-11e3-4172-a0b8-b563d87bea28",
+ "metadata": {},
+ "source": [
+ "We extract the description of this item using the `description` property of the `Item` and pass it as the text input to our method. "
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 67,
+ "id": "b5369419-361c-4d94-a8d6-4f95ff882489",
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "text/plain": [
+ "\"
Esri's Water Resources GIS Platform offers a comprehensive suite of tools and resources designed to modernize water resource management. It emphasizes geospatial solutions for monitoring, analyzing, and modeling water systems, helping decision-makers tackle challenges like drought resilience, flood mitigation, and environmental protection. By leveraging the capabilities of ArcGIS, users can transform raw water data into actionable insights, ensuring more efficient and effective water resource management.
A central feature of the platform is Arc Hydro, a specialized data model and toolkit developed for GIS-based water resource analysis. This toolset allows users to integrate, analyze, and visualize water datasets for applications ranging from live stream gauge monitoring to pollution control. Additionally, the platform connects users to the ArcGIS Living Atlas of the World, which offers extensive water-related datasets such as rivers, wetlands, and soils, supporting in-depth analyses of hydrologic conditions. The Hydro Community further enhances collaboration, enabling stakeholders to share expertise, discuss challenges, and build innovative solutions together.
Esri’s platform also provides training opportunities and professional services to empower users with technical knowledge and skills. Through instructor-led courses, documentation, and best practices, users gain expertise in using ArcGIS and Arc Hydro for their specific water management needs. The combination of tools, datasets, and community engagement makes Esri's water resources platform a powerful asset for advancing sustainable water management initiatives across public and private sectors.
\""
+ ]
+ },
+ "execution_count": 67,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "item_description = document.description\n",
+ "item_description"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "d552feb7-3e1e-4211-ac19-e7d2647db490",
+ "metadata": {},
+ "source": [
+ "Similar to the `analyze_image()` method, in order to provide prompts as a dictionary it is essential to provide the values for the key and context keys of the dictionary for each prompt that you wish to provide."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 68,
+ "id": "69fb9c2d-f440-48dd-967d-f65bd202addd",
+ "metadata": {},
+ "outputs": [],
+ "source": [
+ "prompt_dicts = [\n",
+ " {\"key\": \"summary_prompt\", \"context\": \"Summarize this text\"},\n",
+ " {\"key\": \"tools_prompt\", \"context\": \"Identify the tools mentioned in the text.\"}\n",
+ "]"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 69,
+ "id": "76042778-fe79-4c18-a3e2-878e77ffa995",
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "text/plain": [
+ "AIUtilsResponse(success=True, meta=AIUtilsResponseMetaData(usage={'inputTokens': 997, 'outputTokens': 140, 'totalTokens': 1137}, model='gpt-5.4'), results=[AnalyzeResult(success=True, value=\"Esri's Water Resources GIS Platform provides geospatial tools, datasets, training, and community resources to improve water resource management. It uses ArcGIS capabilities to monitor, analyze, and model water systems for issues such as drought resilience, flood mitigation, and environmental protection. Key components include Arc Hydro for GIS-based water analysis, the ArcGIS Living Atlas of the World for water-related datasets, and the Hydro Community for collaboration and knowledge sharing.\", key='summary_prompt'), AnalyzeResult(success=True, value=['ArcGIS', 'Arc Hydro', 'ArcGIS Living Atlas of the World', 'Hydro Community'], key='tools_prompt')])"
+ ]
+ },
+ "execution_count": 69,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "result_dicts = analyze_text(text = item_description, prompt = prompt_dicts)\n",
+ "result_dicts"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 70,
+ "id": "451bc7c5-705d-47fc-9b17-2ab14a8f6fd6",
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "text/plain": [
+ "\"Esri's Water Resources GIS Platform provides geospatial tools, datasets, training, and community resources to improve water resource management. It uses ArcGIS capabilities to monitor, analyze, and model water systems for issues such as drought resilience, flood mitigation, and environmental protection. Key components include Arc Hydro for GIS-based water analysis, the ArcGIS Living Atlas of the World for water-related datasets, and the Hydro Community for collaboration and knowledge sharing.\""
+ ]
+ },
+ "execution_count": 70,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "result_dicts.results[0].value"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 71,
+ "id": "4b8d061d-4180-4442-aa2d-049805f7d1aa",
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "text/plain": [
+ "['ArcGIS', 'Arc Hydro', 'ArcGIS Living Atlas of the World', 'Hydro Community']"
+ ]
+ },
+ "execution_count": 71,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "result_dicts.results[1].value"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "557525ee-d848-4c0c-9d59-7e00390616df",
+ "metadata": {},
+ "source": [
+ "The tool summarizes the description of this item well and also identifies the ArcGIS tools mentioned. "
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "459ee9ed-d2ee-4558-8566-a829eb2246eb",
+ "metadata": {},
+ "source": [
+ "### __Translate Text__\n",
+ "\n",
+ "The `translate()` method translates language strings passed to the desired array of output cultures. To identify the languages supported in your ArcGIS Online Organization and the `culture` of those languages, you may invoke the `languages` property of the `GIS` object as shown below."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 73,
+ "id": "1e628904-6cc1-4118-bcef-1eccfb7e234b",
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "text/plain": [
+ "[{'language': 'Arabic', 'culture': 'ar', 'localizedName': 'عربي'},\n",
+ " {'language': 'Bosnian', 'culture': 'bs', 'localizedName': 'Bosanski'},\n",
+ " {'language': 'Bulgarian', 'culture': 'bg', 'localizedName': 'Български'},\n",
+ " {'language': 'Simplified Chinese',\n",
+ " 'culture': 'zh-CN',\n",
+ " 'localizedName': '简体中文'},\n",
+ " {'language': 'Catalan', 'culture': 'ca', 'localizedName': 'Català'},\n",
+ " {'language': 'Croatian', 'culture': 'hr', 'localizedName': 'Hrvatski'},\n",
+ " {'language': 'Czech', 'culture': 'cs', 'localizedName': 'čeština'},\n",
+ " {'language': 'Danish', 'culture': 'da', 'localizedName': 'Dansk'},\n",
+ " {'language': 'Dutch', 'culture': 'nl', 'localizedName': 'Nederlands'},\n",
+ " {'language': 'English',\n",
+ " 'culture': 'en',\n",
+ " 'localizedName': 'English',\n",
+ " 'cultureFormats': [{'name': 'United States',\n",
+ " 'localizedName': 'United States',\n",
+ " 'format': 'us'},\n",
+ " {'name': 'Great Britain', 'localizedName': 'Great Britain', 'format': 'gb'},\n",
+ " {'name': 'Australia', 'localizedName': 'Australia', 'format': 'au'},\n",
+ " {'name': 'Canada', 'localizedName': 'Canada', 'format': 'ca'}]},\n",
+ " {'language': 'Estonian', 'culture': 'et', 'localizedName': 'Eesti'},\n",
+ " {'language': 'Finnish', 'culture': 'fi', 'localizedName': 'Suomi'},\n",
+ " {'language': 'French',\n",
+ " 'culture': 'fr',\n",
+ " 'localizedName': 'Français',\n",
+ " 'cultureFormats': [{'name': 'France',\n",
+ " 'localizedName': 'France',\n",
+ " 'format': 'fr'},\n",
+ " {'name': 'Switzerland', 'localizedName': 'Suisse', 'format': 'ch'},\n",
+ " {'name': 'Canada', 'localizedName': 'Canada', 'format': 'ca'}]},\n",
+ " {'language': 'Greek', 'culture': 'el', 'localizedName': 'Ελλάδα'},\n",
+ " {'language': 'German',\n",
+ " 'culture': 'de',\n",
+ " 'localizedName': 'Deutsch',\n",
+ " 'cultureFormats': [{'name': 'Germany',\n",
+ " 'localizedName': 'Deutschland',\n",
+ " 'format': 'de'},\n",
+ " {'name': 'Switzerland', 'localizedName': 'Schweiz', 'format': 'ch'},\n",
+ " {'name': 'Austria', 'localizedName': 'Österreich', 'format': 'at'}]},\n",
+ " {'language': 'Hebrew', 'culture': 'he', 'localizedName': 'עברית'},\n",
+ " {'language': 'Hungarian', 'culture': 'hu', 'localizedName': 'Magyar'},\n",
+ " {'language': 'Indonesian',\n",
+ " 'culture': 'id',\n",
+ " 'localizedName': 'Bahasa Indonesia'},\n",
+ " {'language': 'Italian',\n",
+ " 'culture': 'it',\n",
+ " 'localizedName': 'Italiano',\n",
+ " 'cultureFormats': [{'name': 'Italy',\n",
+ " 'localizedName': 'Italia',\n",
+ " 'format': 'it'},\n",
+ " {'name': 'Switzerland', 'localizedName': 'Svizzera', 'format': 'ch'}]},\n",
+ " {'language': 'Japanese', 'culture': 'ja', 'localizedName': '日本語'},\n",
+ " {'language': 'Korean', 'culture': 'ko', 'localizedName': '한국어'},\n",
+ " {'language': 'Latvian', 'culture': 'lv', 'localizedName': 'Latviešu'},\n",
+ " {'language': 'Lithuanian', 'culture': 'lt', 'localizedName': 'Lietuvių'},\n",
+ " {'language': 'Norwegian', 'culture': 'nb', 'localizedName': 'Norsk'},\n",
+ " {'language': 'Polish', 'culture': 'pl', 'localizedName': 'Polski'},\n",
+ " {'language': 'Portuguese (Brazil)',\n",
+ " 'culture': 'pt-BR',\n",
+ " 'localizedName': 'Português (Brasil)'},\n",
+ " {'language': 'Portuguese (Portugal)',\n",
+ " 'culture': 'pt-PT',\n",
+ " 'localizedName': 'Português (Portugal)'},\n",
+ " {'language': 'Romanian', 'culture': 'ro', 'localizedName': 'Română'},\n",
+ " {'language': 'Russian', 'culture': 'ru', 'localizedName': 'Русский'},\n",
+ " {'language': 'Serbian', 'culture': 'sr', 'localizedName': 'Srpski'},\n",
+ " {'language': 'Slovenian', 'culture': 'sl', 'localizedName': 'Slovenščina'},\n",
+ " {'language': 'Slovak', 'culture': 'sk', 'localizedName': 'Slovenčina'},\n",
+ " {'language': 'Spanish',\n",
+ " 'culture': 'es',\n",
+ " 'localizedName': 'Español',\n",
+ " 'cultureFormats': [{'name': 'Spain',\n",
+ " 'localizedName': 'España',\n",
+ " 'format': 'es'},\n",
+ " {'name': 'Mexico', 'localizedName': 'México', 'format': 'mx'}]},\n",
+ " {'language': 'Swedish', 'culture': 'sv', 'localizedName': 'Svenska'},\n",
+ " {'language': 'Thai', 'culture': 'th', 'localizedName': 'ไทย'},\n",
+ " {'language': 'Traditional Chinese (Hong Kong)',\n",
+ " 'culture': 'zh-HK',\n",
+ " 'localizedName': '繁體中文（香港）'},\n",
+ " {'language': 'Traditional Chinese (Taiwan)',\n",
+ " 'culture': 'zh-TW',\n",
+ " 'localizedName': '繁體中文（台灣）'},\n",
+ " {'language': 'Ukrainian', 'culture': 'uk', 'localizedName': 'Україна'},\n",
+ " {'language': 'Turkish', 'culture': 'tr', 'localizedName': 'Türkiye'},\n",
+ " {'language': 'Vietnamese', 'culture': 'vi', 'localizedName': 'Tiếng Việt'}]"
+ ]
+ },
+ "execution_count": 73,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "gis.languages"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "162fb0d9-e643-4ad8-b3b8-ad06e7aaaade",
+ "metadata": {},
+ "source": [
+ "We start with an example to translate a few lines in Spanish to English."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 72,
+ "id": "ef427c9e-6f9d-44ec-95d3-38d2fa994071",
+ "metadata": {},
+ "outputs": [],
+ "source": [
+ "text = \"El bosque está lleno de vida. Mientras el sol brilla a través de las altas ramas, el viento sopla suavemente. Los \\\n",
+ " pájaros cantan en los árboles y las mariposas vuelan sobre las flores. Estar en la naturaleza nos da paz y tranquilidad.\""
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "8da55e1f-2055-44e6-9fc0-0f7de417f271",
+ "metadata": {},
+ "source": [
+ "Note that the input to the `to_language` parameter in the `translate()` method accepts input as a `list`, to support multiple output languages at once. However, the `from_language` parameter accepts a `str` input. "
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 75,
+ "id": "de312ee7-2a86-4d7e-af89-46325f6c6c48",
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "text/plain": [
+ "AIUtilsResponse(success=True, meta=AIUtilsResponseMetaData(usage={'inputCharacters': 242}, model='azure-ai-translator'), results=[TranslateResult(translations=[{'text': 'The forest is full of life. As the sun shines through the tall branches, the wind blows gently. Birds sing in the trees and butterflies fly over the flowers. Being in nature gives us peace and tranquility.', 'to': 'en'}], key='key:1')])"
+ ]
+ },
+ "execution_count": 75,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "spanish_to_english = translate(text = text, to_language = ['en'], from_language = 'es')\n",
+ "spanish_to_english"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "cfea8971-3162-4acd-a782-7b2c247de120",
+ "metadata": {},
+ "source": [
+ "Unlike the `analyze_image()` and `analyze_text()` methods, the process to access the response (translated text) is slightly different, as shown below."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 80,
+ "id": "26fab339-0b29-4afc-a9d7-2537228f016f",
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "text/plain": [
+ "'The forest is full of life. As the sun shines through the tall branches, the wind blows gently. Birds sing in the trees and butterflies fly over the flowers. Being in nature gives us peace and tranquility.'"
+ ]
+ },
+ "execution_count": 80,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "spanish_to_english.results[0].translations[0]['text']"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "6e287c1f-1226-45e5-a217-b87fd4be06f9",
+ "metadata": {},
+ "source": [
+ "Let us conclude with an example using an ArcGIS item from Ontario, Canada in French. We fetch the item and access its `snippet` which we provide as input to the `translate()` method. "
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 81,
+ "id": "1d72fc50-f34b-4cce-8d2e-50b9aa960784",
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "text/html": [
+ "\n",
+ "
\n",
+ "\n",
+ "
\n",
+ "
Données du rapport annuel historique sur les forêts de l’Ontario\n",
+ " \n",
+ "
Les données du rapport annuel historique sur les forêts de l’Ontario constituent un ensemble de données consolidées à l’échelle de la province, provenant des rapports annuels sur les opérations forestières depuis 2002. Format des données : ESRI Geodatabase
Document Link by LandInformationOntario\n",
+ "
Last Modified: March 20, 2026\n",
+ "
0 comments, 35 views\n",
+ "
\n",
+ "
- "
+ ]
+ },
+ "execution_count": 81,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "ontario_canada_item = gis.content.get('9c2e4d1a671f41eb913411f048aaf661')\n",
+ "ontario_canada_item"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 82,
+ "id": "02be7f7c-152b-4561-a329-b13e68bbc334",
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "text/plain": [
+ "'Les données du rapport annuel historique sur les forêts de l’Ontario constituent un ensemble de données consolidées à l’échelle de la province, provenant des rapports annuels sur les opérations forestières depuis 2002. Format des données : ESRI Geodatabase'"
+ ]
+ },
+ "execution_count": 82,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "item_snippet = ontario_canada_item.snippet\n",
+ "item_snippet"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 83,
+ "id": "a5784b86-27d2-4dd1-9b17-7e1191e8e503",
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "text/plain": [
+ "AIUtilsResponse(success=True, meta=AIUtilsResponseMetaData(usage={'inputCharacters': 257}, model='azure-ai-translator'), results=[TranslateResult(translations=[{'text': 'The Ontario Historical Annual Forest Report is a province-wide consolidated dataset from annual reports on forest operations since 2002. Data Format: ESRI Geodatabase', 'to': 'en'}], key='key:1')])"
+ ]
+ },
+ "execution_count": 83,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "french_to_english = translate(text = item_snippet, to_language = ['en'], from_language = 'fr')\n",
+ "french_to_english"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 85,
+ "id": "c95db6d6-ebb5-4d76-ae23-8877eafb0039",
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "text/plain": [
+ "'The Ontario Historical Annual Forest Report is a province-wide consolidated dataset from annual reports on forest operations since 2002. Data Format: ESRI Geodatabase'"
+ ]
+ },
+ "execution_count": 85,
+ "metadata": {},
+ "output_type": "execute_result"
+ }
+ ],
+ "source": [
+ "french_to_english.results[0].translations[0]['text']"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "2954c8c2-5a87-4eb3-accb-e7fe086ace5b",
+ "metadata": {},
+ "source": [
+ "We see that the tool has successfully translated the snippet from French to English."
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "id": "477a9c36-4019-4691-b785-0100403f3dd5",
+ "metadata": {},
+ "source": [
+ "### Conclusion\n",
+ "\n",
+ "The `arcgis.ai` module is useful when your workflows involve unstructured data in the form of field notes, inspection reports, public comments, customer requests, attached photos or scanned documents. Deriving necessary information from these data sources using these services supported within the ArcGIS API for Python can improve productivity. \n",
+ "\n",
+ "To delve deeper into the `arcgis.ai` module with an example that involves real-world data, we encourage you to take a look at this [sample](https://developers.arcgis.com/python/latest/samples/ai-utility-services-enhancing-service-requests/). "
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "id": "1b8a82a0-fb84-4d7e-95c2-e7c2428d61da",
+ "metadata": {},
+ "outputs": [],
+ "source": []
+ }
+ ],
+ "metadata": {
+ "kernelspec": {
+ "display_name": "Python 3 (ipykernel)",
+ "language": "python",
+ "name": "python3"
+ },
+ "language_info": {
+ "codemirror_mode": {
+ "name": "ipython",
+ "version": 3
+ },
+ "file_extension": ".py",
+ "mimetype": "text/x-python",
+ "name": "python",
+ "nbconvert_exporter": "python",
+ "pygments_lexer": "ipython3",
+ "version": "3.12.11"
+ }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}
\n",
+ " \n",
+ " 
\n",
+ "