Retrieving an Image Centered on a Location
This API retrieves a JPEG image using the center point of a location.
If you do not have permissions to access imagery in the specified location you will get a white rectangle instead of the image.
NOTE: The API only returns imagery in Web Mercator projection.
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
|
| Parameter | Meaning | Example |
| RC | Region code. Either us or au. Note: the region code for New Zealand is also au. | au |
| NUMBER | Domain rotation number. Valid numbers are 0-3. | 0 |
| center | Latitude and Longitude of the location on which to centre the image in the format<latitude,longitude> | 37.334849,-122.008946 |
| size | Size of the image in pixels | 800x800 |
| zoom | Image zoom (Web Mercator zoom) | 18 |
| date | Date of the image, in the format YYYYMMDD | 20150314 |
| httpauth | Whether the tile server should prompt for HTTP basic authentication. Set this to false (as we no longer support HTTP Basic authentication). | false |
| apikey | API 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
This API retrieves a JPEG image of a location using a bounding box.
If you do not have permissions to access imagery in the specified location you will get a white rectangle instead of the image.
Note: the API only support Web Mercator projection.
URL Format
http://[RC][NUMBER].nearmap.com/staticmap?bbox=[BOUNDING BOX]&zoom=[ZOOM]&date=[DATE]&httpauth=false&apikey=[YOUR API KEY]
URL Parameters
Parameter | Meaning | Example |
|---|
RC | Region code. Either us or au. Note: the region code for New Zealand is also au. | us |
| NUMBER | Domain rotation number. Valid numbers are 0-3. | 0 |
| bbox | Bounding box in the format [MIN LAT,MIN LON,MAX LAT,MAX LON] | 37.33197414633263,-122.0126095035584,
37.33767824148404,-122.00526382713622 |
| zoom | Image zoom (Web Mercator zoom). | 18 |
| date | Date of the image, in the format YYYYMMDD | 20150314 |
| httpauth | Whether the tile server should prompt for HTTP basic authentication. Set this to false (as we no longer support HTTP Basic authentication). | false |
| apikey | API 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 handles imagery requests when no imagery for a specified date is available.
