Dynamic
The ndaview.vn - Dynamic API provides the ability to search and query Vietnam street image data, supporting a variety of filters to refine the returned results.
Description
ndaview.vn Dynamic API allows users to search for 360° images or images focused on a specific location. Users can apply filters based on geographic location, time, or other attributes to get relevant results.
Base URL
https://api-view.ndamaps.vn/v1
Endpoint
GET /search
Example
Request:
GET /search?place_position=105.788024983,21.032796623&limit=1
Response:
{
"features": [
{
"id": "f8e64d0c-e875-4bbc-8ac9-c26eae1d2e1f",
"asset_templates": {
"tiles": {
"description": "Highest resolution available of this picture, as tiles",
"href": "https://hn.storage.weodata.vn/ndaview-cdn/derivates/f8/e6/4d/0c/e875-4bbc-8ac9-c26eae1d2e1f/tiles/{TileCol}_{TileRow}.jpg",
"roles": [
"data"
],
"title": "HD tiled picture",
"type": "image/jpeg"
}
},
"assets": {
"hd": {
"description": "Highest resolution available of this picture",
"href": "https://hn.storage.weodata.vn/ndaview-cdn/main-pictures/f8/e6/4d/0c/e875-4bbc-8ac9-c26eae1d2e1f.jpg",
"roles": [
"data"
],
"title": "HD picture",
"type": "image/jpeg"
},
"sd": {
"description": "Picture in standard definition (fixed width of 2048px)",
"href": "https://hn.storage.weodata.vn/ndaview-cdn/derivates/f8/e6/4d/0c/e875-4bbc-8ac9-c26eae1d2e1f/sd.jpg",
"roles": [
"visual"
],
"title": "SD picture",
"type": "image/jpeg"
},
"thumb": {
"description": "Picture in low definition (fixed width of 500px)",
"href": "https://hn.storage.weodata.vn/ndaview-cdn/derivates/f8/e6/4d/0c/e875-4bbc-8ac9-c26eae1d2e1f/thumb.jpg",
"roles": [
"thumbnail"
],
"title": "Thumbnail",
"type": "image/jpeg"
}
},
"bbox": [
105.788044068,
21.032828214,
105.788044068,
21.032828214
],
"collection": "af0e6ea5-5e1c-4730-9f66-b147c19dfa76",
"geometry": {
"type": "Point",
"coordinates": [
105.788044068,
21.032828214
]
},
"links": [
{
"href": "https://api-view.ndamaps.vn/v1/",
"rel": "root",
"title": "Instance catalog",
"type": "application/json",
"geometry": null,
"id": "",
"datetime": ""
},
{
"href": "https://api-view.ndamaps.vn/v1/collections/af0e6ea5-5e1c-4730-9f66-b147c19dfa76",
"rel": "parent",
"title": "Instance catalog",
"type": "application/json",
"geometry": null,
"id": "",
"datetime": ""
},
{
"href": "https://api-view.ndamaps.vn/v1/collections/af0e6ea5-5e1c-4730-9f66-b147c19dfa76/items/f8e64d0c-e875-4bbc-8ac9-c26eae1d2e1f",
"rel": "self",
"title": "",
"type": "application/json",
"geometry": null,
"id": "",
"datetime": ""
},
{
"href": "https://api-view.ndamaps.vn/v1/collections/af0e6ea5-5e1c-4730-9f66-b147c19dfa76",
"rel": "collection",
"title": "",
"type": "application/json",
"geometry": null,
"id": "",
"datetime": ""
},
{
"href": "https://api-view.ndamaps.vn/v1/collections/af0e6ea5-5e1c-4730-9f66-b147c19dfa76/items/e213daed-3ae2-4259-940b-444a4056c101",
"rel": "next",
"title": "",
"type": "application/json",
"geometry": {
"type": "Point",
"coordinates": [
105.788024983,
21.032796623
]
},
"id": "e213daed-3ae2-4259-940b-444a4056c101",
"datetime": ""
},
{
"href": "https://api-view.ndamaps.vn/v1/collections/af0e6ea5-5e1c-4730-9f66-b147c19dfa76/items/cd6ef1b9-b84f-4eec-857c-1d1d153d7dd4",
"rel": "prev",
"title": "",
"type": "application/json",
"geometry": {
"type": "Point",
"coordinates": [
105.788039954,
21.03287709
]
},
"id": "cd6ef1b9-b84f-4eec-857c-1d1d153d7dd4",
"datetime": ""
}
],
"providers": [
{
"name": "giangdd",
"roles": [
"producer"
]
}
],
"stac_extensions": [
"https://stac-extensions.github.io/view/v1.0.0/schema.json",
"https://stac-extensions.github.io/perspective-imagery/v1.0.0/schema.json"
],
"stac_version": "1.0.0",
"type": "Feature",
"properties": {
"created": "2024-10-11T04:39:53.326688Z",
"datetime": "2024-10-05T10:22:50Z",
"datetimetz": "2024-10-05T10:22:50Z",
"height": 2880,
"license": "CC-BY-SA-4.0",
"original_file:name": "1728123770000.jpg",
"original_file:size": 1744538,
"pers:pitch": null,
"pers:roll": null,
"ndaview_vn:image": "https://hn.storage.weodata.vn/ndaview-cdn/main-pictures/f8/e6/4d/0c/e875-4bbc-8ac9-c26eae1d2e1f.jpg",
"ndaview_vn:producer": "giangdd",
"ndaview_vn:status": "ready",
"ndaview_vn:thumbnail": "https://hn.storage.weodata.vn/ndaview-cdn/derivates/f8/e6/4d/0c/e875-4bbc-8ac9-c26eae1d2e1f/thumb.jpg",
"view:azimuth": 211,
"width": 5760,
"exif": {
"Exif.Image.Make": "Insta360",
"Exif.Image.Model": "Insta360",
"Exif.Image.GPSTag": "172",
"Exif.Image.ExifTag": "94",
"Exif.GPSInfo.GPSDOP": "",
"Exif.Image.FocalLength": "",
"Exif.Photo.UserComment": "Lavc59.37.100",
"Exif.GPSInfo.GPSLatitude": "21/1 1/1 56465329/970502",
"Xmp.GPano.ProjectionType": "equirectangular",
"Exif.GPSInfo.GPSDateStamp": "2024-10-05",
"Exif.GPSInfo.GPSLongitude": "105/1 47/1 2733649/161195",
"Exif.GPSInfo.GPSTimeStamp": "10/1 22/1 50/1",
"Exif.GPSInfo.GPSLatitudeRef": "N",
"Exif.Photo.DateTimeOriginal": "2024-10-05 10:22:50",
"Xmp.GPano.UsePanoramaViewer": "yes",
"Exif.GPSInfo.GPSLongitudeRef": "E",
"Exif.Photo.OffsetTimeOriginal": "+00:00",
"Exif.Photo.SubSecTimeOriginal": "000000",
"Exif.GPSInfo.GPSHPositioningError": ""
},
"pers:interior_orientation": {
"field_of_view": 360,
"model": "",
"focal_length": null,
"make": "",
"camera_manufacturer": "Insta360",
"camera_model": "Insta360"
},
"tiles:tile_matrix_sets": {
"view:azimuth": "",
"width": 0,
"ndaview_vn": {
"identifier": "ndaview_vn-f8e64d0c-e875-4bbc-8ac9-c26eae1d2e1f",
"title": "NdaviewVN tile matrix for picture f8e64d0c-e875-4bbc-8ac9-c26eae1d2e1f",
"type": "TileMatrixSetType",
"tileMatrix": [
{
"identifier": "0",
"matrixHeight": 4,
"matrixWidth": 8,
"scaleDenominator": 1,
"tileHeight": 720,
"tileWidth": 1440,
"topLeftCorner": [
0,
0
],
"type": "TileMatrixType"
}
]
}
}
}
}
],
"links": [
{
"href": "https://api-view.ndamaps.vn/v1/",
"rel": "root",
"title": "Instance catalog",
"type": "application/json",
"geometry": null,
"id": "",
"datetime": ""
}
],
"type": "FeatureCollection"
}
API References
| Parameter | Type | Required | Example | Description |
|---|---|---|---|---|
bbox | array[number] | no | [160.6, -55.95, -170, -25.89] | Bounding box coordinates in the format [minLon, minLat, maxLon, maxLat]. If the coordinate reference system includes height or depth, use six values: [minLon, minLat, minHeight, maxLon, maxLat, maxHeight]. |
intersects | string | no | {"type": "Point", "coordinates": [105.78, 21.03]} | The optional intersects parameter filters the result Items in the same was as bbox, only with a GeoJSON Geometry rather than a bbox. |
datetime | string | no | "2018-02-12T00:00:00Z/2018-03-18T12:31:12Z" | Filters features by date-time or interval (RFC 3339). Supports open (../..) or closed intervals. |
limit | integer | no | 20 | Number of items to include in the response. Minimum: 1, Maximum: 10000, Default: 10. |
ids | array[string] | no | ["e213daed-3ae2-4259-940b-444a4056c101"] | Array of item IDs to return. |
collections | array[string] | no | ["collection1", "collection2"] | Array of collection IDs to search within. Only items in these collections will be included in the response. |
place_position | string | no | "105.78792,21.03284" | Coordinates (longitude,latitude) of the place to find pictures. Returned pictures are either 360° or focused on the specified place. |
place_distance | string | no | "3-15" | Distance range (in meters) for finding pictures near place_position. Defaults to 3-15. |
place_fov_tolerance | integer | no | 30 | Field of view tolerance (in degrees) for centering the specified place in nearby pictures. Defaults to 30. Acceptable values range from 2 to 180. Not applicable for 360° pictures. |
API Playground
Loading...