Get started

There are a number of ways to install and configure . If you are new, follow the steps below to get started with conda and Jupyter Notebooks. For additional installation configurations, go to ArcGIS Pro, Docker, Google Colaboratory, or Offline.

1. Sign up for an account

To use the to access , , or an organzation, you need an , , or . The type of account, user type, and role you need depends on the resource you need to access and the operations you wish to undertake.

If you do not have an account, select one of the options below:

Get started for free with ArcGIS Platform

Get a free trial for ArcGIS Online



2. Install the API

To use the you need to install conda.

Install conda

  1. To install conda, go to the installation guide.

  2. In the guide, select your operating system and then follow the installation instructions.

Install the

  1. Open a terminal window.
  2. In the terminal, navigate to your working directory.
  3. Run the following command to activate your environment: conda activate <YOUR_ENVINRONMENT>
  4. Install the ArcGIS API for Python: conda install -c esri arcgis arcgis-mapping

3. Run Jupyter Lab

Start the Jupyter Lab server with the following steps:

  1. Open a terminal window.
  2. In the terminal, run the command: jupyter lab

The command starts Jupyter Notebook and opens it in your default web browser.

notebook screenshot

4. Create your first script

Create a Notebook to geocode a text string to find an address.

  1. In Jupyter Notebook, click New > Python 3.
  2. In the top cell, import the GIS, geocode and Geocoder modules and set your API key:

To access secure ArcGIS services and resources in , you need to use an . The easiest way to get started is to create an . Learn more about access tokens and authentication in Security and authentication.

Get an API key

1
2
3
4
5
6
7
8
9
10
11
12
from arcgis.gis import GIS
from arcgis.geocoding import geocode, Geocoder

gis = GIS(api_key="<YOUR_API_KEY>")

# Location services standard endpoint URL
# https://developers.arcgis.com/documentation/mapping-apis-and-services/geocoding/services/geocoding-service/#service-urls
geocode_url = Geocoder("https://geocode-api.arcgis.com/arcgis/rest/services/World/GeocodeServer/",gis=gis)

geocode_result = geocode(address="380 New York Street, Redlands, CA", geocoder=geocode_url)

geocode_result
  1. In the toolbar, click Run to execute the code. You should see geocoded address results.

5. Follow the tutorials

Go to the tutorials to create and run notebooks to perform different operations.

6. Explore the samples

Go to the samples to learn how to perform more tasks with the API.

Next steps

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

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close