Page tree
Skip to end of metadata
Go to start of metadata

This guide includes the following sections:

Retrieving an Image Centered on a Location

URL Format

http://[RC][NUMBER].nearmap.com/staticmap?center=[CENTER LAT LON]&
size=[WIDTHxHEIGHT]&zoom=[ZOOM]&date=[DATE]&
httpauth=false&apikey=[YOUR API KEY] 

URL Parameters

ParameterMeaningExample
RCRegion code. Either us or au. Note: the region code for New Zealand is also au.au
NUMBERDomain rotation number. Valid numbers are 0-3.0
centerLatitude and Longitude of the location on which to centre the image in the format<latitude,longitude>37.334849,-122.008946
sizeSize of the image in pixels800x800
zoomImage zoom (web mercator zoom)18
dateDate of the image, in the format YYYYMMDD20150314
httpauthWhether the tile server should prompt for HTTP basic authentication. Set this to false (as we no longer support HTTP Basic authentication).false
apikeyAPI Key. See API Key Authentication.A325BF1343...

Example

http://us0.nearmap.com/staticmap?center=37.334849,-122.008946&size=800x800&zoom=18&date=20150205&httpauth=false&apikey=YOUR_API_KEY 

Getting a Bounded Image for a Location

URL Format

http://[RC][NUMBER].nearmap.com/staticmap?bbox=[BOUNDING BOX]&
zoom=[ZOOM]&date=[DATE]&httpauth=false&apikey=[YOUR API KEY]

URL Parameters

ParameterMeaningExample
RCRegion code. Either us or au. Note: the region code for New Zealand is also au.us
NUMBERDomain rotation number. Valid numbers are 0-3.0
bboxBounding box in the format [MIN LAT,MIN LON,MAX LAT,MAX LON]37.33197414633263,-122.0126095035584,
37.33767824148404,-122.00526382713622
zoomImage zoom (web mercator zoom).18
dateDate of the image, in the format YYYYMMDD20150314
httpauthWhether the tile server should prompt for HTTP basic authentication. Set this to false (as we no longer support HTTP Basic authentication).false
apikeyAPI Key. See API Key Authentication.A325BF1343...

Example

http://us0.nearmap.com/staticmap?bbox=37.33197414633263,-122.0126095035584,37.33767824148404,-122.00526382713622&nmd=20150216&zoom=18&date=20150205&httpauth=false&apikey=YOUR_API_KEY 

Note on "Best" Zoom

When using the value "best" for zoom level, the system will generate the best image possible, in terms of pixels, for the specified location, up to a maximum of 6000 x 6000 pixels.

Further Information

Read about how Nearmap image API handle imagery requests when no imagery for a specified date is available.


  • No labels