Maps Javascript APIs

Phiên bản hiện tại: v1.0.0

Chú ý:

Để sử dụng bất kỳ API nào của Map Platform, bạn sẽ cần khóa API. Hãy liên hệ với chúng tôi để được cấp khóa API và sử dụng miễn phí

Giới thiệu

HueMap Platform Maps JavaScript là một thư viện JavaScript được phát triển mở rộng dựa trên nền tảng Mapbox GL JS, cung cấp các Javascript API cho phép bạn dễ dàng sử dụng HueMap Platform Maps APIs. Ngoài những tính năng cơ bản của Mapbox GL JS, chúng tôi có bổ sung thêm nhiều tính năng và tiện ích để bạn sử dụng HueMap Platform Maps APIs một cách nhanh chóng và dễ dàng nhất.

Bạn có thể truy cập địa chỉ Live Map để trải nghiệm các API do HueMap Platform cung cấp

Bắt đầu nhanh

Trước khi sử dụng bạn cần tham chiếu để sử dụng thư viện Mapbox GL JS. Ví dụ sử dụng thư viện Mapbox GL JS phiên bản 1.13.0:

<!-- Mapbox GL JS -->
<script src='https://api.mapbox.com/mapbox-gl-js/v1.13.0/mapbox-gl.js'></script>
<link href='https://api.mapbox.com/mapbox-gl-js/v1.13.0/mapbox-gl.css' rel='stylesheet' />

và thư viện JavaScript do HueMap Platform cung cấp. Ví dụ như sau:

<!-- HueMap Platform JS -->
<script src='https://mapplatform.tthue.vn/sdks/huemap-platform-v1.0.0.min.js'></script>
<link href='https://mapplatform.tthue.vn/sdks/huemap-platform-v1.0.0.min.css' rel='stylesheet' />

Lưu ý (*): Nếu bạn sử dụng phiên bản Mapbox GL JS từ phiên bản 2.0 trở lên bạn cần phải có accessToken, bạn có thể dễ dàng đăng ký tại đây. Ví dụ sử dụng thư viện Mapbox GL JS phiên bản 2.7.0 như sau:

<!-- Mapbox GL JS -->
<script src='https://api.mapbox.com/mapbox-gl-js/v2.7.0/mapbox-gl.js'></script>
<link href='https://api.mapbox.com/mapbox-gl-js/v2.7.0/mapbox-gl.css' rel='stylesheet' />
<script>
	// TO MAKE THE MAP APPEAR YOU MUST
	// ADD YOUR ACCESS TOKEN FROM
	// https://account.mapbox.com
	mapboxgl.accessToken = 'YOUR_MAPBOX_ACCESS_TOKEN';
 
//your code here
</script>

Tài liệu này dành cho ai

Tài liệu này được thiết kế cho những người đã quen với ngôn ngữ JavaScript và khái niệm lập trình hướng đối tượng.

Tại liệu này được thiết kế để giúp bạn nhanh chóng bắt đầu khám phá và xây dựng ứng dụng với Maps JavaScript API.

Cách sử dụng khóa API

Cách dễ nhất để bắt đầu với API JavaScript của HueMap Platform là xem một ví dụ đơn giản. Trang web sau đây hiển thị bản đồ Huế do HueMap Platform cung cấp:

Lưu ý (*) HueMap Platform Maps JavaScript luôn yêu cầu api_key trong mọi Javascript API, ở ví dụ dưới đây bạn hãy thay giá trị api_key vào chuỗi ký tự {YOUR_API_KEY} để sử dụng:

<!DOCTYPE html>
<html lang="en">
 
<head>
<meta charset="utf-8" />
<script src='https://api.mapbox.com/mapbox-gl-js/v1.13.0/mapbox-gl.js'></script>
<link href='https://api.mapbox.com/mapbox-gl-js/v1.13.0/mapbox-gl.css' rel='stylesheet' />
<!-- HueMap Platform JS -->
<script src='https://mapplatform.tthue.vn/sdks/huemap-platform-v1.0.0.min.js'></script>
<link href='https://mapplatform.tthue.vn/sdks/huemap-platform-v1.0.0.min.css' rel='stylesheet' />
 
<title>Base Map Bright</title>
<style>
.map {
width: 100%;
height: calc(100vh - 15px);
}
 
body {
overflow: hidden;
}
 
</style>
</head>
 
<body>
<div style="width: 100%;">
<div id="divMapId" class="map"></div>
</div>
<script>
var map = new mapboxgl.Map({
container: 'divMapId',center: [107.5402, 16.4386],
zoom: 10.68
});
var mapOSMBright = new huemapplf.VectorBaseMap('Province:Bright', '{YOUR_API_KEY}').addTo(map);
</script>
</body>
 
</html>

Giới hạn về số lượng Request

Hãy liên hệ với chúng tôi để được cấp khóa API và sử dụng miễn phí

Một số trạng thái lỗi khi sử dụng

Mã lỗi	HTTP Status Code	Mô tả
`API_KEY_MISSING`	403	Khóa API không được cung cấp. Xem cách sử dụng khóa API để biết chi tiết
`API_KEY_INVALID`	403	Khóa API không hợp lệ
`API_KEY_DISABLED`	403	Khóa API đã bị quản trị viên vô hiệu hóa
`API_KEY_UNAUTHORIZED`	403	Khóa API không được phép truy cập vào dịch vụ
`API_KEY_UNVERIFIED`	403	Khóa API được cung cấp vẫn chưa được xác minh
`HTTPS_REQUIRED`	400	Yêu cầu đối với API này phải được thực hiện qua HTTPS
`OVER_RATE_LIMIT`	429	Khóa API đã vượt quá giới hạn tốc độ, xem giới hạn
`NOT_FOUND`	404	Không thể tìm thấy API tại URL đã cho. Kiểm tra URL của bạn.

Giá cả