NHỮNG CÂU HỎI THƯỜNG GẶP TRONG QUÁ TRÌNH TÍCH HỢP GOONG MAPs API

Bạn mới bắt đầu khám phá Goong Maps API và đang có vô số thắc mắc? Đừng lo, không chỉ riêng bạn, mà rất nhiều người dùng cũng có chung những câu hỏi khi bắt đầu hành trình sử dụng dịch vụ này. Từ việc đăng ký tài khoản, cách sử dụng, đến cách quản lý API key, chúng tôi sẽ giúp bạn giải đáp một cách nhanh chóng và dễ hiểu nhất. Cùng khám phá những câu hỏi thường gặp để bạn có thể tự tin sử dụng Goong Maps API ngay hôm nay!

ĐĂNG KÝ – ĐĂNG NHẬP

Làm thế nào để đăng ký và bắt đầu sử dụng API của Goong Maps?

Để 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 tại đây.

Muốn thay đổi địa chỉ email đăng ký thì làm thế nào?

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 Goong, ấ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.

Làm thế nào để xóa key khi không sử dụng nữa?

Trong trường hợp key đã tạo bạn không có nhu cầu sử dụng nữa hoặc nghi vấn bị 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 tại đây.

Làm thế nào để hủy dịch vụ hoặc đóng tài khoản khi không sử dụng nữa?

Trong trường hợp bạn không sử dụng dịch vụ Goong Maps nữa và có nhu 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. 

100$ miễn phí của Goong được tặng hàng tháng không? Và dùng đến khi nào?

Đố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ó. Bạn theo dõi và cập nhật thông tin khuyến mãi tại đây.

HÌNH THỨC THANH TOÁN

Có những phương thức thanh toán nào được hỗ trợ?

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, tham khảo các bước thanh toán chi tiết tại đây.

Chi phí sử dụng API của Goong Maps là bao nhiêu?

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.

Làm thế nào để theo dõi mức sử dụng API và số dư tài khoản?

Trên trang account.goong.io tại mục “Tổng quan” 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.

Điều gì xảy ra nếu số dư tài khoản không đủ để thanh toán vào cuối tháng?

Goong Maps 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.

Trong trường hợp tài khoản của bạn bị khóa do chưa thanh toán hóa đơn, sau khi bạn đã thanh toán, hãy liên hệ với bộ phận hỗ trợ khách hàng của Goong để được hỗ trợ mở lại tài khoản tại đây.

Có thể ký hợp đồng để sử dụng trước và trả tiền sau không?

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.

Trường hợp cần ký hợp đồng, bạn liên hệ trực tiếp với Goong để hai bên thống nhất tại đây.

GÓI CƯỚC DỊCH VỤ

Goong Maps cung cấp những dịch vụ nào và chức năng của chúng là gì?

Các dịch vụ mà Goong Maps cung cấp bao gồm:

API Maps:

  • Dịch vụ gợi ý 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 Geocode API”.
  • Dịch vụ chuyển đổi địa chỉ sang tọa độ “Forward Geocode API”.
  • Dịch vụ tính toán tuyến đường qua nhiều 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 API”.

Map: 

  • Dịch vụ bản đồ nền tương tác “Map load”.
  • Dịch vụ bản đồ tĩnh “Static Maps“.

Làm thế nào để nâng cấp hoặc thay đổi gói dịch vụ?

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.

Có giới hạn về số lượng truy vấn (request) hoặc tốc độ truy vấn không?

Goong giới hạn số lượng request theo từng gói cụ thể:

  • Gói Free: 30.000 lượt req/tháng tương ứng 1.000 req/ngày; 120.000 lượt tải bản đồ.
  • Gói Basic: 100.000 lượt req/tháng, 300 lượt req/phút, không giới hạn lượt tải bản đồ/ngày.
  • Gói Pro: 200.000 lượt req/tháng, 420 lượt req/phút, không giới hạn lượt tải bản đồ.
  • Gói Business: 400.000 lượt req/tháng, 600 lượt req/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. Liên hệ Goong ngay.

Làm thế nào để tránh việc tài khoản bị vô hiệu hóa do số dư thấp?

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.

CHÍNH SÁCH HỖ TRỢ

Goong Maps có hỗ trợ kỹ thuật cho nhà phát triển không?

Một trong những thế mạnh của Goong 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 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 tại đây.

Goong Maps hỗ trợ những nền tảng và ngôn ngữ lập trình nào?

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ợ: JS, Flutter, React native, Vue….

Làm thế nào để xử lý lỗi khi gọi API của Goong Maps?

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 để được hỗ trợ kịp thời tại đây.

Khi tạo key, Goong có cho phép giới hạn key đó chỉ được sử dụng tại Web nào? Địa chỉ IP nào không?

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.

Goong Maps có cung cấp các bản cập nhật và nâng cấp API không?

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 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.

Thông tin cập nhật sẽ được gửi về email của bạn, hoặc bạn có thể theo dõi trên kênh thông tin chính thức của Goong tại đây hoặc trên trang fanpage facebook Goong Maps.

Có tài liệu hướng dẫn hoặc mẫu code để tích hợp API không?

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 tại đây.

CÁC LỖI THƯỜNG GẶP

Khi gọi API, gặp lỗi 400 là lỗi gì?

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.

Khi gọi API, gặp lỗi 403 là lỗi gì?

Lỗi 403 xuất hiện khi tài khoản hoặc Key của bạn bị chặn, bị từ chối quyền truy cập. Có thể là do tài khoản và Key của 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, nhầm Key dẫn đến lỗi.

Để khắc phục lỗi này, bạn có thể kiểm tra lại key xem đã sử dụng đúng loại Key (API Key cho các dịch vụ Rest API, Maptiles cho hiển thị bản đồ) chưa, 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.

Khi gọi API, gặp lỗi 404 là lỗi gì?

Lỗi 404 not found có nghĩa là không tìm thấy trang web bạn cần truy cập, điều này có thể do bạn tìm sai địa chỉ url hoặc đường truyền đang trong trạng thái không ổn định. Khi gặp lỗi này, trước tiên bạn kiểm tra lại địa chỉ url đã chính xác chưa, nếu không phải do sai địa chỉ url, bạn vui lòng liên hệ với bộ phận hỗ trợ khách hàng của Goong ngay tại đây.

Khi gọi API, gặp lỗi 429 là lỗi gì?

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, trong ngày hay 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 một thời điểm, bạn có thể dừng lại một chút hoặc kiểm tra lại trong phần 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 hãy nạp tiền để nâng gói, tránh tình trạng gián đoạn. Xem các bước thanh toán tại đây.

Trong trường hợp chưa đến giới hạn mà vẫn báo lỗi này, vui lòng liên hệ Goong ngay.

Xem các gói giới hạn lưu lượng của Goong tại đây: 

 

Trên đây là các câu hỏi thường gặp và giải đáp nhanh của Goong, nếu bạn cần làm rõ thêm bất kỳ thông tin nào hay có câu hỏi nào cần Goong giải đáp, vui lòng gửi câu hỏi trực tiếp hoặc liên hệ với Goong tại đây.

Mục lục