Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
Method: projects.maps.tiles.get
Stay organized with collections
Save and categorize content based on your preferences.
Computes a map tile image showing a portion of a computation. The request includes values (a map ID and authorisation token) from a previous CreateMap request.
HTTP request
GET https://earthengine.googleapis.com/v1/{parent=projects/*/maps/*}/tiles/{zoom}/{x}/{y}
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
parent |
string
A map name from EarthEngineMap.name.
|
zoom |
integer
The [zoom level][https://developers.google.com/maps/documentation/javascript/coordinates] of the requested map tile.
|
x |
integer
The [x coordinate][https://developers.google.com/maps/documentation/javascript/coordinates] of the requested map tile.
|
y |
integer
The [y coordinate][https://developers.google.com/maps/documentation/javascript/coordinates] of the requested map tile.
|
Request body
The request body must be empty.
Response body
If successful, the response is a generic HTTP response whose format is defined by the method.
Authorization scopes
Requires one of the following OAuth scopes:
https://www.googleapis.com/auth/earthengine
https://www.googleapis.com/auth/earthengine.readonly
https://www.googleapis.com/auth/cloud-platform
https://www.googleapis.com/auth/cloud-platform.read-only
For more information, see the OAuth 2.0 Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-03-06 UTC.
[null,null,["Last updated 2025-03-06 UTC."],[[["\u003cp\u003eRetrieves a map tile image for a specific portion of a computation using a GET request.\u003c/p\u003e\n"],["\u003cp\u003eRequires a map ID and authorization token obtained from a previous \u003ccode\u003eCreateMap\u003c/code\u003e request.\u003c/p\u003e\n"],["\u003cp\u003eThe request specifies the desired map tile using zoom level and x/y coordinates.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful responses are generic HTTP responses with format determined by the method used.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with specific OAuth scopes for Earth Engine or Cloud Platform access.\u003c/p\u003e\n"]]],["This content details the process for retrieving a map tile image. It uses a `GET` request to a specific URL structure, including map ID, authorization token, zoom level, and x/y coordinates. The `parent`, `zoom`, `x`, and `y` parameters define the tile location. The request body must be empty. The successful response is a generic HTTP response. Authorization requires specific OAuth scopes, such as `earthengine` or `cloud-platform`.\n"],null,["# Method: projects.maps.tiles.get\n\nComputes a map tile image showing a portion of a computation. The request includes values (a map ID and authorisation token) from a previous `CreateMap` request.\n\n### HTTP request\n\n`GET https://earthengine.googleapis.com/v1/{parent=projects/*/maps/*}/tiles/{zoom}/{x}/{y}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|--------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` A map name from `EarthEngineMap.name`. |\n| `zoom` | `integer` The \\[zoom level\\]\\[https://developers.google.com/maps/documentation/javascript/coordinates\\] of the requested map tile. |\n| `x` | `integer` The \\[x coordinate\\]\\[https://developers.google.com/maps/documentation/javascript/coordinates\\] of the requested map tile. |\n| `y` | `integer` The \\[y coordinate\\]\\[https://developers.google.com/maps/documentation/javascript/coordinates\\] of the requested map tile. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response is a generic HTTP response whose format is defined by the method.\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/earthengine`\n- `\n https://www.googleapis.com/auth/earthengine.readonly`\n- `\n https://www.googleapis.com/auth/cloud-platform`\n- `\n https://www.googleapis.com/auth/cloud-platform.read-only`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]