Yêu cầu Hình ảnh trong Chế độ xem đường phố là một URL loại HTTP ở định dạng sau:
https://maps.googleapis.com/maps/api/streetview?parameters
Hình ảnh này được chỉ định bằng các tham số yêu cầu. Như tiêu chuẩn trong URL, tất cả các tham số được phân tách bằng ký tự dấu và (&). Dưới đây là danh sách các tham số được phép và giá trị có thể có của chúng.
Thông số bắt buộc
Hãy thực hiện một trong các thao tác sau:
location
có thể là một chuỗi văn bản (chẳng hạn nhưChagrin Falls, OH
) hoặc một cặp toạ độ vĩ độ và kinh độ (40.457375,-80.009353
) và phải được mã hoá URL. Vì vậy, hãy chuyển đổi các địa chỉ như "Hội trường thành phố, New York, NY" thành "Thành phố+Hall,New+New York,NY" trước khi gửi yêu cầu. API Chế độ xem đường phố tĩnh sẽ chụp ảnh toàn cảnh gần vị trí nhất. Khi bạn cung cấp một chuỗi văn bản địa chỉ, API có thể dùng một vị trí khác của máy ảnh để hiển thị tốt hơn vị trí được chỉ định đó. Khi bạn cung cấp toạ độ (vĩ độ và kinh độ), API sẽ tìm kiếm trong bán kính 50 mét để có ảnh gần vị trí nhất. Vì hình ảnh trong Chế độ xem đường phố được làm mới định kỳ và mỗi lần ảnh có thể được chụp ở các vị trí hơi khác nhau, nên có khả nănglocation
của bạn có thể chụp một ảnh toàn cảnh khác khi hình ảnh được cập nhật.
hoặc:
pano
là một mã nhận dạng ảnh toàn cảnh cụ thể. Ảnh toàn cảnh có thể thay đổi mã nhận dạng theo thời gian, vì vậy, đừng duy trì mã nhận dạng này. Thay vào đó, hãy lưu địa chỉ vị trí hoặc vĩ độ và kinh độ để bạn có thể làm mới mã nhận dạng ảnh toàn cảnh. Để biết thông tin chi tiết, hãy xem phần Làm mới mã nhận dạng ảnh toàn cảnh đã xoá.
Cũng như:
size
chỉ định kích thước đầu ra của hình ảnh tính bằng pixel. Kích thước được chỉ định là{width}x{height}
– ví dụ:size=600x400
trả về một hình ảnh rộng 600 pixel và cao 400.key
cho phép bạn giám sát mức sử dụng API của ứng dụng trong Google Cloud Console, đồng thời đả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 Nhận khoá và chữ ký.
Làm mới mã ảnh toàn cảnh đã xoá
Nếu bạn cố gắng truy xuất mã nhận dạng ảnh toàn cảnh nhưng nhận được ZERO_RESULTS
hoặc không có giá trị nào, thì mã nhận dạng ảnh toàn cảnh đã bị xoá và cần được làm mới.
Lưu địa chỉ vị trí hoặc vĩ độ và kinh độ bạn đã sử dụng để nhận ID ảnh toàn cảnh để bạn có thể làm mới khi cần.
Khi bạn phát hiện thấy mã nhận dạng ảnh toàn cảnh đã thay đổi, hãy sử dụng địa chỉ vị trí ban đầu hoặc vĩ độ và kinh độ để tìm kiếm lại ảnh toàn cảnh gần nhất với vị trí đó và nhận mã nhận dạng ảnh toàn cảnh mới.
Thông số tùy chọn
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. Những yêu cầu không bao gồm chữ ký số có thể không thành công. Để biết thêm thông tin, hãy xem bài viết Nhận khoá và chữ ký.Lưu ý: Đối với những người từng sử dụng Gói cao cấp của Nền tảng Google Maps, bắt buộc phải có chữ ký số. Tìm hiểu thêm thông tin về thông số xác thực cho khách hàng sử dụng Gói đặc biệt.
heading
cho biết hướng la bàn của máy ảnh. Các giá trị được chấp nhận là từ0
đến360
(cả hai giá trị cho biết Bắc, trong đó90
cho biết Đông và180
Nam). Nếu bạn không chỉ định tiêu đề, thì một giá trị sẽ được tính để hướng máy ảnh về phíalocation
được chỉ định, từ điểm chụp ảnh gần nhất.fov
(mặc định là90
) xác định trường nhìn theo chiều ngang của hình ảnh được biểu thị bằng độ, với giá trị tối đa được phép là120
. Khi xử lý khung nhìn có kích thước cố định, như với hình ảnh Chế độ xem đường phố có kích thước đã đặt, về bản chất trường xem sẽ thể hiện mức thu phóng, còn số nhỏ hơn cho biết mức thu phóng cao hơn.
(Trái:fov=120
; Phải:fov=20
)pitch
(mặc định là0
) chỉ định góc lên hoặc xuống của máy ảnh so với xe phục vụ Chế độ xem đường phố. Đây là định dạng ngang phẳng thường nhưng không phải lúc nào cũng hiển thị. Giá trị dương giúp điều chỉnh góc camera lên (trong đó90
độ cho biết góc hướng thẳng lên); giá trị âm hướng camera xuống dưới (trong đó-90
cho biết góc camera hướng xuống dưới).radius
(mặc định là50
) đặt bán kính (được chỉ định theo mét) mà trong đó để tìm kiếm ảnh toàn cảnh, nằm ở giữa vĩ độ và kinh độ cho trước. Giá trị hợp lệ là số nguyên không âm.return_error_code
cho biết liệu API có trả về một mã lỗi khi không tìm thấy hình ảnh nào (404 NOT FOUND) hay để phản hồi một yêu cầu không hợp lệ (400 YÊU CẦU XẤU). Các giá trị hợp lệ làtrue
vàfalse
. Nếu bạn đặt thànhtrue
, một thông báo lỗi sẽ được trả về thay cho hình ảnh màu xám chung. Nhờ đó, bạn không cần thực hiện một lệnh gọi riêng để kiểm tra xem có sẵn hình ảnh hay không.source
(mặc định làdefault
) giới hạn các tìm kiếm trong Chế độ xem đường phố ở các nguồn đã chọn. Có các giá trị hợp lệ như sau:default
sử dụng các nguồn mặc định cho Chế độ xem đường phố; lượt tìm kiếm không chỉ giới hạn ở các nguồn cụ thể.outdoor
giới hạn việc tìm kiếm ở các bộ sưu tập ngoài trời. Các bộ sưu tập trong nhà không được đưa vào kết quả tìm kiếm. Lưu ý rằng ảnh toàn cảnh ngoài trời có thể không tồn tại cho vị trí được chỉ định. Ngoài ra, xin lưu ý rằng tính năng tìm kiếm chỉ trả về ảnh toàn cảnh khi có thể xác định là chúng là trong nhà hay ngoài trời. Ví dụ: PhotoSpheres không được trả về vì không xác định được là ở trong nhà hay ngoài trời.
Đây là một yêu cầu mẫu.
https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
Không có hình ảnh nào
Đối với những vị trí không có hình ảnh Chế độ xem đường phố, API tĩnh của Chế độ xem đường phố sẽ trả về một hình ảnh chung màu xám, kèm theo văn bản "Rất tiếc, chúng tôi không có hình ảnh ở đây.", như trong ví dụ sau:
Chỉ hiển thị hình ảnh hợp lệ
Để tránh hiển thị hình ảnh chung chung và đảm bảo rằng trang web của bạn chỉ hiển thị hình ảnh API tĩnh của Chế độ xem đường phố hợp lệ, hãy làm theo các đề xuất sau:
- Đặt tham số
return_error_code
thànhtrue
. Điều này khiến API Tĩnh của Chế độ xem đường phố trả về lỗi 404 NOT FOUND thay cho hình ảnh màu xám chung, nếu không có hình ảnh nào cho vị trí đã chỉ định. - Yêu cầu siêu dữ liệu hình ảnh trong Chế độ xem đường phố để xác định xem có hình ảnh cho vị trí đã chỉ định hay không trước khi gửi yêu cầu.