Use the Coverage API to retrieve metadata about Nearmap surveys for a given location including survey dates, content types, and resolution. Survey IDs returned by this API can then be passed directly to the Tile API to request imagery for a specific capture date.

Choosing the right endpoint

Before querying, decide whether you need survey polygon geometries (the actual coverage outlines) or just survey metadata (dates, resolution, content types). Use the table below to select the appropriate endpoint.

Use Case	API	Input	Output
Use this API for querying dates and other attributes for a small geographic area. For example, in interactive web applications.	`/coverage/v2/poly/`	Area of Interest as a polygon	Metadata for survey resources that the user can access via the API, taking into account area and content types.
Use this API for querying dates and other attributes for a point. For example, checking if there is Nearmap coverage at a geocoded address.	`/coverage/v2/point/`	Area of Interest as a point	Metadata for survey resources that the user can access via the API, taking into account area and content types.
Use this API for querying dates and other attributes for a Google x/y/z tile coordinate. Provided for legacy compatibility reasons. Equivalent to the /`poly` request with the extent of the particular tile.	`/coverage/v2/coord/`	Area of Interest as a Web Mercator tile	Metadata for survey resources that the user can access via the API, taking into account area and content types.
Use this API for visualization of aggregated Nearmap coverage. For example, to create an interactive map that shows where there is Nearmap coverage.	`/coverage/v2/aggregate/boundaries.geojson`	No way to specify the area	Aggregated coverage polygons per content type (Vertical, Oblique, 3D), regardless of the user access level.
Use this API for querying the photo timestamps at a point in a survey.	`/coverage/v2/point/{x},{y}/timestamp.json`	Date range using the since and until parameters	Metadata related to the photo timestamps for a tile

Using Coverage with the Tile API

Call /coverage/v2/poly/ or /coverage/v2/point/ to get the list of available surveys and their dates for the current map viewport
Display the survey list in a date-picker component
Pass the selected surveyId to the Tile API endpoint /surveys/{surveyId}/{contentType}/{z}/{x}/{y}.{format} to load imagery for that date.