Chuyển tới nội dung chính
Phiên bản: v1.1

Styles API

Styles API GTEL MAPS cho phép bạn truy xuất và quản lý kiểu bản đồ và hình ảnh một cách linh hoạt.

Liệt kê Styles API​

Loading...

Yêu cầu mẫu: Liệt kê Styles API​

Loading...

Phản hồi mẫu: Liệt kê Styles API​

ID kiểuURL KiểuHình ảnh
gtelmaps-basic-v1{{API_BASE_URL}}/api/styles/v1/gtelmaps-basic-v1/style.json?apikey={YOUR_API_KEY}
gtelmaps-light-v1{{API_BASE_URL}}/api/styles/v1/gtelmaps-light-v1/style.json?apikey={YOUR_API_KEY}
gtelmaps-satellite-v1{{API_BASE_URL}}/api/styles/v1/gtelmaps-satellite-v1/style.json?apikey={YOUR_API_KEY}
gtelmaps-navigation-day-v1{{API_BASE_URL}}/api/styles/v1/gtelmaps-navigation-day-v1/style.json?apikey={YOUR_API_KEY}
gtelmaps-dark-v1{{API_BASE_URL}}/api/styles/v1/gtelmaps-dark-v1/style.json?apikey={YOUR_API_KEY}
gtelmaps-satellite-streets-v1{{API_BASE_URL}}/api/styles/v1/gtelmaps-satellite-streets-v1/style.json?apikey={YOUR_API_KEY}
gtelmaps-streets-hcm-v1{{API_BASE_URL}}/api/styles/v1/gtelmaps-streets-hcm-v1/style.json?apikey={YOUR_API_KEY}
gtelmaps-navigation-night-v1{{API_BASE_URL}}/api/styles/v1/gtelmaps-navigation-night-v1/style.json?apikey={YOUR_API_KEY}
gtelmaps-dark-vms-v1{{API_BASE_URL}}/api/styles/v1/gtelmaps-dark-vms-v1/style.json?apikey={YOUR_API_KEY}
gtelmaps-streets-v1{{API_BASE_URL}}/api/styles/v1/gtelmaps-streets-v1/style.json?apikey={YOUR_API_KEY}
gtelmaps-only-traffic-v1{{API_BASE_URL}}/api/styles/v1/gtelmaps-only-traffic-v1/style.json?apikey={YOUR_API_KEY}
gtelmaps-only-traffic-dark-v1{{API_BASE_URL}}/api/styles/v1/gtelmaps-only-traffic-dark-v1/style.json?apikey={YOUR_API_KEY}
[
  {
    "version": 8,
    "name": "GTEL MAPS - Basic v1",
    "id": "gtelmaps-basic-v1"
  },
  {
    "version": 8,
    "name": "GTEL MAPS - Light v1",
    "id": "gtelmaps-light-v1"
  },
  {
    "version": 8,
    "name": "GTEL MAPS - Satellite v1",
    "id": "gtelmaps-satellite-v1"
  },
  {
    "version": 8,
    "name": "GTEL MAPS - Navigation Day v1",
    "id": "gtelmaps-navigation-day-v1"
  },
  {
    "version": 8,
    "name": "GTEL MAPS - Dark v1",
    "id": "gtelmaps-dark-v1"
  },
  {
    "version": 8,
    "name": "GTEL MAPS - Satellite - Streets v1",
    "id": "gtelmaps-satellite-streets-v1"
  },
  {
    "version": 8,
    "name": "GTEL MAPS - Streets - HCM v1",
    "id": "gtelmaps-streets-hcm-v1"
  },
  {
    "version": 8,
    "name": "GTEL MAPS - Navigation Night v1",
    "id": "gtelmaps-navigation-night-v1"
  },
  {
    "version": 8,
    "name": "GTEL MAPS - Dark - VMS v1",
    "id": "gtelmaps-dark-vms-v1"
  },
  {
    "version": 8,
    "name": "GTEL MAPS - Streets v1",
    "id": "gtelmaps-streets-v1"
  },
  {
    "version": 8,
    "name": "GTEL MAPS - Only Traffic v1",
    "id": "gtelmaps-only-traffic-v1"
  },
  {
    "version": 8,
    "name": "GTEL MAPS - Only Traffic Dark v1",
    "id": "gtelmaps-only-traffic-dark-v1"
  }
]

Truy xuất cấu hình kiểu bản đồ​

Truy xuất cấu hình kiểu bản đồ đầy đủ bao gồm các lớp (layers), nguồn (sources), sprites và fonts (glyphs).

Loading...
Tham số bắt buộcKiểu dữ liệuMô tả
namestringID của bản đồ mà bạn muốn truy cập xem thêm tại Liệt kê Styles API
Tham số tuỳ chọnKiểu dữ liệuMô tả
poi_visibilitystringKiểm soát hiển thị lớp POI.
Giá trị: none (ẩn hết).

Kiểm soát hiển thị POI:

  • poi_visibility=none - Ẩn tất cả các lớp POI

Phản hồi:

Trả về đối tượng JSON chứa cấu hình kiểu bản đồ. Phản hồi được sửa đổi để bao gồm:

  • licence - Thêm trường giá trị "© GTEL Maps"
  • Tự động chèn API key - Tham số apikey được tự động thêm vào các URL trong:
    • sprite - Sprite sheet URLs
    • glyphs - Font glyph URLs
    • tiles - Tile source URLs
  • Hiển thị lớp POI - Khi poi_visibility=none, tất cả các lớp POI (các lớp symbol với source và source-layer cụ thể) sẽ có thuộc tính layout.visibility được đặt thành "none"

Yêu cầu mẫu: Truy xuất cấu hình kiểu bản đồ​

Loading...

Phản hồi mẫu: Truy xuất cấu hình kiểu bản đồ​

{
"version": 8,
"name": "GTEL Maps Streets",
"sprite": "https://maps.ots.vn/api/styles/v1/gtelmaps-streets-v1/sprite?apikey={YOUR_API_KEY}",
"glyphs": "https://maps.ots.vn/api/fonts/{fontstack}/{range}.pbf?apikey={YOUR_API_KEY}",
"sources": {
  "gtelmaps": {
    "type": "vector",
    "tiles": [
      "https://maps.ots.vn/api/tiles/v1/gtelmaps/{z}/{x}/{y}.pbf?apikey={YOUR_API_KEY}"
    ]
  }
},
"layers": [
  {
    "id": "background",
    "type": "background",
    "paint": { "background-color": "#f8f4f0" }
  },
  {
    "id": "poi-restaurant",
    "type": "symbol",
    "source": "gtelmaps",
    "source-layer": "poi_label",
    "layout": {
      "visibility": "none"
    }
  }
],
"licence": "© GTEL Maps"
}
Điểm nổi bật
  • ✅ Trường licence được thêm vào
  • ✅ Tham số apikey được tự động chèn vào URL sprite, glyphs, và tiles
  • ✅ Thuộc tính visibility của lớp POI được đặt thành "none" khi sử dụng poi_visibility=none

Lấy metadata tile của kiểu bản đồ​

Truy xuất metadata (TileJSON) cho một kiểu bản đồ cụ thể.

Loading...
Tham số bắt buộcKiểu dữ liệuMô tả
namestringID của bản đồ mà bạn muốn truy cập xem thêm tại Liệt kê Styles API

Phản hồi:

Trả về đặc tả TileJSON chứa metadata của tiles. Phản hồi được sửa đổi để bao gồm:

  • licence - Thêm trường giá trị "© GTEL Maps"
  • Tự động chèn API key - Tham số apikey được tự động thêm vào các URL tiles

Yêu cầu mẫu: Lấy metadata tile của kiểu bản đồ​

Loading...

Phản hồi mẫu: Lấy metadata tile của kiểu bản đồ​

{
"tilejson": "2.0.0",
"name": "GTEL Maps Streets",
"version": "1.0.0",
"scheme": "xyz",
"tiles": [
  "https://maps.ots.vn/api/styles/v1/gtelmaps-streets-v1/{z}/{x}/{y}.png?apikey={YOUR_API_KEY}"
],
"minzoom": 0,
"maxzoom": 14,
"bounds": [-180, -85.0511, 180, 85.0511],
"center": [0, 0, 0],
"licence": "© GTEL Maps"
}
Điểm nổi bật
  • ✅ Trường licence được thêm vào
  • ✅ Tham số apikey được tự động chèn vào URL tiles

Lấy thông tin metadata của tile dữ liệu​

Truy xuất metadata (TileJSON) cho một nguồn dữ liệu cụ thể.

Loading...
Tham số bắt buộcKiểu dữ liệuMô tả
namestringID của bản đồ mà bạn muốn truy cập xem thêm tại Liệt kê Styles API

Phản hồi:

Trả về đặc tả TileJSON cho nguồn dữ liệu. Phản hồi được sửa đổi để bao gồm:

  • licence - Thêm trường giá trị "© GTEL Maps"
  • Tự động chèn API key - Tham số apikey được tự động thêm vào các URL tiles

Yêu cầu mẫu: Lấy thông tin metadata của tile dữ liệu​

Loading...

Phản hồi mẫu: Lấy thông tin metadata của tile dữ liệu​

{
"tilejson": "2.0.0",
"name": "GTEL Maps Data",
"version": "1.0.0",
"scheme": "xyz",
"tiles": [
  "https://maps.ots.vn/api/tiles/v1/gtelmaps/{z}/{x}/{y}.pbf?apikey={YOUR_API_KEY}"
],
"minzoom": 0,
"maxzoom": 14,
"bounds": [-180, -85.0511, 180, 85.0511],
"center": [0, 0, 0],
"vector_layers": [
  {
    "id": "water",
    "fields": { "class": "String" }
  },
  {
    "id": "road",
    "fields": { "class": "String", "name": "String" }
  }
],
"licence": "© GTEL Maps"
}
Điểm nổi bật
  • ✅ Trường licence được thêm vào
  • ✅ Tham số apikey được tự động chèn vào URL tiles