Kiểu bản đồ mới sắp xuất hiện trên Nền tảng Google Maps. Bản cập nhật này để tạo kiểu bản đồ bao gồm một bảng màu mặc định mới và các cải tiến về trải nghiệm bản đồ cũng như khả năng hữu dụng. Tất cả kiểu bản đồ sẽ được cập nhật tự động vào tháng 3 năm 2025. Để biết thêm thông tin về phạm vi cung cấp và cách chọn tham gia sớm hơn, hãy xem bài viết Kiểu bản đồ mới cho Nền tảng Google Maps.

Trang này được dịch bởi Cloud Translation API.

Bắt đầu

Giới thiệu

API tĩnh của Maps sẽ trả về hình ảnh (ảnh GIF, PNG hoặc JPEG) để phản hồi yêu cầu HTTP qua một URL. Đối với mỗi yêu cầu, bạn có thể chỉ định vị trí của bản đồ, kích thước của hình ảnh, mức thu phóng, loại bản đồ và vị trí của các điểm đánh dấu không bắt buộc tại các vị trí trên bản đồ. Bạn cũng có thể gắn nhãn thêm cho các điểm đánh dấu của mình bằng cách sử dụng các ký tự bao gồm chữ và số.

Hình ảnh API tĩnh của Maps được nhúng trong thuộc tính src của thẻ <img> hoặc thuộc tính tương đương trong các ngôn ngữ lập trình khác.

Tài liệu này mô tả định dạng bắt buộc của URL API tĩnh Maps và các tham số có sẵn. Hướng dẫn này cũng chỉ ra một số mẹo và thủ thuật trong việc chỉ định URL.

Trước khi bắt đầu

Tài liệu này dành cho các nhà phát triển trang web và thiết bị di động muốn đưa hình ảnh API tĩnh của Maps vào một trang web hoặc ứng dụng dành cho thiết bị di động. Bài viết này đưa ra giới thiệu về cách sử dụng API và tài liệu tham khảo về các tham số có sẵn.

Trước khi bắt đầu phát triển bằng API tĩnh của Maps, hãy xem lại các yêu cầu xác thực (bạn cần có khoá API) và thông tin thanh toán và sử dụng API (bạn cần bật tính năng thanh toán cho dự án của mình).

Thông số URL

URL của API tĩnh của Maps phải có dạng sau:

https://maps.googleapis.com/maps/api/staticmap?parameters

Nếu truy cập trang web của bạn qua HTTPS, thì bạn cũng phải tải hình ảnh API tĩnh của Maps qua HTTPS để tránh nhận được cảnh báo bảo mật của trình duyệt. Bạn cũng nên sử dụng HTTPS nếu yêu cầu bao gồm thông tin nhạy cảm của người dùng, chẳng hạn như vị trí của người dùng:

https://maps.googleapis.com/maps/api/staticmap?parameters

Cho dù sử dụng HTTP hay HTTPS, bạn vẫn bắt buộc phải sử dụng một số tham số URL, nhưng cũng có một số tham số không bắt buộc. Theo tiêu chuẩn trong URL, tất cả tham số được phân tách bằng ký hiệu và (&). Danh sách các tham số và giá trị có thể có của các tham số đó được liệt kê trong tài liệu này.

Lưu ý quan trọng: Nội dung thảo luận về tham số URL sử dụng các ví dụ để đảm bảo sự rõ ràng được đưa ra trong biểu mẫu trước khi thoát. Trước khi gửi bất kỳ yêu cầu nào đến API, các tham số của API đó phải được mã hoá URL đúng cách. Ví dụ: nhiều thông số sử dụng ký tự gạch đứng (|) làm dấu phân tách và phải được mã hoá là %7C trong URL cuối cùng, như trong ví dụ nhanh ở đầu tài liệu này. Để biết thêm thông tin, hãy xem phần Tạo URL hợp lệ.

API tĩnh của Maps xác định hình ảnh bản đồ bằng cách sử dụng các tham số URL sau:

Thông số vị trí

center (bắt buộc nếu không có điểm đánh dấu) xác định tâm của bản đồ, cách đều với tất cả các cạnh của bản đồ. Thông số này lấy một vị trí dưới dạng một cặp {vĩ độ,kinh độ} được phân tách bằng dấu phẩy (ví dụ: "40.714728,-73.998672") hoặc một địa chỉ dạng chuỗi (ví dụ: "tường thành phố, new york, ny") xác định một vị trí duy nhất trên mặt trái đất. Để biết thêm thông tin, hãy xem bài viết Vị trí.
zoom (bắt buộc nếu không có điểm đánh dấu) xác định mức thu phóng của bản đồ, xác định mức thu phóng của bản đồ. Tham số này lấy một giá trị số tương ứng với mức thu phóng của khu vực mong muốn. Để biết thêm thông tin, hãy xem bài viết Mức thu phóng.

Tham số bản đồ

size (bắt buộc) xác định kích thước hình chữ nhật của hình ảnh bản đồ. Tham số này sẽ lấy một chuỗi có dạng {horizontal_value}x{vertical_value}. Ví dụ: 500x400 xác định một bản đồ có chiều rộng 500 pixel x 400 pixel cao. Bản đồ có chiều rộng nhỏ hơn 180 pixel sẽ hiển thị biểu trưng Google có kích thước giảm. Tham số này chịu ảnh hưởng của tham số scale; kích thước đầu ra cuối cùng là tích của các giá trị kích thước và tỷ lệ.
scale (không bắt buộc) ảnh hưởng đến số lượng pixel được trả về. scale=2 trả về số lượng pixel nhiều gấp đôi so với scale=1 trong khi vẫn giữ nguyên vùng phủ sóng và mức độ chi tiết (tức là nội dung của bản đồ không thay đổi). Tính năng này rất hữu ích khi phát triển cho các màn hình có độ phân giải cao. Giá trị mặc định là 1. Giá trị được chấp nhận là 1 và 2. Hãy xem phần Giá trị tỷ lệ để biết thêm thông tin.
format (không bắt buộc) xác định định dạng của hình ảnh thu được. Theo mặc định, API tĩnh của Maps sẽ tạo hình ảnh PNG. Có thể có một số định dạng bao gồm GIF, JPEG và PNG. Định dạng bạn sử dụng phụ thuộc vào cách bạn định trình bày hình ảnh. JPEG thường có khả năng nén lớn hơn, trong khi ảnh GIF và PNG có độ chi tiết cao hơn. Để biết thêm thông tin, hãy xem bài viết Định dạng hình ảnh.
maptype (không bắt buộc) xác định loại bản đồ cần xây dựng. Có thể có một số giá trị maptype, bao gồm roadmap, satellite, hybrid và terrain. Để biết thêm thông tin, hãy xem bài viết Loại bản đồ API tĩnh của Maps.
language (không bắt buộc) xác định ngôn ngữ cần sử dụng để hiển thị nhãn trên ô bản đồ. Xin lưu ý rằng tham số này chỉ được hỗ trợ cho một số thẻ thông tin quốc gia. Nếu ngôn ngữ cụ thể mà bạn yêu cầu không được hỗ trợ cho tập hợp thẻ thông tin, thì ngôn ngữ mặc định của tập hợp thẻ thông tin đó sẽ được sử dụng.
region (không bắt buộc) xác định biên giới thích hợp để hiển thị, dựa trên các yếu tố nhạy cảm về địa chính trị. Chấp nhận mã vùng được chỉ định dưới dạng giá trị ccTLD (miền cấp cao nhất) gồm hai ký tự. Xem Thông tin chi tiết về phạm vi áp dụng của Nền tảng Google Maps để biết các khu vực được hỗ trợ.

Thông số tính năng

map_id (không bắt buộc) chỉ định giá trị nhận dạng cho một bản đồ cụ thể. Mã bản đồ liên kết một bản đồ với một kiểu hoặc tính năng cụ thể và phải thuộc cùng một dự án với khoá API dùng để khởi tạo bản đồ. Để biết thêm thông tin, hãy xem bài viết Sử dụng mã bản đồ.
markers (không bắt buộc) xác định một hoặc nhiều điểm đánh dấu để đính kèm vào hình ảnh tại các vị trí được chỉ định. Tham số này lấy một định nghĩa điểm đánh dấu duy nhất với các tham số được phân tách bằng ký tự gạch đứng (|). Bạn có thể đặt nhiều điểm đánh dấu trong cùng một thông số markers miễn là các điểm đánh dấu đó thể hiện cùng một kiểu; bạn có thể thêm điểm đánh dấu bổ sung cho các kiểu khác nhau bằng cách thêm tham số markers bổ sung. Xin lưu ý rằng nếu cung cấp điểm đánh dấu cho một bản đồ, thì bạn không cần chỉ định các tham số center và zoom (thường bắt buộc). Để biết thêm thông tin, hãy xem bài viết Điểm đánh dấu API tĩnh của Maps.
path (không bắt buộc) xác định một đường dẫn gồm hai hoặc nhiều điểm kết nối với nhau để phủ lên hình ảnh tại các vị trí được chỉ định. Tham số này sẽ lấy một chuỗi các định nghĩa điểm được phân tách bằng ký tự gạch đứng (|) hoặc một hình nhiều đường được mã hoá bằng tiền tố enc: trong phần khai báo vị trí của đường dẫn. Bạn có thể cung cấp các đường dẫn khác bằng cách thêm các tham số path khác. Xin lưu ý rằng nếu cung cấp đường dẫn cho một tệp ánh xạ, thì bạn không cần chỉ định các tham số center và zoom (thường bắt buộc). Để biết thêm thông tin, hãy xem bài viết Đường dẫn API tĩnh của Maps.
visible (không bắt buộc) chỉ định một hoặc nhiều vị trí phải tiếp tục hiển thị trên bản đồ, mặc dù sẽ không có điểm đánh dấu hoặc chỉ báo nào khác. Hãy sử dụng tham số này để đảm bảo rằng một số đối tượng hoặc vị trí trên bản đồ được hiển thị trên Maps Static API.
style (không bắt buộc) xác định một kiểu tuỳ chỉnh để thay đổi cách trình bày một đối tượng cụ thể (đường, công viên và các đối tượng khác) của bản đồ. Tham số này sẽ sử dụng các đối số feature và element xác định tính năng cần tạo kiểu và một tập hợp các thao tác định kiểu để áp dụng cho các tính năng đã chọn. Bạn có thể cung cấp nhiều kiểu chữ bằng cách thêm các tham số style bổ sung. Để biết thêm thông tin, hãy xem hướng dẫn về bản đồ được tạo kiểu.

Tham số khoá và chữ ký

key (bắt buộc) cho phép bạn theo dõi mức sử dụng API của ứng dụng trong Google Cloud Console và đảm bảo rằng Google có thể liên hệ với bạn về ứng dụng nếu cần. Để biết thêm thông tin, hãy xem bài viết Sử dụng khoá API với API tĩnh của Maps.
signature (nên dùng) là một chữ ký số dùng để xác minh rằng mọi trang web tạo yêu cầu bằng khoá API của bạn đều được phép làm như vậy. Các yêu cầu không có chữ ký số có thể không thực hiện được. Để biết thêm thông tin, hãy xem bài viết Sử dụng chữ ký số.

Giới hạn kích thước URL

Các URL API tĩnh của Maps được giới hạn ở kích thước 16384 ký tự. Trong thực tế, có thể bạn sẽ không cần các URL dài hơn khoảng này, trừ phi bạn tạo các bản đồ phức tạp có số lượng điểm đánh dấu và đường dẫn lớn.

Sử dụng thông số

API tĩnh của Maps tương đối dễ sử dụng, vì API này chỉ bao gồm một URL có tham số. Phần này giải thích cách dùng các tham số này để tạo URL.

Chỉ định vị trí

API tĩnh của Maps phải có khả năng xác định chính xác các vị trí trên bản đồ, vừa để tập trung vào bản đồ vào đúng vị trí (sử dụng tham số center) và/hoặc để đặt bất kỳ dấu vị trí tuỳ chọn nào (sử dụng tham số markers) tại các vị trí trên bản đồ. API tĩnh của Maps sử dụng số (giá trị vĩ độ và kinh độ) hoặc chuỗi (địa chỉ) để chỉ định các vị trí này. Các giá trị này xác định vị trí được mã hoá địa lý.

Một số tham số (chẳng hạn như tham số markers và path) mang nhiều vị trí. Trong những trường hợp đó, các vị trí được phân tách bằng ký tự gạch đứng (|).

Vĩ độ và kinh độ

Vĩ độ và kinh độ được xác định bằng chữ số trong một chuỗi văn bản được phân tách bằng dấu phẩy có độ chính xác đến 6 chữ số thập phân. Ví dụ: "40.714728,-73.998672" là một giá trị mã địa lý hợp lệ. Độ chính xác vượt quá 6 chữ số thập phân sẽ bị bỏ qua.

Các giá trị kinh độ được dựa trên khoảng cách từ Greenwich, nước Anh, nơi có kinh tuyến gốc. Vì Greenwich nằm ở vĩ độ 51,477222, nên chúng ta có thể nhập giá trị center là 51.477222,0 để căn giữa bản đồ ở Greenwich:

Greenwich, Anh

Các giá trị kinh độ và vĩ độ phải tương ứng với một vị trí hợp lệ trên bề mặt trái đất. Vĩ độ có thể nhận bất kỳ giá trị nào từ -90 đến 90, còn kinh độ có thể nhận bất kỳ giá trị nào từ -180 đến 180. Nếu bạn chỉ định giá trị vĩ độ hoặc kinh độ không hợp lệ, yêu cầu của bạn sẽ bị từ chối vì đây là một yêu cầu không hợp lệ.

Địa chỉ

Hầu hết mọi người không nói bằng vĩ độ và kinh độ; họ biểu thị vị trí bằng địa chỉ. Quá trình chuyển địa chỉ thành một điểm địa lý được gọi là mã hoá địa lý và dịch vụ Maps Static API có thể thực hiện mã hoá địa lý cho bạn nếu bạn cung cấp địa chỉ hợp lệ.

Trong bất kỳ tham số nào mà bạn có thể cung cấp vĩ độ/kinh độ, bạn có thể chỉ định một chuỗi cho biết địa chỉ. Google sẽ mã hoá địa lý địa chỉ và cung cấp dịch vụ API tĩnh của Maps với giá trị vĩ độ/kinh độ để sử dụng trong việc đặt điểm đánh dấu hoặc chỉ định vị trí. Chuỗi phải được mã hoá URL, ví dụ: địa chỉ như "Thành phố, New York, New York" sẽ được chuyển đổi thành "Thành phố+Hall,New+New York,NY".

Xin lưu ý rằng địa chỉ có thể phản ánh vị trí chính xác, chẳng hạn như địa chỉ đường phố, hình nhiều đường (ví dụ: các tuyến đường được đặt tên) hoặc các khu vực đa giác như thành phố, quốc gia hoặc vườn quốc gia. Đối với các kết quả đa tuyến và đa giác, máy chủ Maps Static API sẽ sử dụng điểm giữa của đường/khu vực làm tâm địa chỉ. Nếu bạn nghi ngờ cách một địa chỉ có thể mã hoá địa lý, bạn có thể kiểm tra địa chỉ bằng cách sử dụng Tiện ích mã hoá địa lý này.

Ví dụ sau đây tạo ra một hình ảnh bản đồ tĩnh cho Berkeley, CA:

https://maps.googleapis.com/maps/api/staticmap?center=Berkeley,CA&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Berkeley, CA

Mức thu phóng

Maps trên Google Maps có một số nguyên "mức thu phóng" xác định độ phân giải của chế độ xem hiện tại. Bạn có thể thu phóng trong khoảng từ 0 (mức thu phóng thấp nhất, trong đó toàn bộ thế giới có thể được nhìn thấy trên một bản đồ) và 21+ (xuống đến các con phố và từng toà nhà riêng lẻ) trong chế độ xem roadmap mặc định. Đường viền toà nhà (nếu có) sẽ xuất hiện trên bản đồ xung quanh mức thu phóng 17. Giá trị này tuỳ theo từng khu vực và có thể thay đổi theo thời gian khi dữ liệu phát triển.

Google Maps đặt mức thu phóng 0 để bao quát toàn bộ trái đất. Mỗi mức thu phóng kế tiếp giúp tăng gấp đôi độ chính xác ở cả kích thước ngang và chiều dọc. Bạn có thể xem thêm thông tin về cách thực hiện việc này trong tài liệu về API JavaScript của Google Maps.

Lưu ý: không phải tất cả mức thu phóng đều xuất hiện tại tất cả vị trí trên trái đất. Các cấp độ thu phóng khác nhau tuỳ thuộc vào vị trí, vì dữ liệu ở một số nơi trên địa cầu sẽ chi tiết hơn so với các vị trí khác.

Nếu bạn gửi yêu cầu về mức thu phóng mà trong đó không có ô bản đồ nào, thì Maps Static API sẽ trả về một hình ảnh trống.

Danh sách sau đây cho thấy mức độ chi tiết gần đúng mà bạn có thể muốn xem ở mỗi mức thu phóng:

1: Thế giới
5: Vùng đất/lục địa
10: Thành phố
15: Đường phố
20: Toà nhà

Ví dụ này yêu cầu hai bản đồ Manhattan có cùng giá trị center nhưng ở mức thu phóng lần lượt là 12 và 14:

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Manhattan Faraway Cận cảnh Manhattan

Kích thước hình ảnh

Tham số size, kết hợp với center, sẽ xác định vùng phủ sóng của bản đồ. Bước này cũng xác định kích thước đầu ra của bản đồ bằng pixel, khi được nhân với giá trị scale (theo mặc định là 1).

Bảng này cho thấy các giá trị tối đa cho phép đối với tham số size tại mỗi giá trị scale.

`scale=1`	`scale=2`
`640x640`	`640x640` (trả về 1280 x 1280 pixel)

Ví dụ này yêu cầu một "Lát cắt" của trái đất tại xích đạo ở mức thu phóng 1:

https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=400x50&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Đường xích đạo

Ví dụ này yêu cầu một bản đồ nhỏ, có kích thước 100 x 100 pixel được căn giữa trong cùng một khu vực. Hãy lưu ý biểu trưng Google nhỏ hơn:

https://maps.googleapis.com/maps/api/staticmap?center=0,0&zoom=1&size=100x100&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Bản đồ Đường xích đạo nhỏ

Giá trị tỷ lệ

Tham số size của API tĩnh của Maps xác định kích thước của bản đồ bằng pixel để bản đồ có size=200x200 sẽ được trả về ở dạng 200 pixel x 200 pixel. Trên màn hình máy tính LCD, thường hiển thị khoảng 100 pixel trên mỗi inch (ppi), bản đồ 200x200 sẽ có kích thước khoảng 2 inch.

Tuy nhiên, ngày càng có nhiều thiết bị di động có màn hình có độ phân giải cao với mật độ pixel trên 300 ppi, là:

Giảm kích thước của hình ảnh 200x200 pixel xuống chỉ còn 0,7 inch, hiển thị nhãn và biểu tượng quá nhỏ nên không đọc được; hoặc
Điều chỉnh tỷ lệ (thu phóng) hình ảnh để cải thiện mức độ dễ đọc, dẫn đến hình ảnh bị mờ hoặc vỡ nét.

Quy mô quá nhỏ	Quá mờ

Khi phát triển cho thiết bị di động, bạn có thể sử dụng tham số scale của API để trả về các hình ảnh bản đồ có độ phân giải cao hơn giúp giải quyết các vấn đề ở trên. Giá trị scale được nhân với size để xác định kích thước đầu ra thực tế của hình ảnh tính bằng pixel mà không cần thay đổi vùng bao phủ của bản đồ. Giá trị scale mặc định là 1; các giá trị được chấp nhận là 1 và 2.

Ví dụ: giá trị tỷ lệ là 2 sẽ trả về cùng một khu vực bao phủ trên bản đồ như một yêu cầu không có tỷ lệ được chỉ định, nhưng có số pixel trong mỗi phương diện nhiều gấp đôi. Nội dung này bao gồm cả đường và nhãn để người dùng có thể đọc được những thông tin này trên màn hình có độ phân giải cao, kích thước nhỏ, cũng như khi trình duyệt điều chỉnh tỷ lệ.

150x150	150x150&tỷ lệ=2

Hình ảnh như vậy cũng sẽ hoạt động hiệu quả trên trình duyệt dành cho máy tính, khi được chèn vào thẻ img hoặc div có chiều cao và chiều rộng được đặt bằng CSS. Trình duyệt sẽ giảm kích thước hình ảnh về kích thước phù hợp mà không làm giảm chất lượng.

Bảng này cho thấy 3 yêu cầu về hình ảnh.

Đầu tiên là dành cho hình ảnh 100x100, không có giá trị tỷ lệ được chỉ định. Hình ảnh này hiển thị bình thường trên máy tính nhưng quá nhỏ để đọc trên thiết bị di động.
Tham số thứ hai tăng gấp đôi kích thước bản đồ. Trên máy tính, CSS vừa với phần tử img 100x100 được chỉ định để thu nhỏ hình ảnh, đường và nhãn trở nên quá nhỏ. Trên thiết bị di động, hình ảnh có kích thước phù hợp nhưng xin nhắc lại rằng đường và nhãn thì không đọc được.
Yêu cầu thứ ba là cho bản đồ 100x100 với scale=2. Hình ảnh được trả về với 200px chi tiết; máy tính sẽ thu nhỏ hình ảnh một cách hoàn hảo để không thể phân biệt được với yêu cầu 100x100 ban đầu, trong khi trình duyệt trên thiết bị di động được hưởng lợi từ độ phân giải bổ sung mà API trả về.

Yêu cầu hình ảnh
Thiết bị	`100x100`	`200x200`	`100x100&scale=2`
Máy tính (với `height="100px"` và `width="100px"` trên thẻ `img`)
Độ phân giải cao (được mô phỏng)

Mẹo: Các nền tảng thiết bị di động (chẳng hạn như Android và iOS) cho phép ứng dụng hỗ trợ màn hình có độ phân giải cao bằng cách chỉ định hình ảnh riêng cho mỗi độ phân giải. Thông số tỷ lệ giúp bạn dễ dàng yêu cầu hình ảnh bản đồ cho màn hình có độ phân giải chuẩn và bản đồ phù hợp cho màn hình có độ phân giải cao, chỉ bằng cách đặt scale=1 và scale=2 tương ứng.

Để biết thêm thông tin về cách phát triển cho màn hình thiết bị di động và màn hình có độ phân giải cao, bạn nên đọc bài viết sau:

Hỗ trợ nhiều màn hình trong tài liệu dành cho nhà phát triển Android.
Đề xuất của Webkit.org để phát triển Trang web có DPI cao.
Hỗ trợ màn hình có độ phân giải cao trong Thư viện nhà phát triển iOS.

Định dạng hình ảnh

Hình ảnh có thể được trả về ở một số định dạng đồ hoạ web phổ biến: GIF, JPEG và PNG. Tham số format có một trong các giá trị sau:

png8 hoặc png (mặc định) chỉ định định dạng PNG 8 bit.
png32 chỉ định định dạng PNG 32 bit.
gif chỉ định định dạng GIF.
jpg chỉ định định dạng nén JPEG.
jpg-baseline chỉ định một định dạng nén JPEG không theo tiến trình.

Các ví dụ sau đây yêu cầu liên kết ở định dạng gif và png:

  https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=gif&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
  https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&format=png&&zoom=14&size=400x400&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

jpg và jpg-baseline thường cung cấp kích thước hình ảnh nhỏ nhất, mặc dù chúng hoạt động thông qua phương thức nén "có tổn hao", vì vậy, hình ảnh có thể bị giảm chất lượng. gif, png8 và png32 cung cấp tính năng nén không mất dữ liệu.

Hầu hết các hình ảnh JPEG đều có tính tiến bộ, nghĩa là những hình ảnh này sẽ tải một hình ảnh thô hơn trước đó và tinh chỉnh độ phân giải của hình ảnh khi có nhiều dữ liệu hơn. Tính năng này cho phép tải nhanh hình ảnh trong các trang web và là cách sử dụng JPEG phổ biến nhất hiện nay. Tuy nhiên, một số trường hợp sử dụng JPEG yêu cầu hình ảnh không tiến triển (cơ sở). Trong những trường hợp như vậy, bạn nên sử dụng định dạng jpg-baseline vì định dạng này không tiến hành.

Các loại bản đồ

API tĩnh của Maps tạo bản đồ ở nhiều định dạng như được liệt kê dưới đây:

roadmap (mặc định) chỉ định một hình ảnh lộ trình tiêu chuẩn, như hình ảnh thường hiển thị trên trang web Google Maps. Nếu bạn không chỉ định giá trị maptype, thì theo mặc định, API tĩnh của Maps sẽ phân phát các thẻ thông tin roadmap.
satellite chỉ định một hình ảnh vệ tinh.
terrain chỉ định một hình ảnh bản đồ cứu trợ thực tế, hiển thị địa hình và cây cối.
hybrid chỉ định sự kết hợp giữa hình ảnh vệ tinh và lộ trình, hiển thị một lớp trong suốt của các con phố chính và tên địa điểm trên hình ảnh vệ tinh.

Bạn có thể thấy sự khác biệt giữa các loại lộ trình và địa hình trong ví dụ về mã này.

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=roadmap&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=terrain&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Bản đồ pháp tuyến Manhattan Bản đồ địa hình Manhattan

Bản đồ kết hợp sử dụng hình ảnh vệ tinh và các tính năng nổi bật trong lộ trình để tạo bản đồ tổ hợp. Các ví dụ sau đây cho thấy các loại bản đồ vệ tinh và bản đồ kết hợp:

https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=satellite&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
https://maps.googleapis.com/maps/api/staticmap?center=40.714728,-73.998672&zoom=12&size=400x400&maptype=hybrid&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Bản đồ vệ tinh Manhattan Bản đồ địa hình Manhattan

Bản đồ được tạo kiểu

Tuỳ chỉnh cách trình bày bản đồ chuẩn của Google bằng cách áp dụng các kiểu của riêng bạn. Xem hướng dẫn tới bản đồ được tạo kiểu.

Đánh dấu

Tham số markers xác định một tập hợp một hoặc nhiều điểm đánh dấu (ghim bản đồ) tại một nhóm các vị trí. Mỗi điểm đánh dấu được xác định trong một nội dung khai báo markers phải thể hiện cùng một kiểu hình ảnh; nếu muốn hiển thị điểm đánh dấu theo nhiều kiểu, bạn sẽ cần cung cấp nhiều tham số markers với thông tin kiểu riêng biệt.

Tham số markers nhận tập hợp các giá trị chỉ định giá trị (bộ mô tả điểm đánh dấu) có định dạng sau:

markers=markerStyles|markerLocation1| markerLocation2|..., v.v.

Tập hợp markerStyles được khai báo ở đầu phần khai báo markers và bao gồm 0 hoặc nhiều phần mô tả kiểu được phân tách bằng ký tự gạch đứng (|), theo sau là một tập hợp một hoặc nhiều vị trí cũng được phân tách bằng ký tự gạch đứng (|).

Vì cả thông tin kiểu và thông tin vị trí đều được phân tách bằng ký tự gạch đứng, nên thông tin về kiểu phải xuất hiện đầu tiên trong mọi mã mô tả điểm đánh dấu. Sau khi máy chủ API tĩnh của Maps gặp phải một vị trí trong chỉ số mô tả điểm đánh dấu, tất cả các tham số điểm đánh dấu khác cũng được giả định là vị trí.

Kiểu đánh dấu

Bộ mã mô tả kiểu điểm đánh dấu là một chuỗi các phép gán giá trị được phân tách bằng ký tự gạch đứng (|). Mã mô tả kiểu này xác định các thuộc tính hình ảnh cần sử dụng khi hiển thị điểm đánh dấu trong chỉ số mô tả điểm đánh dấu này. Các chỉ số mô tả kiểu này chứa các gán giá trị/khoá sau:

size: (không bắt buộc) chỉ định kích thước của điểm đánh dấu từ {tiny, mid, small} đặt. Nếu bạn không đặt tham số size, điểm đánh dấu sẽ xuất hiện theo kích thước mặc định (bình thường).
color: (không bắt buộc) chỉ định màu 24 bit (ví dụ: color=0xFFFFCC) hoặc màu được xác định trước từ tập hợp {black, brown, green, purple, yellow, blue, gray, orange, red, white}.
Xin lưu ý rằng độ trong suốt (được chỉ định bằng giá trị màu hex 32 bit) không được hỗ trợ trong điểm đánh dấu, mặc dù chúng được hỗ trợ cho đường dẫn.
label: (không bắt buộc) chỉ định một ký tự chữ-số uppercase trong tập hợp {A-Z, 0-9}. (Yêu cầu về ký tự viết hoa mới đối với phiên bản API này.) Hãy lưu ý rằng mã đánh dấu có kích thước mặc định và có kích thước mid là những điểm đánh dấu duy nhất có khả năng hiển thị tham số alphanumeric-character. Các điểm đánh dấu tiny và small không thể hiển thị ký tự bao gồm chữ và số.

Điều chỉnh tỷ lệ điểm đánh dấu

Giá trị scale được nhân với kích thước hình ảnh điểm đánh dấu để tạo ra kích thước đầu ra thực tế của điểm đánh dấu tính bằng pixel. Giá trị tỷ lệ mặc định là 1; các giá trị được chấp nhận là 1, 2 và 4.

Giới hạn kích thước pixel đối với hình ảnh sẽ áp dụng sau khi áp dụng tỷ lệ. Ví dụ: nếu điểm đánh dấu được đặt thành scale:2, thì điểm đánh dấu có thể lớn hơn kích thước tối đa là 4096 pixel, miễn là nó giảm xuống dưới 4096 pixel sau khi điều chỉnh theo tỷ lệ. Sử dụng điều chỉnh tỷ lệ điểm đánh dấu cùng với tỷ lệ bản đồ khi hiển thị bản đồ có độ phân giải cao hơn.

Vị trí điểm đánh dấu

Mỗi bộ mô tả điểm đánh dấu phải chứa một tập hợp một hoặc nhiều vị trí xác định vị trí đặt điểm đánh dấu trên bản đồ. Các vị trí này có thể được chỉ định dưới dạng giá trị vĩ độ/kinh độ hoặc địa chỉ. Các vị trí này được phân tách bằng cách sử dụng ký tự gạch đứng (|).

Lưu ý: Nếu bạn chọn chỉ định vị trí của điểm đánh dấu bằng một phương pháp yêu cầu mã hoá địa lý, chẳng hạn như chuỗi địa chỉ hoặc hình nhiều dòng mà con người có thể đọc được, thì yêu cầu chỉ được có tối đa 15 điểm đánh dấu. Giới hạn này chỉ áp dụng cho các vị trí điểm đánh dấu yêu cầu mã hóa địa lý. Nó không áp dụng cho các vị trí điểm đánh dấu được xác định với vĩ độ/kinh độ.

Tham số vị trí xác định vị trí của điểm đánh dấu trên bản đồ. Nếu vị trí nằm ngoài bản đồ, điểm đánh dấu đó sẽ không xuất hiện trong hình ảnh đã tạo với điều kiện là có cung cấp tham số center và zoom. Tuy nhiên, nếu các tham số này không được cung cấp, máy chủ Maps Static API sẽ tự động tạo hình ảnh chứa các điểm đánh dấu đã cung cấp. (Xem phần Định vị ngầm.)

Bạn sẽ thấy mẫu khai báo về điểm đánh dấu tại đây. Lưu ý rằng chúng ta xác định một tập hợp kiểu và ba vị trí:

https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&size=400x400&
markers=color:blue%7Clabel:S%7C11211%7C11206%7C11222&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Ba mã bưu chính Brooklyn

Để xác định các điểm đánh dấu có các kiểu khác nhau, chúng ta cần cung cấp nhiều tham số markers. Tập hợp tham số markers này xác định 3 điểm đánh dấu: một điểm đánh dấu màu xanh dương có nhãn "S" tại 62.107733, -145.5419, một điểm đánh dấu nhỏ màu xanh lục có nhãn "Delta Junction, AK" và một điểm đánh dấu màu vàng cỡ trung có nhãn "C" tại "Tok, AK". Các điểm đánh dấu này được thể hiện trong ví dụ sau:

https://maps.googleapis.com/maps/api/staticmap?center=63.259591,-144.667969&zoom=6&size=400x400
&markers=color:blue%7Clabel:S%7C62.107733,-145.541936&markers=size:tiny%7Ccolor:green%7CDelta+Junction,AK
&markers=size:mid%7Ccolor:0xFFFF00%7Clabel:C%7CTok,AK"&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Ba thị trấn Alaska, điểm đánh dấu khác nhau

Biểu tượng tùy chỉnh

Thay vì sử dụng biểu tượng điểm đánh dấu của Google, bạn có thể sử dụng các biểu tượng tuỳ chỉnh của riêng mình. Các biểu tượng tuỳ chỉnh được chỉ định bằng cách sử dụng phần mô tả icon trong thông số markers. Ví dụ:

markers=icon:URLofIcon|markerLocation

Chỉ định icon bằng cách sử dụng một URL (phải được mã hoá URL). Bạn có thể sử dụng các URL được tạo bằng các dịch vụ rút ngắn URL như https://goo.gl. Hầu hết các dịch vụ rút ngắn URL đều có ưu điểm là tự động mã hoá URL.

Bạn có thể chỉ định một điểm neo cho biểu tượng tuỳ chỉnh. Điểm neo thiết lập cách đặt biểu tượng so với các vị trí markers đã chỉ định. Theo mặc định, điểm neo của một biểu tượng tuỳ chỉnh là tâm dưới cùng của hình ảnh biểu tượng. Bạn có thể chỉ định một điểm neo khác bằng cách sử dụng bộ mô tả anchor kết hợp với icon. Đặt anchor làm điểm x, y của biểu tượng (chẳng hạn như 10,5) hoặc làm điểm căn chỉnh định sẵn bằng một trong các giá trị sau: top, bottom, left, right, center, topleft, topright, bottomleft hoặc bottomright. Ví dụ:

markers=anchor:bottomright|icon:URLofIcon|markerLocation1|markerLocation2

Bạn có thể sử dụng tối đa 5 biểu tượng tuỳ chỉnh riêng biệt cho mỗi yêu cầu. Giới hạn này không có nghĩa là bạn chỉ bị giới hạn ở 5 vị trí được đánh dấu trên bản đồ. Bạn có thể sử dụng mỗi biểu tượng duy nhất với nhiều vị trí markers trên bản đồ.

Định dạng biểu tượng:

Hình ảnh biểu tượng có thể ở định dạng PNG, JPEG hoặc GIF, mặc dù bạn nên dùng tệp PNG.
Biểu tượng có thể có kích thước tối đa là 4096 pixel (64x64 đối với hình ảnh vuông).

Ví dụ về biểu tượng tuỳ chỉnh

Ví dụ 1 tạo biểu tượng tuỳ chỉnh và xác định vị trí của các biểu tượng bằng các neo.

https://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on
&style=feature:water%7Celement:geometry%7Cvisibility:on
&style=feature:landscape%7Celement:geometry%7Cvisibility:on
&markers=anchor:32,10%7Cicon:https://goo.gl/5y3S82%7CCanberra+ACT
&markers=anchor:topleft%7Cicon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC
&markers=anchor:topright%7Cicon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY
&signature=YOUR_SIGNATURE

Ba thị trấn ở Úc, có các biểu tượng tuỳ chỉnh khác nhau được định vị bằng các neo.

Ví dụ 2 tạo các biểu tượng tuỳ chỉnh giống như ví dụ 1, nhưng không đặt vị trí biểu tượng bằng neo, dựa vào neo mặc định ở chính giữa dưới cùng.

https://maps.googleapis.com/maps/api/staticmap?&size=600x400&style=visibility:on
&style=feature:water%7Celement:geometry%7Cvisibility:on
&style=feature:landscape%7Celement:geometry%7Cvisibility:on
&markers=icon:https://goo.gl/5y3S82%7CCanberra+ACT
&markers=icon:http://tinyurl.com/jrhlvu6%7CMelbourne+VIC
&markers=icon:https://goo.gl/1oTJ9Y%7CSydney+NSW&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Đường dẫn API tĩnh của Maps

Thông số path xác định một tập hợp một hoặc nhiều vị trí được kết nối bằng một đường dẫn để phủ lên hình ảnh bản đồ. Tham số path nhận tập hợp các giá trị chỉ định giá trị (bộ mô tả đường dẫn) theo định dạng sau:

path=pathStyles|pathLocation1|pathLocation2|..., v.v.

Xin lưu ý rằng cả hai điểm đường dẫn được phân tách với nhau bằng ký tự gạch đứng (|). Vì cả thông tin kiểu và thông tin điểm đều được phân tách bằng ký tự gạch đứng, nên thông tin kiểu phải xuất hiện đầu tiên trong mọi chỉ số mô tả đường dẫn. Sau khi máy chủ API tĩnh của Maps gặp phải một vị trí trong chỉ số mô tả đường dẫn, mọi tham số đường dẫn khác cũng được giả định là vị trí.

Kiểu đường dẫn

Tập hợp bộ mô tả kiểu đường dẫn là một chuỗi các phép gán giá trị được phân tách bằng ký tự gạch đứng (|). Mã mô tả kiểu này xác định các thuộc tính trực quan cần sử dụng khi hiển thị đường dẫn. Các chỉ số mô tả kiểu này chứa các phép gán khoá/giá trị sau:

weight: (không bắt buộc) chỉ định độ dày của đường dẫn tính bằng pixel. Nếu bạn không đặt tham số weight, đường dẫn sẽ xuất hiện với độ dày mặc định (5 pixel).
color: (không bắt buộc) chỉ định màu dưới dạng giá trị thập lục phân 24 bit (ví dụ: color=0xFFFFCC) hoặc giá trị thập lục phân 32 bit (ví dụ: color=0xFFFFCCFF) hoặc từ tập hợp {black, brown, green, purple, yellow, blue, gray, orange, red, white}.

Khi bạn chỉ định giá trị hex 32 bit, 2 ký tự cuối cùng sẽ chỉ định giá trị độ trong suốt alpha 8 bit. Giá trị này khác nhau trong khoảng từ 00 (hoàn toàn trong suốt) đến FF (hoàn toàn không trong suốt). Xin lưu ý rằng các đường dẫn được hỗ trợ độ trong suốt, mặc dù các điểm đánh dấu không được hỗ trợ độ trong suốt.
fillcolor: (không bắt buộc) cho biết cả đường dẫn đánh dấu một vùng đa giác và chỉ định màu nền để sử dụng làm lớp phủ trong khu vực đó. Tập hợp các vị trí theo sau không cần phải là một vòng lặp "khép kín"; máy chủ API tĩnh của Maps sẽ tự động kết hợp điểm đầu tiên và điểm cuối cùng. Tuy nhiên, lưu ý rằng mọi nét vẽ ở bên ngoài khu vực được tô màu nền sẽ không bị đóng trừ khi bạn cung cấp cụ thể cùng một vị trí bắt đầu và kết thúc.
geodesic: (không bắt buộc) cho biết rằng đường dẫn được yêu cầu sẽ được hiểu là một đường trắc địa theo độ cong của trái đất. Khi giá trị là false, đường dẫn sẽ hiển thị dưới dạng một đường thẳng trong không gian màn hình. Giá trị mặc định là false.

Một số ví dụ về định nghĩa đường dẫn:

Đường màu xanh lam mỏng, độ mờ 50%: path=color:0x0000ff80|weight:1
Đường màu đỏ liền nét: path=color:0xff0000ff|weight:5
Đường màu trắng đậm: path=color:0xffffffff|weight:10

Các kiểu đường dẫn này là không bắt buộc. Nếu muốn có các thuộc tính mặc định, bạn có thể bỏ qua bước xác định các thuộc tính đường dẫn; trong trường hợp đó, "đối số" đầu tiên của chỉ số mô tả đường dẫn sẽ bao gồm thay vì điểm (vị trí) được khai báo đầu tiên.

Điểm đường đi

Để vẽ đường dẫn, tham số path cũng phải được truyền từ 2 điểm trở lên. Sau đó, Maps Static API sẽ kết nối đường dẫn dọc theo các điểm đó, theo thứ tự được chỉ định. Mỗi pathPoint được biểu thị bằng pathDescriptor, phân tách bằng ký tự | (dấu sổ thẳng).

Ví dụ sau đây xác định một đường dẫn màu xanh dương có độ mờ mặc định là 50% từ Quảng trường Union New York đến Quảng trường Thời đại, New York.

Đường dẫn từ Union Sq đến Times Sq

Thông số cụ thể của tham số path là:

path=color:0x0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

Ví dụ sau đây xác định cùng một đường dẫn thay vì xác định một đường màu đỏ đồng nhất có độ mờ 100%:

Đường dẫn từ Union Sq đến Times Sq

Thông số cụ thể của tham số path này là:

path=color:0xff0000ff|weight:5|40.737102,-73.990318|40.749825,-73.987963|40.752946,-73.987384|40.755823,-73.986397

Ví dụ tiếp theo xác định một khu vực đa giác trong Manhattan, chuyển qua một loạt các giao điểm dưới dạng vị trí:

Đường dẫn từ Union Sq đến Times Sq

Thông số cụ thể của tham số path này là:

path=color:0x00000000|weight:5|fillcolor:0xFFFF0033|8th+Avenue+%26+34th+St,New+York,NY|\
8th+Avenue+%26+42nd+St,New+York,NY|Park+Ave+%26+42nd+St,New+York,NY,NY|\
Park+Ave+%26+34th+St,New+York,NY,NY

Xin lưu ý rằng chúng ta đặt chính đường dẫn thành không hiển thị và khu vực đa giác có độ mờ 15%.

Hình nhiều đường đã mã hoá

Thay vì một loạt vị trí, bạn có thể khai báo một đường dẫn dưới dạng hình nhiều đường được mã hoá bằng cách sử dụng tiền tố enc: trong phần khai báo vị trí của path.

Ví dụ sau đây mô tả lộ trình của Đường cao tốc Alaska từ Dawson Creek, BC đến Delta Junction, AK bằng một hình nhiều đường được mã hoá:

https://maps.googleapis.com/maps/api/staticmap
?size=400x400&center=59.900503,-135.478011&zoom=4
&path=weight:3%7Ccolor:orange%7Cenc:_fisIp~u%7CU}%7Ca@pytA_~b@hhCyhS~hResU%7C%7Cx@oig@rwg@amUfbjA}f[roaAynd@%7CvXxiAt{ZwdUfbjAewYrqGchH~vXkqnAria@c_o@inc@k{g@i`]o%7CF}vXaj\h`]ovs@?yi_@rcAgtO%7Cj_AyaJren@nzQrst@zuYh`]v%7CGbldEuzd@%7C%7Cx@spD%7CtrAzwP%7Cd_@yiB~vXmlWhdPez\_{Km_`@~re@ew^rcAeu_@zhyByjPrst@ttGren@aeNhoFemKrvdAuvVidPwbVr~j@or@f_z@ftHr{ZlwBrvdAmtHrmT{rOt{Zz}E%7Cc%7C@o%7CLpn~AgfRpxqBfoVz_iAocAhrVjr@rh~@jzKhjp@``NrfQpcHrb^k%7CDh_z@nwB%7Ckb@a{R%7Cyh@uyZ%7CllByuZpzw@wbd@rh~@%7C%7CFhqs@teTztrAupHhyY}t]huf@e%7CFria@o}GfezAkdW%7C}[ocMt_Neq@ren@e~Ika@pgE%7Ci%7CAfiQ%7C`l@uoJrvdAgq@fppAsjGhg`@%7ChQpg{Ai_V%7C%7Cx@mkHhyYsdP%7CxeA~gF%7C}[mv`@t_NitSfjp@c}Mhg`@sbChyYq}e@rwg@atFff}@ghN~zKybk@fl}A}cPftcAite@tmT__Lha@u~DrfQi}MhkSqyWivIumCria@ciO_tHifm@fl}A{rc@fbjAqvg@rrqAcjCf%7Ci@mqJtb^s%7C@fbjA{wDfs`BmvEfqs@umWt_Nwn^pen@qiBr`xAcvMr{Zidg@dtjDkbM%7Cd_@
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Đường cao tốc Alaska

Tương tự như với đường dẫn tiêu chuẩn, đường dẫn nhiều đường được mã hoá cũng có thể phân cách các vùng đa giác nếu đối số fillcolor được chuyển đến tham số path.

Ví dụ sau đây phác thảo một khu vực đa giác cho Brooklyn, NY:

https://maps.googleapis.com/maps/api/staticmap
?size=400x400&center=40.653279,-73.959816&zoom=11
&path=fillcolor:0xAA000033%7Ccolor:0xFFFFFF00%7Cenc:}zswFtikbMjJzZ%7CRdPfZ}DxWvBjWpF~IvJnEvBrMvIvUpGtQpFhOQdKpz@bIx{A%7CPfYlvApz@bl@tcAdTpGpVwQtX}i@%7CGen@lCeAda@bjA%60q@v}@rfAbjA%7CEwBpbAd_@he@hDbu@uIzWcWtZoTdImTdIwu@tDaOXw_@fc@st@~VgQ%7C[uPzNtA%60LlEvHiYyLs^nPhCpG}SzCNwHpz@cEvXg@bWdG%60]lL~MdTmEnCwJ[iJhOae@nCm[%60Aq]qE_pAaNiyBuDurAuB }}Ay%60@%7CEKv_@?%7C[qGji@lAhYyH%60@Xiw@tBerAs@q]jHohAYkSmW?aNoaAbR}LnPqNtMtIbRyRuDef@eT_z@mW_Nm%7CB~j@zC~hAyUyJ_U{Z??cPvg@}s@sHsc@_z@cj@kp@YePoNyYyb@_iAyb@gBw^bOokArcA}GwJuzBre@i\tf@sZnd@oElb@hStW{]vv@??kz@~vAcj@zKa%60Atf@uQj_Aee@pU_UrcA
&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Polyline mã hóa ở Brooklyn có chữ ký

Khung nhìn

Hình ảnh có thể chỉ định một khung nhìn bằng cách chỉ định các vị trí hiển thị bằng cách sử dụng tham số visible. Tham số visible hướng dẫn dịch vụ API tĩnh của Maps tạo bản đồ sao cho các vị trí hiện có vẫn hiển thị. (Tham số này cũng có thể được kết hợp với các điểm đánh dấu hoặc đường dẫn hiện có để xác định một khu vực hiển thị.) Việc xác định khung nhìn theo cách này sẽ không cần chỉ định mức thu phóng chính xác.

Ví dụ tiếp theo yêu cầu một bản đồ được căn giữa tại Boston, MA chứa cả MIT và Quảng trường Harvard ở Cambridge, MA:

https://maps.googleapis.com/maps/api/staticmap?center=Boston,MA
&visible=77+Massachusetts+Ave,Cambridge,MA%7CHarvard+Square,Cambridge,MA&size=512x512&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Bản đồ Cambridge

Định vị ngầm của bản đồ

Thông thường, bạn cần chỉ định các tham số URL center và zoom để xác định vị trí và mức thu phóng của bản đồ đã tạo. Tuy nhiên, nếu cung cấp tham số markers, path hoặc visible, bạn có thể để API tĩnh của Maps xác định mặc định vị trí trung tâm và mức thu phóng chính xác, dựa trên việc đánh giá vị trí của các phần tử này.

Nếu cung cấp hai hoặc nhiều phần tử, API tĩnh của Maps sẽ xác định mức độ trung tâm và mức thu phóng phù hợp, cung cấp lề rộng cho các phần tử có trong. Ví dụ này hiển thị bản đồ chứa San Francisco, Oakland và San Jose, CA:

https://maps.googleapis.com/maps/api/staticmap?size=512x512&maptype=roadmap\
&markers=size:mid%7Ccolor:red%7CSan+Francisco,CA%7COakland,CA%7CSan+Jose,CA&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Bản đồ đường đi

Kích thước hình ảnh lớn hơn

Nếu bạn cần hình ảnh có kích thước lớn hơn 640 x 640 pixel (hoặc 1280 x 1280 pixel với giá trị tỷ lệ là 2), vui lòng liên hệ với nhóm hỗ trợ và cung cấp những thông tin sau:

Trường hợp sử dụng của bạn và lý do bạn cần hình ảnh có kích thước lớn.
Liệu bạn đã cân nhắc sử dụng các API khác của Nền tảng Google Maps (API JavaScript của Maps, API nhúng của Maps, SDK Maps dành cho Android hay SDK Maps dành cho iOS) và tại sao những API này không đáp ứng được nhu cầu của bạn.
Ảnh chụp màn hình, bản mô phỏng hoặc mẫu về cách bạn sẽ sử dụng hình ảnh có kích thước lớn.
Mức sử dụng hình ảnh có kích thước lớn ước tính hằng tháng.

Chúng tôi sẽ xem xét yêu cầu của bạn dựa trên thông tin bạn cung cấp và xác định xem trường hợp sử dụng của bạn có tuân thủ Điều khoản dịch vụ của Nền tảng Google Maps hay không.

Kích thước tối đa chúng tôi có thể cung cấp là 2048 x 2048 pixel.

Khắc phục vấn đề và hỗ trợ

Để biết thêm thông tin về cách sử dụng API tĩnh của Maps, hãy tham khảo trang hỗ trợ.

API tĩnh của Maps có thể đưa ra lỗi hoặc cảnh báo khi có sự cố. Cụ thể, bạn nên kiểm tra các cảnh báo nếu nhận thấy thiếu gì đó trên bản đồ. Bạn cũng nên kiểm tra các cảnh báo trước khi chạy ứng dụng mới. Xin lưu ý rằng các cảnh báo có thể không rõ ràng ngay lập tức vì chúng xuất hiện trong tiêu đề HTTP. Để biết thêm thông tin, hãy xem hướng dẫn về lỗi và cảnh báo.