Maps Static API sẽ đưa ra lỗi hoặc cảnh báo khi một yêu cầu không thành công. Hướng dẫn này giải thích các thông báo lỗi và cung cấp hướng dẫn về cách giải quyết các thông báo lỗi đó.
Số yêu cầu không hợp lệ
Đối với một yêu cầu không hợp lệ, Maps Static API sẽ trả về mã trạng thái HTTP 4xx và một thông báo mô tả vấn đề, như trong danh sách sau. 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ể.
- Yêu cầu có chứa một tham số không hợp lệ hoặc thiếu một tham số bắt buộc. Ví dụ: tham số
sizekhông nằm trong phạm vi dự kiến của các giá trị dạng số 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ị được
Nếu yêu cầu hợp lệ nhưng xảy ra một lỗi khác khiến bản đồ không hiển thị được, thì Maps Static API sẽ trả về văn bản hoặc hình ảnh lỗi thay vì bản đồ. Ví dụ: lỗi xảy ra khi ứng dụng vượt quá hạn mức sử dụng.
Các lỗi liên quan đến khoá API và việc thanh toán
Nếu bạn sử dụng Maps Static API mà không có khoá API hoặc nếu bạn chưa bật tính năng thanh toán trong tài khoản của mình, thì trang sẽ hiển thị một hình ảnh lỗi thay vì bản đồ, kèm theo một đường liên kết cho biết loại lỗi. Ví dụ: "g.co/staticmaperror/key".
| Các lỗi và giải pháp liên quan đến khoá | |
|---|---|
 |
Bạn đang sử dụng Maps Static API mà không có khoá API. Để giải quyết lỗi này, hãy hoàn tất các bước sau: |
 |
Yêu cầu của bạn thiếu chữ ký số bắt buộc. Để giải quyết lỗi này, 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 một số thông tin có thể bị thiếu trong bản đồ. Khi điều này xảy ra, bạn có thể xác định cảnh báo bằng cách sử dụng các điều kiện sau:
- Bản đồ xuất hiện với một thanh lỗi màu vàng chồng lên bản đồ cùng với văn bản "Lỗi bản đồ: g.co/staticmaperror".
- API này 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 này trả về một bản đồ, nhưng hiển thị một thanh lỗi màu vàng chồng lên hình ảnh có văn bản "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 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ử mà quá trình mã hoá địa lý không thành công, chẳng hạn như center, marker, visible hoặc path và số lượng phần tử không thành công. Một ví dụ về cảnh báo này là X-Staticmap-API-Warning:Error geocoding: marker 1, như minh hoạ trong ví dụ trước. |
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. Tối đa là 15. 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ó thể đọc được và cần được mã hoá địa lý. Quy tắc này không áp dụng cho các điểm đánh dấu được chỉ định bằng toạ độ vĩ độ và kinh độ. |
Too many geocoded polyline vertices requested (max is 15). |
Yêu cầu chỉ định nhiều hơn số lượng tối đa được phép của nhiều đường với một địa chỉ mà con người có thể đọc được. Tối đa là 15. Giới hạn này chỉ áp dụng cho các đường nhiều đoạn có đỉnh được chỉ định là địa chỉ mà con người có thể đọc được và cần phải mã hoá địa lý. Thay đổi này không áp dụng cho các đường nhiều đoạn được chỉ định bằng toạ độ vĩ độ và kinh độ. |
Bạn có thể xem các cảnh báo về tiêu đề HTTP trong Chrome DevTools Console, 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 của bạn.