TÀI LIỆU NỀN TẢNG GOONG MAPS

Ví dụ, Tài liệu tham khảo/ hướng dẫn người dùng tích hợp và sử dụng các API và thư viện bản đồ (SDK) của Goong vào hệ thống, ứng dụng web/app của mình một cách đầy đủ và chi tiết

Phổ biến:

Khái quát

Tổng Quan

Giới thiệu tổng quan các dịch vụ

Tóm tắt tổng quát tất cả những thông tin cơ bản nhất các dịch vụ Maps & APIs trên nền tảng Goong Maps cung cấp.

Xem thêm

Hướng dẫn tạo tài khoản & key

Khám phá, tìm hiểu cách thiết lập những thông tin cơ bản để bắt đầu sử dụng dịch vụ Maps và API trên nền tảng Goong Maps.

Xem thêm

Thiết lập giới hạn URL/IP cho API key

Hướng dẫn chi tiết các bước thiết lập giới hạn URL/IP cho API KEY, bảo vệ an toàn cho hệ thống và bảo mật thông tin KEY của bạn.

Xem thêm
Phân loại

Maps

Hướng dẫn tích hợp bản đồ tùy chỉnh vào web hoặc ứng dụng di động của bạn.
icon image

Static maps

Hướng dẫn tích hợp Static maps (Bản đồ tĩnh) vào nền tảng / ứng dụng web / mobile của bạn.

URL
icon image

Javascrip API

Thêm bản đồ tương tác (Bản đồ động) tùy chỉnh vào ứng dụng/ nền tảng trên Website của bạn

Maplibre Mapbox Features
icon image

Mobile SDK

Thêm bản đồ tương tác tùy chỉnh (bản đồ độn) vào ứng dụng di động

Ios Android Flutter React Native
Sản phẩm

REST APIS

Hướng dẫn tích hợp các APIs Maps của Goong vào ứng dụng, nền tảng của bạn Để có thể tích hợp và sử dụng được các API của Goong, bạn cần có API Key hợp lệ.

Autocomplete

Hướng dẫn cách tích hợp hoạt động tìm kiếm và tính năng tự động hoàn hành của Goong vào ứng dụng của bạn.

Place Detail

Hướng dẫn cách tích hợp tính năng thông tin chi tiết địa điểm vào ứng dụng của bạn.

Direction

Hướng dẫn tích hợp API tính toán khoảng cách và chỉ đường cho nhiều loại phương tiện khác nhau.

Geocoding

Chuyển đổi tọa độ thành địa chỉ và địa chỉ thành tọa độ trên ứng dụng của bạn.

Distance matrix

Ma trận khoảng cách - Tính toán thời gian di chuyển và khoảng cách cho nhiều điểm xuất phát và điểm đến.

Trip

Tối ưu hóa cho tuyến đường nhiều điểm đến cho một hoặc nhiều xe trên khoảng cách, thông tin giao thông và thời gian thực.

Hỗ trợ thêm
Hỏi đáp

Câu hỏi thường gặp

Để sử dụng Goong Maps, trước tiên bạn phải có tài khoản. Truy cập https://account.goong.io/ để đăng ký tài khoản, sau khi tài khoản đã được active, tạo API key và tích hợp API vào hệ thống theo hướng dẫn.

Trường hợp khách hàng muốn thay đổi địa chỉ email tài khoản đã đăng ký, bạn truy cập vào mục cài đặt trong thông tin tài khoản, ấn chọn “Chuyển Email” sau đó nhập thông tin theo hướng dẫn và ấn “Cập nhật thông tin” Goong sẽ hỗ trợ thay đổi địa chỉ email sau khi nhận được lệnh.

Trong trường hợp key đã tạo bạn không có nhu cầu sử dụng nữa hoặc có nghi vấn bị tiết lộ ra bên ngoài, bạn liên hệ với bộ phận hỗ trợ kỹ thuật của Goong để được xóa key.

Trong trường hợp bạn không sử dụng dịch vụ Goong Map nữa và có như cầu đóng tài khoản, bạn vui lòng thực hiện đầy đủ nghĩa vụ thanh toán nếu có với Goong, sau đó liên hệ với bộ phận hỗ trợ khách hàng của Goong để được hỗ trợ vô hiệu hóa tài khoản đó lại.

Đối với 100$ tặng khuyến mãi, Goong tặng một lần duy nhất ngay khi bạn đăng ký tài khoản chứ không phải tặng hàng tháng. Và số tiền này bạn có thể sử dụng đến khi hết, không bị giới hạn về thời gian.Về chương trình khuyến mãi, Goong sẽ có thông báo cụ thể đến khách về thể thức áp dụng và thời gian nếu có.

Goong hỗ trợ hai phương thức thanh toán là chuyển khoản và thanh toán qua Vnpay.Trong quá trình thanh toán, bạn nhập nội dung theo đúng quy trình hướng dẫn của Goong tại đây.

Về chi phí sử dụng, Goong tính phí theo số lượng API thực tế sử dụng hàng tháng dựa trên đơn giá cụ thể theo từng loại API. Có thể tham khảo bảng giá tại đây.

Trên account.goong (Tài khoản) Tại trang tổng quan, mục này có thống kê toàn bộ thông tin: Số dư, số tiền tạm tính, số lượng request của từng loại API theo thời gian thực. Bạn có thể theo dõi thống kê tại đây.

Goong Map sẽ thống kê và thanh toán vào ngày cuối cùng của tháng. Trong trường hợp số dư của bạn không đủ để thanh toán hóa đơn, chậm nhất cho đến ngày 15 tháng kế tiếp, bạn phải nạp tiền vào tài khoản để thực hiện việc thanh toán. Sau ngày 15 nếu bạn vẫn chưa thanh toán hết hóa đơn của tháng trước, tài khoản của bạn sẽ tự động bị vô hiệu hóa cho đến khi thanh toán đủ tiền.

Trường hợp khách hàng có nhu cầu ký hợp đồng, chính sách thanh toán khi ký hợp đồng của Goong là sử dụng trước và thanh toán vào cuối tháng. Hình thức thanh toán là hai bên đối chiếu thanh toán vào cuối tháng. Trường hợp số tiền phải thanh toán ít hơn 5 triệu, bạn thanh toán đủ 5 triệu.
Trường hợp nhiều hơn 5 triệu, bạn thanh toán đúng số tiền.

Các dịch vụ mà Goong Maps cung cấp bao gồm:
  • API Maps:
    • Dịch vụ tìm kiếm địa điểm “Autocomplete API”.
    • Dịch vụ thông tin chi tiết địa điểm “Place Detail API”.
    • Dịch vụ chuyển đổi tọa độ sang địa chỉ “Reverse Geocoding”.
    • Dịch vụ chuyển đổi địa chỉ sang tọa độ “Forward Geocoding”
    • Dịch vụ tính toán tuyến đường qua đa tọa độ “Directions API”.
    • Dịch vụ tính toán ma trận tuyến đường cho nhiều cặp tọa độ (điểm khởi đầu và điểm đến) “Distance Matrix API”.
    • Dịch vụ tuyến đường tối ưu “Trip”.
  • Map:
    • Dịch vụ bản đồ nền tương tác “Mapload”.
    • Dịch vụ bản đồ tĩnh “Static maps”

Trong trường hợp bạn muốn năng cấp gói dịch vụ đang sử dụng để nâng giới hạn lưu lượng, bạn nạp tiền vào tài khoản số tiền tối thiểu tương ứng với các gói Basic, Pro, Business của Goong đã quy định. Hệ thống sẽ tự động xác nhận và nâng cấp tài khoản của bạn.

Goong giới hạn số lượng request theo từng gói cụ thể:
  • Gói Free: 30.000 lượt rq/tháng tương ứng 1.000 rq/ngày; 120.000 lượt tải bản đồ.
  • Gói Basic: 100.000 lượt rq/tháng, 300 lượt/phút, không giới hạn lượt tải bản đồ/ ngày.
  • Gói Business: 200.000 lượt/tháng, 420 lượt/phút, không giới hạn lượt tải bản đồ.
  • Ký hợp đồng: Trong trường hợp bạn cần sử dụng ở mức lưu lượng lớn mà không muốn bị giới hạn, bạn có thể chuyển sang hình thức ký hợp đồng.

Hệ thống sẽ tự động vô hiệu hóa trong trường hợp số tiền tạm tính của bạn vượt quá 25% số dư. Goong sẽ gửi mail cảnh báo đến bạn khi số tiền tạm tính của bạn vượt quá 10% số dư. Chính vì vậy Goong khuyến nghị bạn thường xuyên kiểm soát số dư trong tài khoản để tránh trường hợp tài khoản bị vô hiệu hóa, gây gián đoạn trong quá trình sử dụng.

Một trong những thế mạnh của Goong Map là ưu tiên hỗ trợ khách hàng.Trong quá trình tích hợp có vướng mắc, hoặc có phát sinh vấn đề trong quá trình sử dụng, bạn vui lòng liên hệ ngay với bộ phận hỗ trợ và chăm sóc khách hàng của Goong để được hỗ trợ kịp thời.

Goong hỗ trợ trên tất cả các nền tảng web/Android/Ios.
Các ngôn ngữ lập trình Goong hỗ trợ bao gồm: JS, Flutter, React native, Vue, swift, objective-C

Trong quá trình sử dụng API của Goong gặp lỗi, bạn kiểm tra kỹ hệ thống phản hồi lỗi cụ thể và báo lại với bộ phận hỗ trợ khách hàng của Goong Map để được hỗ trợ kịp thời.

Khi tạo key, bạn hoàn toàn có thể thiết lập giới hạn cho các Key đó được sử dụng duy nhất tại một địa chỉ IP hoặc địa chỉ web nhất định. Bạn có thể tham khảo chi tiết tại hướng dẫn tạo KEY tại đây.

Việc cập nhật dữ liệu và nâng cấp hệ thống là một trong những việc quan trọng và được Goong cập nhật định kỳ.
Về dữ liệu, Goong cập nhật tối thiểu 2 lần/tháng.
Về nâng cấp hệ thống: Goong cũng liên tục cập nhật các tính năng, công nghệ mới và sửa lỗi thường xuyên. Khi có lịch, Goong sẽ có thông báo cụ thể về nội dung và thời gian cập nhật.

Goong có đầy đủ hướng dẫn từ việc bắt đầu đăng ký, tạo key cho đến hướng dẫn tích hợp từng loại API, tích hợp Map. Và các ví dụ cụ thể. Bạn tham khảo tai đây.

Lỗi 400 (Bad Request): Là mã trạng thái cho biết yêu cầu bạn gửi đến Goong bị sai hoặc gián đoạn và Server sẽ không hiểu request này. Có thể do url có dữ liệu không hợp lệ, thông tin gửi thiếu hoặc sai định dạng, Cookie hoặc cache lỗi.
Để khắc phục lỗi này, bạn có thể kiểm tra lại link url, dữ liệu có hợp lệ hay không, hoặc xóa Cookie hoặc cache và thử lại.

Lỗi 403 xuất hiện khi tài khoản hoặc Key của bạn bị chặn, từ chối quyền truy cập. Có thể là do tài khoản và key cua bạn đã bị vô hiệu hóa hoặc cấu hình sai thiết lập giới hạn cho Key, thiếu key dẫn đến lỗi.
Để khắc phục lỗi này, bạn có thể kiểm tra lại phần cấu hình key, kiểm tra lại hóa đơn tháng trước đã thanh toán chưa hoặc liên hệ với bộ phận hỗ trợ khách hàng của Goong.

Lỗi 404 not found có nghĩa là trang web của bạn không tồn tại, điều này có thể do sever đang gặp vấn đề hoặc trong trạng thái không ổn định. Khi gặp lỗi này, bạn vui lòng liên hệ với bộ phận hỗ trợ khách hàng của Goong ngay.

Lỗi 429 (OVER RATE LIMIT) có nghĩa là Key của bạn đã quá giới hạn lượt request và không thể gọi được API thêm nữa. Có thể do trong thời gian ngắn, bạn gọi liên tục quá nhiều, dẫn đến giới hạn theo phút. Có thể vượt quá giới hạn trong ngày, và trong tháng theo gói dịch vụ bạn đang sử dụng.
Trong trường hợp gặp phải lỗi này, nếu bạn gọi quá nhiều trong 1 thời điểm, bạn có thể dừng lại một chút. Hoặc kiểm tra lại trong thống kê đã gọi vượt quá giới hạn hay chưa. Nếu cần sử dụng nhiều hơn gói bạn đang áp dụng có thể nạp tiền để nâng gói, tránh tình trạng gián đoạn.
Trong trường hợp chưa đến giới hạn mà vẫn báo lỗi này, bận vui lòng liên hệ Goong ngay.
[Chưa có tài khoản Goong] Đăng kí tại đây >>