Bắt đầu sử dụng Nền tảng Google Maps

Trang này trình bày các bước cơ bản và bắt buộc để bắt đầu sử dụng bất kỳ API và SDK nào trên Google Maps Platform.

Bắt đầu nhanh

Nếu bạn chưa từng sử dụng Google Cloud Console để tạo tài khoản thanh toán hoặc dự án, hãy nhấp vào nút Bắt đầu để liên kết với trải nghiệm thiết lập tương tác trong Cloud Console dành cho người dùng mới:

Bắt đầu

Ngoài ra, bạn có thể hoàn tất các bước thiết lập bắt buộc sau đây:

Bước 1: Thiết lập dự án

Giao diện dòng lệnh

1. Trong Google Cloud Console, trên trang bộ chọn dự án, hãy nhấp vào Create Project (Tạo dự án) để bắt đầu tạo một dự án mới trên Cloud.

   Chuyển đến trang bộ chọn dự án

2. Đảm bảo rằng bạn đã bật tính năng thanh toán cho dự án trên đám mây của bạn. Xác nhận rằng bạn đã bật tính năng thanh toán cho dự án của mình.

   Google Cloud cung cấp gói dùng thử không tính phí. Thời gian dùng thử sẽ kết thúc sau 90 ngày hoặc sau khi tài khoản đã tích luỹ được 300 USD phí, tuỳ theo điều kiện nào đến trước. Huỷ bất cứ lúc nào. Để biết thêm thông tin, hãy xem phần Tín dụng tài khoản thanh toán và Thanh toán.

SDK đám mây

gcloud projects create "PROJECT"

Đọc thêm về Google Cloud SDK, cách cài đặt Cloud SDK và các lệnh sau:

• gcloud projects create

Bước 2: Bật API hoặc SDK

Để sử dụng Google Maps Platform, bạn phải bật các API hoặc SDK mà bạn dự định dùng cho dự án của mình.

Xin lưu ý rằng một số hoạt động tích hợp yêu cầu bạn bật nhiều API/SDK. Nếu bạn không chắc chắn nên bật API hoặc SDK nào, hãy thử sử dụng Trình khám phá chức năng hoặc tham khảo tài liệu về API/SDK mà bạn muốn sử dụng.

Cách bật một hoặc nhiều API hoặc SDK:

Giao diện dòng lệnh

1. Xem các API và SDK của Google Maps Platform mà bạn có thể bật bằng cách truy cập vào trang Thư viện API Maps trong Cloud Console:

   Chuyển đến trang Thư viện API Maps

2. Nhấp vào API hoặc SDK bạn muốn bật.
   • Nếu nút này có nhãn BẬT, hãy nhấp vào nút đó để bật API hoặc SDK.
   • Nếu nút này có nhãn MANAGE (QUẢN LÝ), thì tức là API hoặc SDK đã được bật và bạn không cần làm gì thêm.
   • Khi nhấp vào một trong hai nút, bạn sẽ thấy trang tổng quan của API hoặc SDK. (Nhấp vào nút TẮT để xoá API hoặc SDK khỏi dự án này.)

SDK đám mây

Lệnh sau đây bật tất cả các API Maps, Routes và Places:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

Đọc thêm về Google Cloud SDK, cách cài đặt Cloud SDK và các lệnh sau:

• gcloud services enable
• gcloud services disable

Sử dụng lệnh này để bật Environment API:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

Lưu ý: Khi bật Places API, bạn cũng sẽ bật Thư viện địa điểm, Maps JavaScript API, Places SDK cho Android và Places SDK cho iOS.

Bước 3: Lấy khoá API

Bước này chỉ thực hiện quy trình tạo khoá API. Nếu sử dụng khoá API trong môi trường thực tế, bạn nên hạn chế khoá API của mình. Bạn có thể tìm thêm thông tin trên trang Sử dụng khoá API dành riêng cho sản phẩm.

Khoá API là một giá trị nhận dạng riêng biệt giúp xác thực các yêu cầu liên quan đến 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 liên kết với dự án của mình. Để tạo khoá mới hoặc thêm API hay SDK vào khoá hiện có, hãy làm theo các hướng dẫn sau.

Giao diện dòng lệnh

1. Chuyển đến trang Google Maps Platform > Khoá và thông tin xác thực.

   Chuyển đến trang Khoá và thông tin xác thực

2. Nếu thấy lời nhắc, hãy chọn dự án của bạn.

3. Thực hiện một trong các thao tác sau:

   • Tạo khoá mới:

     1. Nhấp vào Tạo thông tin xác thực > Khoá API.
     2. Trong bảng điều khiển Create API key (Tạo khoá API), hãy mở danh sách Select API restrictions (Chọn các quy định hạn chế đối với API).
     3. Xoá mọi API mà khoá này không cần và đảm bảo rằng các API mà bạn dự định sử dụng vẫn được chọn.
     4. Nhấp vào Tạo. Bảng điều khiển sẽ hiển thị khoá API mới của bạn.

   • Sử dụng khoá hiện có:

     1. Nhấp vào tên của khoá.
     2. Trong danh sách Select API restrictions (Chọn các quy tắc hạn chế cho API), hãy chọn những API mà bạn dự định sử dụng.
     3. Nhấp vào Lưu.

   Việc chọn một API ở đây không giúp bật API đó. Đảm bảo rằng mỗi API bạn chọn đều được bật trong Thư viện API.

4. Để xem chuỗi khoá sau này, hãy chuyển đến trang Khoá và thông tin xác thực rồi nhấp vào Hiện khoá cho khoá đó.

Nếu bảng điều khiển có giao diện khác với các bước này, hãy xem phần Tạo khoá API và Thêm quy định hạn chế về API trong tài liệu của Google Cloud.

SDK đám mây

Thay thế PROJECT_ID bằng mã dự án của bạn trong các lệnh sau.

• Tạo khoá mới: Chạy lệnh sau và thay thế DISPLAY_NAME bằng tên cho khoá. Thay thế SERVICE_NAME bằng tên dịch vụ của một API mà bạn dự định sử dụng, chẳng hạn như places.googleapis.com. Để cho phép thêm API, hãy lặp lại cờ --api-target.

  gcloud services api-keys create \
      --project="PROJECT_ID" \
      --display-name="DISPLAY_NAME" \
      --api-target=service=SERVICE_NAME

  Đọc thêm về Google Cloud SDK, cách cài đặt Cloud SDK và các lệnh sau:

  • gcloud services api-keys create

• Sử dụng khoá hiện có: Chạy lệnh sau và thay thế KEY_ID bằng mã nhận dạng của khoá. Thay thế SERVICE_NAME bằng tên dịch vụ của API cần thêm. Cờ --append giữ lại các API mà khoá đã cho phép. Nếu không có, lệnh sẽ thay thế các tệp đó.

  gcloud services api-keys update KEY_ID \
      --project="PROJECT_ID" \
      --append \
      --api-target=service=SERVICE_NAME

  Đọc thêm về Google Cloud SDK, cách cài đặt Cloud SDK và các lệnh sau:

  • gcloud services api-keys update
  • gcloud services api-keys list

  Mã khoá không phải là chuỗi khoá hoặc tên hiển thị. Để tìm tệp này, hãy chạy gcloud services api-keys list --project="PROJECT_ID". Mã nhận dạng là phần cuối cùng của trường name: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

Để xem chuỗi khoá, hãy chạy gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID".

Khoản tín dụng trong tài khoản thanh toán

• Nếu chưa từng là khách hàng trả phí của Google Cloud, Google Maps Platform hoặc Firebase và chưa từng đăng ký chương trình Dùng thử miễn phí Google Cloud, thì bạn đủ điều kiện tham gia chương trình Dùng thử miễn phí và nhận khoản tín dụng chào mừng trị giá 300 USD để sử dụng các dịch vụ của Google Maps Platform.
• Mỗi SKU của Google Maps Platform cung cấp một hạn mức sử dụng miễn phí hằng tháng, được trình bày trong bảng giá và được mô tả trong phần thông tin thanh toán của Google Maps Platform.
• Google cũng cung cấp tín dụng cho các chương trình công khai như tổ chức phi lợi nhuận, công ty khởi nghiệp, ứng phó khủng hoảng, hãng tin, giáo dục và công ty vận tải.

Các bước tiếp theo

Sau khi thiết lập, bạn có thể bắt đầu sử dụng các API và SDK của Google Maps Platform. Để tìm hiểu thêm, hãy xem hướng dẫn Tổng quan, hướng dẫn dành cho Nhà phát triển và hướng dẫn Bắt đầu sử dụng cho API hoặc SDK mà bạn quan tâm. Các API và SDK được liệt kê trong Tài liệu về Google Maps Platform (theo sản phẩm) và API của Google Maps Platform (theo nền tảng).