science Sản phẩm hoặc tính năng này đang ở giai đoạn Xem trước (trước khi phát hành rộng rãi). Các sản phẩm và tính năng trước giai đoạn phát hành rộng rãi có thể chỉ được hỗ trợ hạn chế. Các thay đổi đối với sản phẩm và tính năng trước giai đoạn phát hành rộng rãi có thể không tương thích với các phiên bản trước khi phát hành rộng rãi. Sản phẩm trước giai đoạn phát hành rộng rãi chịu sự điều chỉnh của
Điều khoản dành riêng cho dịch vụ của Nền tảng Google Maps. Để biết thêm thông tin, hãy xem
mô tả giai đoạn khởi chạy.
Thiết lập dự án Google Cloud
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Hướng dẫn này trình bày cách thiết lập dự án Google Cloud trước khi sử dụng API Google Maps Platform. Mặc dù bạn có thể đã hoàn tất một số bước này trong trang Bắt đầu sử dụng Nền tảng Google Maps, nhưng tài liệu này cung cấp thêm các hướng dẫn hữu ích để quản lý dự án của bạn.
Tạo một dự án
Để sử dụng Google Maps Platform, bạn phải có một dự án để quản lý các dịch vụ, thông tin đăng nhập, hoạt động thanh toán, API và SDK.
Bạn phải thiết lập thông tin thanh toán cho mỗi dự án, nhưng bạn sẽ chỉ bị tính phí nếu một dự án vượt quá hạn mức dịch vụ không tính phí.
Cách tạo một dự án trên Cloud đã bật tính năng thanh toán:
Giao diện dòng lệnh
-
Tạo một dự án Google Cloud mới trong Cloud Console:
Tạo dự án mới
-
Trên trang New Project (Dự án mới), hãy điền thông tin bắt buộc:
-
Tên dự án: Chấp nhận tên mặc định hoặc nhập tên tuỳ chỉnh.
Bạn có thể thay đổi tên dự án bất cứ lúc nào. Để biết thêm thông tin, hãy xem phần Xác định dự án.
-
Mã dự án: Chấp nhận mã dự án mặc định hoặc nhấp vào CHỈNH SỬA để nhập mã dự án tuỳ chỉnh mà các API của Google dùng làm giá trị nhận dạng riêng biệt cho dự án của bạn.
Sau khi tạo dự án, bạn không thể thay đổi mã dự án. Vì vậy, hãy chọn một mã mà bạn sẽ thoải mái sử dụng trong suốt thời gian tồn tại của dự án. Đừng đưa thông tin nhạy cảm vào mã dự án.
-
Tài khoản thanh toán: Chọn một tài khoản thanh toán cho dự án. Nếu chưa thiết lập tài khoản thanh toán hoặc chỉ có một tài khoản thanh toán, bạn sẽ không thấy lựa chọn này.
Bạn phải là Quản trị viên tài khoản thanh toán hoặc Người quản lý thanh toán dự án để liên kết một dự án với tài khoản thanh toán. Để biết thêm thông tin, hãy xem tài liệu về quyền kiểm soát truy cập vào thông tin thanh toán.
-
Vị trí: Nếu bạn có một tổ chức mà bạn muốn liên kết dự án của mình, hãy nhấp vào Duyệt qua rồi chọn tổ chức đó; nếu không, hãy chọn "Không có tổ chức".
Để biết thêm thông tin, hãy xem bài viết Tạo và quản lý thư mục và Mối quan hệ giữa tổ chức, dự án và tài khoản thanh toán.
Chọn Tạo.
Bật tính năng thanh toán
Để triển khai ứng dụng, bạn phải bật tính năng thanh toán. Tài khoản của bạn sẽ không bị tính phí nếu bạn sử dụng trong hạn mức hằng tháng.
Nếu ứng dụng của bạn cần các tài nguyên vượt quá hạn mức hằng tháng, bạn sẽ bị tính phí cho mức sử dụng bổ sung.
Nếu bạn có tài khoản thanh toán khi tạo một dự án trên Cloud, thì tính năng thanh toán sẽ tự động được bật trên dự án đó.
Cách bật tính năng thanh toán cho một dự án trên Google Cloud:
- Trong Cloud Console, hãy chuyển đến trang Thanh toán:
Chuyển đến trang Thanh toán
- Chọn hoặc tạo một dự án trên Đám mây.
- Tuỳ thuộc vào việc có tài khoản thanh toán hay không hoặc dự án Cloud đã chọn có được liên kết với một tài khoản hay không, trang Thanh toán sẽ hiển thị một trong những thông tin sau:
- Nếu bạn đã bật tính năng thanh toán cho dự án trên Đám mây đã chọn, thì thông tin chi tiết về tài khoản thanh toán sẽ xuất hiện.
- Nếu chưa có tài khoản thanh toán, bạn sẽ được nhắc tạo một tài khoản thanh toán và liên kết tài khoản đó với dự án Cloud đã chọn.
- Nếu có tài khoản thanh toán, bạn sẽ được nhắc bật tính năng thanh toán nếu dự án Cloud đã chọn chưa được liên kết với tài khoản thanh toán. Bạn cũng có thể chọn Huỷ rồi chọn Tạo tài khoản để tạo và liên kết một tài khoản thanh toán mới.
Sau khi bạn bật tính năng thanh toán, không có giới hạn về số tiền mà bạn có thể bị tính phí. Để kiểm soát chi phí chặt chẽ hơn, bạn có thể tạo ngân sách và thiết lập cảnh báo. Để biết thêm thông tin, hãy xem phần Thanh toán.
Bật API
SDK đám mây
Trước khi sử dụng lệnh bên dưới, hãy thay thế những nội dung sau:
-
RESOURCE_TYPE với loại tài nguyên mà bạn muốn tạo một tác nhân dịch vụ. Sử dụng
project, folder hoặc organization.
-
RESOURCE_ID bằng mã nhận dạng của dự án, thư mục hoặc tổ chức trên Google Cloud mà bạn muốn tạo một tác nhân dịch vụ. Mã dự án là chuỗi dạng chữ và số, chẳng hạn như
my-project. Mã nhận dạng thư mục và tổ chức là mã nhận dạng bằng số, chẳng hạn như 123456789012.
gcloud beta services identity create \
--service=analyticshub.googleapis.com \
--RESOURCE_TYPE=RESOURCE_ID
Xem các API đã bật
Giao diện dòng lệnh
Để xem các API hoặc SDK mà bạn đã bật, hãy chuyển đến trang Google Maps Platform trong Cloud Console:
Truy cập trang Nền tảng Google Maps
- Các API khác: Những API hoặc SDK này không được bật.
- Nếu bạn thấy thẻ cho từng API và dịch vụ của Maps, thì tức là chưa có API hoặc SDK nào được bật.
Tắt dự án
Bạn có thể tắt tính năng thanh toán và giải phóng tất cả tài nguyên trên đám mây đang được dùng trong dự án trên đám mây bằng cách tắt dự án đó:
Bước tiếp theo
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-31 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-31 UTC."],[],[],null,["# Set up your Google Cloud project\n\nThis guide shows how to set up your Google Cloud project before using\nthe Google Maps Platform APIs. While you may have completed some of these\nsteps in the\n\n[Getting started with Google Maps Platform](/maps/get-started) page,\nthis document provides additional, useful instructions for managing your projects.\n\nCreate a project\n----------------\n\nTo use Google Maps Platform, you must have a project to manage services,\ncredentials, billing, APIs, and SDKs.\n\n[Billing setup](#billing) is required for each project, but you will only be charged if a\nproject exceeds its [quota](/maps/billing-and-pricing/billing#monthly-credit) of no-charge services.\n\nTo create a Cloud project with billing enabled: \n\n### Console\n\n1. Create a new Google Cloud project in the Cloud console:\n\n [Create new project](https://console.cloud.google.com/projectcreate?utm_source=Docs_NewProject&utm_content=Docs_CONSOLE_ID)\n2. On the **New Project** page, fill in the required information:\n\n - **Project name:** Accept the default or enter a customized name.\n\n You can change the project name at any time. For more information, see\n [Identifying projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects#identifying_projects).\n - **Project ID:** Accept the default or click **EDIT** to enter a\n customized ID that Google APIs use as a unique identifier for your project.\n\n After you create the project, you *cannot* change the project ID, so\n choose an ID that you'll be comfortable using for the lifetime of the\n project. Don't include any sensitive information in your project ID.\n - **Billing account:** Select a billing account for the project. If you\n haven't set up a billing account or only have one billing account, you\n won't see this option.\n\n You must be a Billing Account Administrator or Project Billing Manager\n to associate a project with a billing account. For more information, see\n [the billing access control documentation](https://cloud.google.com/billing/docs/how-to/billing-access#overview_of_billing_roles_in).\n - **Location:** If you have an organization you want to link your project\n to, click **Browse** and select it; otherwise, choose \"No organization\".\n\n For more information, see [Creating and Managing Folders](https://cloud.google.com/resource-manager/docs/creating-managing-folders)\n and [Relationships between organizations, projects, and billing accounts](https://cloud.google.com/billing/docs/how-to/billing-access#relationships-between-resources).\n3. Select **Create**.\n\n### gcloud\n\n```bash\ngcloud projects create \"\u003cvar translate=\"no\"\u003ePROJECT\u003c/var\u003e\"\n```\n\nRead more about the\n[Google Cloud SDK](https://cloud.google.com/sdk)\n,\n[Cloud SDK installation](https://cloud.google.com/sdk/docs/install)\n, and the following commands:\n\n- [`gcloud projects create`](https://cloud.google.com/sdk/gcloud/reference/projects/create)\n\nEnable billing\n--------------\n\nTo deploy your apps, you must enable billing. Your account won't be charged\nif you stay within your [monthly quota](/maps/billing-and-pricing/billing#monthly-credit).\nIf your application needs resources that exceed the monthly quota, you will be\ncharged for the additional usage.\n\nIf you have a billing account when you create a Cloud\nproject, then billing is automatically enabled on that project.\n\nTo enable billing on a Cloud project:\n\n1. In the Cloud console, go to the Billing page: \n [Go to the Billing page](https://console.cloud.google.com/projectselector/billing?utm_source=Docs_Billing&utm_content=Docs_CONSOLE_ID)\n2. Select or create a Cloud project.\n3. Depending on if a billing account exists or if the selected Cloud project is associated with an account, the Billing page displays one of the following:\n - If billing is already enabled for the selected Cloud project, then the details about the billing account are listed.\n - If no billing account exists, you are prompted to create a billing account and associate it with the selected Cloud project.\n - If a billing account exists, you are prompted to enable billing if the selected Cloud project is not already associated with a billing account. You can also select **Cancel** and then select **Create account** to create and associate a new billing account.\n\nAfter you enable billing, there is no limit to the amount that you might\nbe charged. To gain more control over your costs, you can\n[create\na budget and set alerts](/maps/billing-and-pricing/billing#creating-budgets-and-set-alerts). For more information, see [Billing](/maps/billing-and-pricing/billing).\n\nEnable APIs\n-----------\n\n### Console\n\n\n[Enable Vertex AI](https://console.cloud.google.com/apis/library/aiplatform.googleapis.com)\n\n\n[Enable BigQuery](https://console.cloud.google.com/apis/library/bigquery.googleapis.com)\n\n\n[Enable Cloud Storage](https://console.cloud.google.com/apis/library/storage-component.googleapis.com)\n\n\n[Enable Analytics Hub API](https://console.cloud.google.com/apis/library/analyticshub.googleapis.com)\n\n### Cloud SDK\n\nBefore using the command below, replace the following:\n\n- \u003cvar label=\"RESOURCE_TYPE\" translate=\"no\"\u003eRESOURCE_TYPE\u003c/var\u003e with the type of resource that you want to create a service agent for. Use `project`, `folder`, or `organization`.\n- \u003cvar label=\"RESOURCE_ID\" translate=\"no\"\u003eRESOURCE_ID\u003c/var\u003e with the ID of the Google Cloud project, folder, or organization that you want to create a service agent for. Project IDs are alphanumeric strings, like `my-project`. Folder and organization IDs are numeric, like `123456789012`.\n\n```bash\ngcloud beta services identity create \\\n --service=analyticshub.googleapis.com \\\n --RESOURCE_TYPE=RESOURCE_ID\n```\n\nView enabled APIs\n-----------------\n\n### Console\n\nTo view the APIs or SDKs you have enabled, go to the Google Maps Platform page\nin the Cloud console:\n[Go to Google Maps Platform page](https://console.cloud.google.com/project/_/google/maps-apis/api-list?utm_source=Docs_ProjectViewAPI&utm_content=Docs_CONSOLE_ID)\n\n- Additional APIs: These API or SDKs are not enabled.\n- If you see cards for each Map APIs and services, no APIs or SDKs have been enabled.\n\n### gcloud\n\n```bash\ngcloud services list --project \"\u003cvar translate=\"no\"\u003ePROJECT\u003c/var\u003e\"\n```\n\nRead more about the\n[Google Cloud SDK](https://cloud.google.com/sdk)\n,\n[Cloud SDK installation](https://cloud.google.com/sdk/docs/install)\n, and the following commands:\n\n- [`gcloud services list`](https://cloud.google.com/sdk/gcloud/reference/services/list)\n\nShut down a project\n-------------------\n\nYou can disable billing and release all the Cloud resources that\nare being used in your Cloud project by shutting down\nthat project: \n\n### Console\n\n1. Go to the Projects page:\n\n [Go to the Projects page](https://console.cloud.google.com/iam-admin/projects?utm_source=Docs_ProjectShutdown&utm_content=Docs_CONSOLE_ID)\n2. Select the Cloud project that you want to shut down,\n then click **Delete**.\n\nFor more information about managing your Cloud\nprojects, see [Cloud Resource Manager: creating, shutting down, and restoring projects](https://cloud.google.com/resource-manager/docs/creating-managing-projects).\n\n### gcloud\n\n```bash\ngcloud projects delete \"\u003cvar translate=\"no\"\u003ePROJECT\u003c/var\u003e\"\n```\n\nRead more about the\n[Google Cloud SDK](https://cloud.google.com/sdk)\n,\n[Cloud SDK installation](https://cloud.google.com/sdk/docs/install)\n, and the following commands:\n\n- [`gcloud projects delete`](https://cloud.google.com/sdk/gcloud/reference/projects/delete)\n\nWhat's next\n-----------\n\n- [Classify images](/maps/documentation/imagery-insights/get-started).\n- [Review the table schemas](/maps/documentation/imagery-insights/reference)."]]
