Trước khi bắt đầu
Trước khi bắt đầu sử dụng SDK địa điểm dành cho Android, bạn cần một dự án có tài khoản thanh toán và Đã bật SDK Địa điểm dành cho Android. Để tìm hiểu thêm, hãy xem phần Thiết lập trong Cloud Console.
Tạo khoá API
Khoá API là giá trị nhận dạng duy nhất giúp xác thực các yêu cầu liên kết với dự án của bạn cho cho mục đích sử dụng và thanh toán. Bạn phải có ít nhất một khoá API 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
-
Truy cập vào Nền tảng Google Maps > Thông tin đăng nhập.
-
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 đã được tạo sẽ hiển thị khoá API mới tạo của bạn. -
Nhấp vào Close (Đó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ế API trước khi sử dụng trong phiên bản chính thức).
SDK đám mây
gcloud alpha services api-keys create \
--project "PROJECT" \
--display-name "DISPLAY_NAME"
Đọc thêm về chính sách SDK Google Cloud , Cài đặt Cloud SDK , và các lệnh sau:
Hạn chế khoá API
Bạn nên hạn chế các khoá API của mình bằng cách chỉ sử dụng các khoá API đó Các API cần thiết cho ứng dụng của bạn. Việc hạn chế khoá API sẽ giúp tăng cường bảo mật cho ứng dụng của bạn bằng cách bảo vệ tài khoản trước các yêu cầu không hợp lệ. Để biết thêm thông tin, hãy xem 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 thử nghiệm và mã phi sản xuất khác. Đừng tìm cách phát hành một ứng dụng đã được ký bằng một bản gỡ lỗi chứng chỉ. Bộ công cụ SDK Android sẽ tự động tạo chứng chỉ này khi bạn chạy gỡ lỗi bản dựng.
- 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 vào cửa hàng ứng dụng. Bộ 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ề tính năng ký ứng dụng Android và chứng chỉ, hãy xem Ký ứng dụng của chúng tôi.
Để biết hướng dẫn về 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 Làm việ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 Tự ký đơn đăng ký hoặc tham khảo hướng dẫn dành cho môi trường tạo bản dựng.
Cách hạn chế khoá API:
Giao diện dòng lệnh
-
Truy cập vào Nền tảng Google Maps > Thông tin đăng nhập.
- Chọn khoá API mà bạn muốn đặt hạn chế. Trang thuộc tính khoá API sẽ xuất hiện.
- Trong mục Key Restrictions (Hạn chế về khoá), hãy đặt các hạn chế sau:
- Quy định hạn chế đối với ứng dụng:
- Chọn Ứng dụng Android.
- Nhấp vào + Thêm tên gói và vân tay số.
- Nhập tên gói và dấu vân tay chứng chỉ SHA-1. 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ế đối với API:
- Nhấp vào Hạn chế khoá.
- Chọn API Địa điểm hoặc API Địa điểm (Mới) trong trình đơn thả xuống Select API (Chọn API) nhưng không phải cả hai. Nếu API Địa điểm không có trong danh sách, bạn cần bật tính năng đó.
- Để hoàn tất nội dung thay đổi, hãy nhấp vào Lưu.
SDK đám mây
SDK Địa điểm dành cho Android (Mới)
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 alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
--clear-restrictions
Đặt các quy tắc hạn chế mới đối với khoá hiện có.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
--api-target="places.googleapis.com"
--allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"
Đọc thêm về chính sách SDK Google Cloud , Cài đặt Cloud SDK , và các lệnh sau:
SDK Địa điểm dành cho Android
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 alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
--clear-restrictions
Đặt các quy tắc hạn chế mới đối với khoá hiện có.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
--api-target="places-backend.googleapis.com"
--allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"
Đọc thêm về chính sách SDK Google Cloud , Cài đặt Cloud SDK , và các lệnh sau:
Các bước tiếp theo
Bây giờ, bạn đã có khoá API, hãy tạo và định cấu hình một dự án như mô tả trong Thiết lập dự án Android Studio.