Nơi quản lý Client-ID trong Google Cloud Console
Chức năng quản lý mã ứng dụng khách của Gói đặc biệt có trong Cloud Console ở cuối trang Thông tin xác thực của nền tảng Google Maps, trong phần Mã ứng dụng khách.
Bạn có thể truy cập vào các tác vụ quản lý mã ứng dụng khách khác, bao gồm cả việc uỷ quyền URL và quản lý bí mật ký mã ứng dụng khách, trên trang Mã ứng dụng khách riêng biệt, bằng cách nhấp vào biểu tượng chỉnh sửa ở ngoài cùng bên phải của phần Mã ứng dụng khách.
Lưu ý quan trọng: Gói Google Maps Platform cao cấp sẽ không còn được cung cấp để đăng ký hoặc trở thành khách hàng mới nữa.
Đảm bảo nhóm của bạn có quyền truy cập vào các tài nguyên cần thiết
Sử dụng Google Cloud Console
Tại sao lại quan trọng: Google Cloud Console cấp cho bạn quyền truy cập vào các thông tin như báo cáo sử dụng, nguồn cấp tin tức và tài nguyên dành cho nhà phát triển. Quan trọng hơn, Cloud Console cho phép bạn gửi yêu cầu hỗ trợ cho nhóm hỗ trợ của Nền tảng Google Maps nếu bạn gặp bất kỳ vấn đề kỹ thuật nào trong quá trình phát triển hoặc ra mắt.
Trước khi phát hành, hãy cấp quyền truy cập vào Cloud Console cho tất cả những nhà phát triển chịu trách nhiệm bảo trì ứng dụng. Nếu bạn gặp vấn đề kỹ thuật, khi có quyền truy cập vào Cloud Console, các thành viên trong nhóm của bạn có thể liên hệ với bộ phận hỗ trợ, đồng thời cho phép nhóm hỗ trợ của chúng tôi liên hệ với những bên liên quan thích hợp trong tổ chức của bạn. Ví dụ: nhóm hỗ trợ có thể cần liên hệ với tổ chức của bạn nếu chúng tôi phát hiện lưu lượng truy cập hoặc hành vi bất thường có thể làm hỏng ứng dụng của bạn. Việc đảm bảo rằng chúng tôi có thể liên hệ với những nhà phát triển phù hợp có thể giúp tạo ra sự khác biệt giữa việc gặp sự cố ngừng dịch vụ ngoài dự kiến và ngăn chặn sự cố ngừng dịch vụ.
Đăng ký nhận các nhóm email thông báo
Tại sao điều này quan trọng: Để đảm bảo bạn luôn nắm bắt được các diễn biến và thay đổi trên các API Maps, bạn nên đăng ký một hoặc nhiều nhóm email sau:
- google-maps-platform-notification – Cập nhật kỹ thuật về các dịch vụ web và API Google Maps Platform, thông báo về việc ngừng hoạt động và thông báo về tính năng của nền tảng (~3-5 thông báo mỗi tháng).
- google-maps-js-api-v3-notify – Các bản phát hành mới của API JavaScript của Google Maps (khoảng 4 thông báo mỗi năm).
Tối ưu hoá ứng dụng của bạn
Định cấu hình tường lửa để cho phép truy cập vào Dịch vụ nền tảng Google Maps
Tại sao lại quan trọng: Các dịch vụ của Nền tảng Google Maps sử dụng nhiều miền, một số miền trong số đó không thuộc miền *google.com. Nếu đang sử dụng tường lửa hạn chế, bạn cần phải cho phép truy cập vào các miền mà từng dịch vụ API Maps sử dụng. Nếu tường lửa của bạn không cho phép truy cập vào những miền này, thì các yêu cầu API sẽ không thực hiện được và có thể làm hỏng ứng dụng của bạn. Xem danh sách đầy đủ các miền mà API Maps sử dụng.
Bạn không nên quản lý các quy định hạn chế đối với tường lửa theo địa chỉ IP, vì các IP liên kết với những miền này không ở dạng tĩnh.
Lưu ý: Các dịch vụ của Nền tảng Google Maps sử dụng cổng 80 (http) và 443 (https) cho lưu lượng truy cập đến và đi. Những dịch vụ này cũng đòi hỏi các yêu cầu GET, POST, PUT, DELETE và HEAD. Định cấu hình tường lửa để cho phép lưu lượng truy cập qua các cổng này và cho phép các yêu cầu, tuỳ thuộc vào API và trường hợp sử dụng.
Cho phép miền SSL của bạn sử dụng với Maps JavaScript API
Lý do quan trọng: Khi sử dụng API JavaScript của Maps với miền SSL, bạn phải uỷ quyền các miền HTTPS một cách rõ ràng để đảm bảo yêu cầu của bạn không bị từ chối. Xin lưu ý rằng việc uỷ quyền cho http://yourdomain.com không tự động kích hoạt phiên bản SSL tương đương https://yourdomain.com. Hãy kiểm tra danh sách miền được phép trong Cloud Console bằng cách di chuyển xuống phần Mã ứng dụng khách. Để khắc phục lỗi liên quan đến việc sử dụng API phía máy khách với miền SSL, hãy kiểm tra xem có phần tử nào trên trang của bạn được tải qua HTTP hay không. Xem hướng dẫn khắc phục sự cố uỷ quyền.
Chọn phiên bản API thích hợp
Tại sao điều này lại quan trọng: Trước khi phát triển ứng dụng, bạn cần biết phiên bản API nào không dùng nữa. Việc chọn phát triển trên các phiên bản API vẫn được sử dụng sẽ giúp bạn tiết kiệm thời gian phát triển và tiết kiệm chi phí khi các phiên bản không dùng nữa.
Cụ thể, bạn cần phải hiểu rõ giao thức tạo phiên bản mà API JavaScript của Maps sử dụng để tránh vô tình sử dụng phiên bản API không đúng trong môi trường của mình.
Ví dụ: bạn có thể sử dụng phiên bản thử nghiệm của API trong môi trường phát triển hoặc thử nghiệm, nhưng chúng tôi đặc biệt không khuyến khích việc sử dụng phiên bản thử nghiệm trong môi trường phát hành chính thức. SLA của chúng tôi chỉ áp dụng cho các phiên bản API ổn định. Vì vậy, bạn chỉ nên sử dụng các phiên bản ổn định trong môi trường phát hành chính thức.
Xem hướng dẫn tới phiên bản Maps JavaScript API.
Chọn giữa thiết kế phía máy khách và phía máy chủ
Tại sao lại quan trọng: Việc chọn phương pháp phía máy khách hoặc phía máy chủ là một quyết định về cấu trúc và cực kỳ quan trọng đối với tính ổn định và khả năng mở rộng của ứng dụng. Nhìn chung, bạn nên sử dụng phương pháp phía máy chủ để xử lý trước và sau khi xử lý các bản ghi ngoại tuyến (nghĩa là bên ngoài ứng dụng). Ngoài ra, bạn nên sử dụng phương pháp phía máy khách cho các phần trong ứng dụng có tương tác với người dùng (nghĩa là xử lý yêu cầu do người dùng gửi theo thời gian thực).
Việc triển khai phương pháp phía máy chủ mà trong đó nên áp dụng phương pháp phía máy khách là nguyên nhân hàng đầu dẫn đến việc vượt quá hạn mức và do đó, khiến ứng dụng bị hỏng. Bạn nên tham khảo các chiến lược mã hoá địa lý trước khi thiết kế hoặc chạy các ứng dụng dựa vào lệnh gọi phía máy chủ.
Tối ưu hoá việc sử dụng hạn mức
Tại sao lại quan trọng: Việc hiểu cách ứng dụng của bạn tiêu thụ hạn mức, còn gọi là Tín dụng API Maps, giúp bạn giảm số tiền phải trả. Ví dụ: nếu bạn đang sử dụng API JavaScript của Maps, ứng dụng của bạn sẽ sử dụng Tín dụng API Maps cho mỗi lượt tải bản đồ. Xem hướng dẫn về tỷ lệ và giới hạn sử dụng của Gói cao cấp.
Quản lý việc sử dụng hạn mức dịch vụ web của bạn
Trước khi chạy dịch vụ, điều quan trọng là bạn phải hiểu rõ các lỗi liên quan đến hạn mức (ví dụ: OVER_QUERY_LIMIT, User Rate Limit
Exceeded) và thiết lập logic thích hợp trong ứng dụng để có thể phản hồi những lỗi như vậy khi bạn vượt quá hạn mức. Vui lòng bắt đầu bằng cách đọc Câu hỏi thường gặp về hạn mức sử dụng.
Để biết thông tin về mã trạng thái mà mỗi API trả về, hãy tham khảo hướng dẫn dành cho nhà phát triển về API đó. Ví dụ: xem hướng dẫn về Mã trạng thái API chỉ đường.
Việc hiểu và triển khai các khái niệm này sẽ làm giảm đáng kể khả năng ứng dụng của bạn vượt quá hạn mức cho phép, bị Google chặn và/hoặc gặp lỗi.
Kiểm thử tải trên ứng dụng
Tại sao điều này quan trọng: Hãy sử dụng kiểm thử tải của ứng dụng để đảm bảo ứng dụng có thể xử lý lượng yêu cầu lớn mà không vượt quá hạn mức đối với API Maps.
Mặc dù Nền tảng Google Maps có thể xử lý lưu lượng truy cập rất lớn, nhưng việc kiểm thử các dịch vụ đang hoạt động của Google sẽ khiến ứng dụng của bạn vượt quá hạn mức cho phép và có thể bị Google chặn. Bạn cũng chịu trách nhiệm thanh toán chi phí sử dụng phát sinh trong quá trình kiểm thử tải.
Thay vào đó, hãy kiểm thử tải ứng dụng để đảm bảo rằng ứng dụng của bạn có thể xử lý số lượng yêu cầu lớn mà không vượt quá hạn mức đối với API Maps hoặc bị Google chặn. Để đạt được điều này một cách an toàn, hãy tiến hành kiểm thử tải đối với một API mô phỏng (giả mạo) – một dịch vụ có thể tiếp nhận một lượng lớn yêu cầu – và trả lời các yêu cầu bằng phản hồi hợp lệ mà không liên quan đến Nền tảng Google Maps. Ví dụ: nếu hạn mức của bạn cho API mã hóa địa lý là 20 QPS (truy vấn mỗi giây), việc kiểm tra tải ứng dụng của bạn phải đảm bảo rằng ứng dụng của bạn có thể xử lý 600 QPS mà không cần gửi hơn 20 QPS tới API mã hóa địa lý.
Nếu bạn định thực hiện một quy trình kiểm thử tải nghiêm trọng, hãy liên hệ với Nhóm hỗ trợ Google để được hướng dẫn và đảm bảo rằng Google nắm được quy trình kiểm thử theo kế hoạch của bạn.