Trước khi bắt đầu
Trước khi bắt đầu sử dụng SDK Bản đồ cho Android, bạn cần có một dự án có tài khoản thanh toán và đã bật SDK Bản đồ cho Android. Để tìm hiểu thêm, hãy xem bài viết Thiết lập trong Cloud Console.
Tạo khoá API
Khoá API là giá trị nhận dạng duy nhất xác thực các yêu cầu liên kết với dự án của bạn cho mục đích sử dụng và thanh toán. Bạn phải có ít nhất một khoá API được liên kết với dự án của mình.
Cách tạo khoá API:
Giao diện dòng lệnh
-
Chuyển đến trang Nền tảng Google Maps > Thông tin xác thực.
-
Trên trang Thông tin xác thực, hãy nhấp vào Tạo thông tin xác thực > Khoá API.
Hộp thoại API key created (Khoá API đã tạo) hiển thị khoá API mới tạo. -
Nhấp vào Đóng.
Khoá API mới được liệt kê trên trang Thông tin xác thực trong phần Khoá API.
(Hãy nhớ hạn chế khoá API trước khi sử dụng khoá đó trong môi trường sản xuất.)
SDK đám mây
gcloud services api-keys create \ --project "PROJECT" \ --display-name "DISPLAY_NAME"
Đọc thêm về Google Cloud SDK , cách cài đặt Cloud SDK , và các lệnh sau:
Hạn chế khoá API
Bạn nên hạn chế khoá API bằng cách giới hạn việc sử dụng khoá API ở những API cần thiết cho ứng dụng của mình. Việc hạn chế khoá API sẽ tăng cường bảo mật cho ứng dụng của bạn bằng cách bảo vệ ứng dụng khỏi các yêu cầu không hợp lệ. Bạn chịu trách nhiệm tài chính đối với các khoản phí phát sinh do việc sử dụng sai mục đích các khoá API không bị hạn chế. Để biết thêm thông tin, hãy xem phần Các phương pháp hay nhất về bảo mật API.
Khi hạn chế khoá API, bạn phải cung cấp dấu vân tay chứng chỉ SHA-1 của khoá ký dùng để ký ứng dụng. Có hai loại chứng chỉ:
- Chứng chỉ gỡ lỗi: Chỉ sử dụng loại chứng chỉ này với các ứng dụng bạn đang kiểm thử và các mã không phải bản chính thức khác. Đừng cố gắng phát hành một ứng dụng được ký bằng chứng chỉ gỡ lỗi. Bộ công cụ SDK Android sẽ tự động tạo chứng chỉ này khi bạn chạy một bản dựng gỡ lỗi.
- Chứng chỉ phát hành: Sử dụng chứng chỉ này khi bạn đã sẵn sàng phát hành ứng dụng lên một cửa hàng ứng dụng. Các công cụ SDK Android sẽ tạo chứng chỉ này khi bạn chạy một bản phát hành.
Để biết thêm thông tin về chứng chỉ và tính năng ký ứng dụng Android, hãy xem hướng dẫn Ký ứng dụng.
Để biết hướng dẫn cách tìm dấu vân tay chứng chỉ ký, hãy xem các tài liệu tham khảo bên dưới:
- Nếu bạn đang sử dụng Tính năng ký ứng dụng của Play, hãy xem phần Hợp tác với nhà cung cấp API.
- Nếu bạn quản lý khoá ký của riêng mình, hãy xem phần Tự ký ứng dụng hoặc tham khảo hướng dẫn cho môi trường xây dựng của bạn.
Cách hạn chế khoá API:
Giao diện dòng lệnh
-
Chuyển đến trang Nền tảng Google Maps > Thông tin xác thực.
- Chọn khoá API mà bạn muốn đặt quy tắc hạn chế. Trang thuộc tính khoá API sẽ xuất hiện.
- Trong mục Key restrictions (Hạn chế đối với khoá), hãy đặt các hạn chế sau:
- Các hạn chế về ứng dụng:
- Chọn Ứng dụng Android.
- Nhấp vào + Thêm tên gói và vân tay.
- Nhập tên gói và vân tay số SHA-1 của chứng chỉ. Ví dụ:
com.example.android.mapexample
BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
- Các quy định hạn chế về API:
- Nhấp vào Hạn chế khoá.
- Chọn SDK Maps cho Android trong trình đơn thả xuống Chọn API. Nếu SDK Bản đồ dành cho Android không có trong danh sách, bạn cần bật SDK đó.
- Để hoàn tất các thay đổi, hãy nhấp vào Lưu.
SDK đám mây
Liệt kê các khoá hiện có.
gcloud services api-keys list --project="PROJECT"
Xoá các quy định hạn chế hiện có đối với khoá hiện có.
gcloud services api-keys update "projects/PROJECT/keys/KEY_ID" \ --clear-restrictions
Đặt các hạn chế mới đối với khoá hiện có.
gcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \ --api-target=service=maps-android-backend.googleapis.com --allowed-application=sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME
Đọc thêm về Google Cloud SDK , cách cài đặt Cloud SDK , và các lệnh sau:
Bước tiếp theo
Giờ đây, khi bạn đã có khoá API, hãy tạo và định cấu hình dự án như mô tả trong phần Thiết lập dự án Android Studio.