Khi một yêu cầu không thành công, Street View Static API sẽ trả về một 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à 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ệ, Street View Static API sẽ trả về mã trạng thái HTTP 4xx và một thông báo mô tả vấn đề. Bảng sau đây liệt kê ví dụ về các đ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 và thông báo thực tế 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ó 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 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 hình ảnh trong Chế độ xem đường phố 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 hình ảnh Chế độ xem đường phố không hiển thị được, thì Street View Static API sẽ trả về văn bản hoặc hình ảnh lỗi thay vì hình ảnh Chế độ xem đường phố, 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.
Các lỗi liên quan đến khoá API và việc 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 trong tài khoản, thì trang sẽ hiển thị một 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".
| Các lỗi và giải pháp liên quan đến 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. |