Bắt đầu nhanh API Nhúng Maps

Đặt bản đồ tương tác hoặc ảnh toàn cảnh trong Chế độ xem đường phố trên trang web của bạn bằng một yêu cầu HTTP mà không cần JavaScript tuỳ chỉnh.

Chi phí

Tất cả yêu cầu Maps Embed API đều được cung cấp không mất phí và không giới hạn mức sử dụng. Tuy nhiên, tất cả yêu cầu vẫn cần có khoá Google Cloud API hợp lệ. Để biết thêm thông tin, hãy xem phần Mức sử dụng và thanh toán.

Trước khi bắt đầu

Để tạo bản đồ được nhúng trên trang web, hãy hoàn tất các bước thiết lập bắt buộc sau:

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

gcloud projects create "PROJECT"

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.

gcloud services enable \
    --project "PROJECT" \
    "maps-embed-backend.googleapis.com"

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.

Cách tạo khoá API:

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

Tạo iframe

Nhấp vào các lựa chọn sau đây rồi thêm một vị trí và khoá API để tạo một iframe cho trang web của bạn. Để biết thêm các tham số và tuỳ chọn, hãy xem phần Nhúng bản đồ.

Kiểm thử iframe

Cách xem iframe trong cửa sổ trình duyệt HTML:

1. Mở trình chỉnh sửa văn bản mặc định. Theo mặc định, thiết bị của bạn phải được cài đặt các trình chỉnh sửa văn bản như TextEdit hoặc Microsoft Windows Notepad.
2. Tạo một tệp HTML và đặt tên là index.html.

3. Thêm mã sau đây vào iframe bạn đã tạo ở trên:

   <html>
     <!-- Replace this code comment with your iframe. -->
   </html>
   

4. Lưu tệp HTML index.html.

5. Tải tệp HTML trong trình duyệt web bằng cách kéo tệp từ màn hình vào trình duyệt; hoặc nhấp đúp vào tệp trên hầu hết các hệ điều hành.

Xin chúc mừng! Bạn vừa thiết lập và tạo một bản đồ bằng Maps Embed API.

Dọn dẹp

Bạn có thể xoá dự án trên Google Cloud để ngừng thanh toán cho tất cả tài nguyên được sử dụng trong dự án đó.

1. Trong Google Cloud Console, hãy chuyển đến trang Manage resources (Quản lý tài nguyên):

   Chuyển đến trang Quản lý tài nguyên

2. Nếu dự án mà bạn dự định xoá được đính kèm với một tổ chức, hãy chọn và mở rộng danh sách tổ chức ở đầu trang.
3. Trong danh sách dự án, hãy chọn dự án bạn muốn xoá rồi nhấp vào Xoá.
4. Trong hộp thoại, hãy nhập mã dự án rồi nhấp vào Tắt để xoá dự án.

Các bước tiếp theo

• Bắt đầu phát triển bằng Maps Embed API bằng cách thiết lập dự án trên đám mây của Google:

  Thiết lập trong Cloud Console

• Để xem danh sách các tham số và tuỳ chọn bổ sung mà bạn có thể thêm vào iframe, hãy xem:

  Nhúng bản đồ

• Mở rộng dự án Maps bằng JavaScript API:

  Maps JavaScript API