Maps Static API có thể đưa ra lỗi hoặc cảnh báo khi có sự cố. Hướng dẫn này giải thích từng thông báo lỗi và cung cấp thêm hướng dẫn để giải quyết lỗi.
Yêu cầu không hợp lệ
Trong trường hợp yêu cầu không hợp lệ, API tĩnh của Maps sẽ trả về một mã trạng thái HTTP 4xx và một thông báo mô tả vấn đề. Dưới đây là ví dụ về các điều kiện lỗi như vậy. Lưu ý: Đây không phải là danh sách đầy đủ các lỗi có thể xảy ra. Vui lòng kiểm tra mã lỗi thực tế và thông báo do API trả về để biết thông tin chi tiết về các vấn đề cụ thể.
| Ví dụ về điều kiện lỗi | Mã trạng thái |
|---|---|
Yêu cầu có một tham số không hợp lệ hoặc thiếu một tham số bắt buộc. Ví dụ: thông số size không nằm trong phạm vi giá trị số dự kiến hoặc bị thiếu trong yêu cầu. |
400 BAD REQUEST |
| Khoá API trong yêu cầu là không hợp lệ. | 403 FORBIDDEN |
Lỗi khiến bản đồ không hiển thị
Nếu yêu cầu hợp lệ nhưng một lỗi khác xảy ra khiến bản đồ không hiển thị, thì API tĩnh của Maps sẽ trả về văn bản hoặc hình ảnh lỗi thay vì bản đồ, tuỳ thuộc vào lỗi. Ví dụ về điều kiện lỗi như vậy là khi ứng dụng vượt quá giới hạn sử dụng.
Lỗi liên quan đến khoá API và thông tin thanh toán
Nếu bạn sử dụng API Maps Static mà không có khoá API hoặc nếu tính năng thanh toán không được bật trên tài khoản của bạn, thì trang sẽ hiển thị hình ảnh lỗi thay vì bản đồ, kèm theo đường liên kết cho biết loại lỗi. Ví dụ: "g.co/staticmaperror/key".
| Lỗi và giải pháp liên quan đến hệ thống khoá không cần chìa | |
|---|---|
 |
Bạn đang sử dụng API Tĩnh của Maps mà không có khoá API. Để giải quyết vấn đề này, bạn phải: |
 |
Yêu cầu của bạn thiếu chữ ký số (bắt buộc). Để giải quyết, hãy ký URL của bạn |
Cảnh báo
Đối với một số điều kiện lỗi, API sẽ trả về một bản đồ nhưng có thể bản đồ đó bị thiếu một số thông tin. Khi điều này xảy ra, hai điều kiện sẽ xảy ra để thông báo cho bạn về cảnh báo.
- Một là bản đồ hiển thị, nhưng có một thanh lỗi màu vàng chồng lên đầu bản đồ với văn bản "Lỗi bản đồ: g.co/staticmaperror".
- Thứ hai, API trả về một cảnh báo dưới dạng tiêu đề HTTP có tên là
X-Staticmap-API-Warning.
Ví dụ: URL sau đây chứa một giá trị không mong muốn trong tham số markers:
https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&scale=1&size=400x400&markers=sdgaags&key=YOUR_API_KEY
API trả về một bản đồ, nhưng hiển thị một thanh lỗi màu vàng phủ lên hình ảnh với "Lỗi bản đồ: g.co/staticmaperror":
API này cũng trả về tiêu đề HTTP sau:
X-Staticmap-API-Warning:Error geocoding: marker 1
Bảng sau đây mô tả các cảnh báo mà API có thể đưa ra dưới dạng tiêu đề HTTP:
Cảnh báo trong tiêu đề X-Staticmap-API-Warning
|
|
|---|---|
Error geocoding:
[center, ][marker #number, ][visible #num, ][path #num, ]* |
Đã xảy ra lỗi trong khi cố gắng mã hoá địa lý yêu cầu. Có nhiều biến thể của thông báo này, tuỳ thuộc vào phần tử không được mã hoá địa lý (trung tâm, điểm đánh dấu, hiển thị hoặc đường dẫn) và số lượng phần tử không được mã hoá địa lý. Một ví dụ về cảnh báo này là X-Staticmap-API-Warning:Error geocoding: marker 1, như trong ví dụ trên. |
Too many geocoded markers requested (max is 15). |
Yêu cầu chỉ định nhiều hơn số lượng điểm đánh dấu tối đa được phép có địa chỉ mà con người có thể đọc được. Số lượng tối đa là 15. Xin lưu ý rằng giới hạn này chỉ áp dụng cho các điểm đánh dấu được chỉ định là địa chỉ mà con người đọc được và yêu cầu mã hoá địa lý. Phương thức này không áp dụng cho các điểm đánh dấu được chỉ định bằng tọa độ vĩ độ/kinh độ. |
Too many geocoded polyline vertices requested (max is 15). |
Yêu cầu chỉ định nhiều hơn số lượng đa tuyến tối đa được phép có địa chỉ mà con người có thể đọc được. Số lượng tối đa là 15. Xin lưu ý rằng giới hạn này chỉ áp dụng cho các đa tuyến có đỉnh được chỉ định là địa chỉ mà con người có thể đọc được và cần phải được mã hoá địa lý. Phương thức này không áp dụng cho các đường đa tuyến được chỉ định bằng tọa độ vĩ độ/kinh độ. |
Bạn có thể thấy cảnh báo tiêu đề HTTP trong Bảng điều khiển Công cụ cho nhà phát triển Chrome, Bảng điều khiển web Firefox hoặc các công cụ tương đương khác trong trình duyệt.