Dynamic
The Streetview.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
Streetview.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.
tip
When using that, just use our Enterprise Dashboard or guild API Key to create your API Key try for free!
Base URL
https://api.streetview.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/streetview-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/streetview-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/streetview-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/streetview-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": "http://api.streetview.vn/v1/",
"rel": "root",
"title": "Instance catalog",
"type": "application/json",
"geometry": null,
"id": "",
"datetime": ""
},
{
"href": "http://api.streetview.vn/v1/collections/af0e6ea5-5e1c-4730-9f66-b147c19dfa76",
"rel": "parent",
"title": "Instance catalog",
"type": "application/json",
"geometry": null,
"id": "",
"datetime": ""
},
{
"href": "http://api.streetview.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": "http://api.streetview.vn/v1/collections/af0e6ea5-5e1c-4730-9f66-b147c19dfa76",
"rel": "collection",
"title": "",
"type": "application/json",
"geometry": null,
"id": "",
"datetime": ""
},
{
"href": "http://api.streetview.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": "http://api.streetview.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,
"streetview_vn:image": "https://hn.storage.weodata.vn/streetview-cdn/main-pictures/f8/e6/4d/0c/e875-4bbc-8ac9-c26eae1d2e1f.jpg",
"streetview_vn:producer": "giangdd",
"streetview_vn:status": "ready",
"streetview_vn:thumbnail": "https://hn.storage.weodata.vn/streetview-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,
"streetview_vn": {
"identifier": "streetview_vn-f8e64d0c-e875-4bbc-8ac9-c26eae1d2e1f",
"title": "StreetViewVN 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": "http://api.streetview.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...