Cloud Location Finder overview
Preview
This product is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of theService Specific Terms. Pre-GA products are available "as is" and might have limited support. For more information, see thelaunch stage descriptions.
Cloud Location Finder is a public API that offers a repository of allGoogle Cloud and Google Distributed Cloud locations, as well ascloud locations forother cloud providers.
What Cloud Location Finder provides
Cloud Location Finder provides a cloud location repository for cloud locationsacross providers. It automatically updates its locations to prevent issues withoutdated, hard-coded lists.
With Cloud Location Finder, you can do the following:
- Identify locations to deploy workloads that are close to existing workloads
- Filter for locations within a designated country for compliance reasons
- Sort locations based on their carbon footprint
You can identify cloud locations based on the following filters. For moreinformation about how to use these filters, seeQuery and filter syntax for Cloud Location Finder.
| Cloud location filtering type | Description |
|---|---|
| Proximity | Deploy workloads in locations that minimize latency between endpoints across cloud providers. Proximity is based on network latency. Cloud Location Finder measures network latency as the round-trip time between a pair of locations. The nearest location to a given source location is based on network latency observed between a pair of locations. |
| Territory code | Identify relevant territories for compliance requirements. Cloud Location Finder usestwo-letter ISO 3166-1 alpha-2 codes to identify locations. Filtering locations by territory code helps you determine whether a location meets security, tax, data regulatory, or other requirements. To see the list of country codes, visit theISO Online Browsing Platform. |
| Carbon free energy (CFE) usage | Minimize the carbon footprint of your applications to meet sustainability goals. Cloud Location Finder measures a location's carbon footprint usingGoogle Cloud's CFE consumption data. Carbon footprint data is available only for Google Cloud locations. |
| Cloud provider | Find the nearest location across each cloud provider you use. |
| Cloud region or zone | Drill down within a region to find location information about specific zones. |
Supported locations
Cloud Location Finder includes public locations from each of these location sources:
Google Cloud publicregions and zones
Google Distributed Cloud infrastructure
Google Distributed Cloud connected zones within specified regions
Amazon Web Services publiclocal zones
Microsoft Azuregeographies
Oracle Cloud Infrastructure publicregions andavailability domains
Location sorting
In the Google Cloud CLI, thelistcommand sorts by both CFE and cloud location ID. Thesearch command sorts by proximity,CFE%, and cloud location ID.
Results for proximity use an ascending sort, meaning the smallest distanceappears first. Results for CFE% use a descending sort, meaning the largestCFE% appears first.
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-02-19 UTC.