Streetview.vn Dynamic APIs

Streetview.vn - Dynamic API cung cấp khả năng tìm kiếm và truy vấn dữ liệu hình ảnh đường phố Việt Nam, hỗ trợ các bộ lọc và tùy chỉnh khác nhau để tinh chỉnh kết quả trả về chính xác với địa điểm trên bản đồ mà bạn mong muốn.

Mô tả

Streetview.vn Dynamic API cho phép người dùng tìm kiếm hình ảnh 360° hoặc hình ảnh tập trung vào một vị trí cụ thể trên đường phố tại Việt Nam. Người dùng có thể áp dụng bộ lọc dựa trên tọa độ gps, thời gian hoặc các thuộc tính khác để có được kết quả có liên quan nhất đến địa điểm đó.

mẹo

Hãy sử dụng Enterprise Dashboard hoặc hướng dẫn API Key để tạo API Key và trải nghiệm miễn phí!

Base URL

https://api.streetview.vn/v1

Endpoint

GET /search

Ví dụ

Yêu cầu:

GET /search?place_position=105.788024983,21.032796623&limit=1

Trả về:

{
  "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"
}

Tham chiếu API

Tham số	Loại	Bắt buộc	Ví dụ	Mô tả
`bbox`	array[number]	no	`[160.6, -55.95, -170, -25.89]`	Tọa độ hộp giới hạn theo định dạng `[minLon, minLat, maxLon, maxLat]`. Nếu hệ tọa độ tham chiếu bao gồm chiều cao hoặc độ sâu, sử dụng sáu giá trị: `[minLon, minLat, minHeight, maxLon, maxLat, maxHeight]`.
`intersects`	string	no	`{"type": "Point", "coordinates": [105.78, 21.03]}`	Tham số intersects tùy chọn lọc các mục kết quả tương tự như bbox, nhưng sử dụng một Hình học GeoJSON thay vì bbox.
`datetime`	string	no	`"2018-02-12T00:00:00Z/2018-03-18T12:31:12Z"`	Lọc các đối tượng theo ngày-giờ hoặc khoảng thời gian (theo chuẩn RFC 3339). Hỗ trợ khoảng mở (../..) hoặc đóng.
`limit`	integer	no	`20`	Số lượng mục được bao gồm trong phản hồi. Tối thiểu: `1`, Tối đa: `10000`, Mặc định: `10`.
`ids`	array[string]	no	`["e213daed-3ae2-4259-940b-444a4056c101"]`	Mảng các ID của mục cần trả về.
`collections`	array[string]	no	`["collection1", "collection2"]`	Mảng các ID bộ sưu tập để tìm kiếm. Chỉ các mục trong các bộ sưu tập này sẽ được bao gồm trong phản hồi.
`place_position`	string	no	`"105.78792,21.03284"`	Tọa độ (`longitude,latitude`) của vị trí cần tìm ảnh. Các ảnh trả về có thể là 360° hoặc tập trung vào vị trí đã chỉ định.
`place_distance`	string	no	`"3-15"`	Khoảng cách (tính bằng mét) để tìm ảnh gần `place_position`. Mặc định là `3-15`.
`place_fov_tolerance`	integer	no	`30`	Độ dung sai góc nhìn (tính bằng độ) để tập trung vị trí đã chỉ định trong các ảnh gần đó. Mặc định là `30`. Giá trị chấp nhận từ `2` đến `180`. Không áp dụng cho ảnh 360°.

Streetview.vn Dynamic APIs

Mô tả​

Base URL​

Endpoint​

Ví dụ​

Tham chiếu API​

API Playground​

Mô tả

Base URL

Endpoint

Ví dụ

Tham chiếu API

API Playground