Khi một yêu cầu không thành công, API tĩnh của Chế độ xem đường phố sẽ trả về lỗi hoặc cảnh báo. Hướng dẫn này giải thích các thông báo lỗi và hướng dẫn cách giải quyết.
Yêu cầu không hợp lệ
Đối với yêu cầu không hợp lệ, API tĩnh của Chế độ xem đường phố sẽ trả về mã trạng thái HTTP 4xx và thông báo mô tả vấn đề. Bảng sau đây liệt kê các ví dụ về những điều kiện lỗi như vậy, mặc dù đây chưa phải là danh sách đầy đủ các lỗi có thể xảy ra. Bạn có thể kiểm tra mã lỗi thực tế và thông báo mà 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ó 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ố 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 không hợp lệ. | 403 FORBIDDEN |
Lỗi khiến hình ảnh trong Chế độ xem đường phố không hiển thị
Nếu yêu cầu hợp lệ nhưng xảy ra một lỗi khác khiến hình ảnh trong Chế độ xem đường phố không hiển thị, thì API Chế độ xem đường phố tĩnh sẽ trả về văn bản hoặc hình ảnh lỗi thay vì hình ảnh trong Chế độ xem đường phố, tuỳ thuộc vào lỗi. Ví dụ về một đ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 Street View 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 trên tài khoản của mình, thì trang sẽ hiển thị hình ảnh lỗi thay vì hình ảnh chế độ xem đường phố, kèm theo một đường liên kết cho biết loại lỗi. Ví dụ: "g.co/streetviewerror/key".
| Lỗi và giải pháp khi không dùng khoá | |
|---|---|
 |
Bạn đang sử dụng Street View 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. |