Yêu cầu Hình ảnh đường phố là một URL HTTP theo định dạng sau:
https://maps.googleapis.com/maps/api/streetview?parameters
Hình ảnh được chỉ định bằng các tham số yêu cầu. Theo 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à (&). Các thông số được phép và giá trị có thể có của các thông số đó được liệt kê bên dưới.
Thông số bắt buộc
Hãy thực hiện một trong hai thao tác sau:
locationcó 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ư "City Hall, New York, NY" thành "City+Hall,New+York,NY" trước khi bạn gửi yêu cầu. Street View Static API sẽ chụp ảnh toàn cảnh gần nhất với vị trí đó. Khi bạn cung cấp một chuỗi văn bản địa chỉ, API có thể sử dụng một vị trí máy ảnh khác để hiển thị vị trí đã chỉ định rõ ràng hơn. Khi bạn cung cấp toạ độ vĩ độ và kinh độ, API sẽ tìm kiếm trong bán kính 50 mét để tìm ảnh chụp gần nhất với vị trí đó. Vì hình ảnh của Chế độ xem đường phố được làm mới định kỳ và mỗi lần chụp ảnh có thể ở vị trí hơi khác nhau, nênlocationcó thể chụp ảnh toàn cảnh khác khi hình ảnh được cập nhật.
hoặc:
panolà 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, hãy lưu trữ mã nhận dạng này. Thay vào đó, hãy lưu địa chỉ vị trí hoặc tọa độ vĩ độ và kinh độ để bạn có thể làm mới mã cảnh toàn cảnh. Để biết thông tin chi tiết, hãy xem bài viết Làm mới mã nhận dạng ảnh toàn cảnh đã xoá.
Ngoài ra:
sizechỉ đị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=600x400trả về một hình ảnh có chiều rộng 600 pixel và chiều cao 400 pixel.keycho phép bạn theo dõi mức sử dụng API của ứng dụng trong Google Cloud Console và đảm bảo rằng Google có thể liên hệ với bạn về ứng dụng của bạn nếu cần. Để biết thêm thông tin, hãy xem bài viết Lấy khoá và chữ ký.
Làm mới mã nhận dạng ả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 và 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 toạ độ vĩ độ và kinh độ mà bạn đã dùng để nhận mã toàn cảnh để có thể làm mới khi cần.
Khi bạn phát hiện mã hình ảnh toàn cảnh đã thay đổi, hãy sử dụng địa chỉ vị trí ban đầu hoặc toạ độ vĩ độ và kinh độ để tìm lại hình ảnh toàn cảnh gần nhất với vị trí đó và lấy mã hình ảnh toàn cảnh mới.
Thông số tùy chọn
signature(nên dùng) là 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 uỷ quyền để thực hiện việc này. Các yêu cầu không có 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 Lấy khoá và chữ ký.Lưu ý: đối với khách hàng cũ của Gói cao cấp trên Nền tảng Google Maps, bạn bắt buộc phải có chữ ký kỹ thuật số. Xem thêm thông tin về các tham số xác thực dành cho khách hàng sử dụng Gói cao cấp.
headingcho biết hướng la bàn của camera. Các giá trị được chấp nhận là từ0đến360(cả hai giá trị đều chỉ hướng Bắc, với90chỉ hướng Đông và180chỉ hướng Nam). Nếu bạn không chỉ định tiêu đề, hệ thống sẽ tính toán một giá trị để hướng máy ảnh về phíalocationđã 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 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, chẳng hạn như hình ảnh Chế độ xem đường phố có kích thước đã đặt, trường nhìn về cơ bản thể hiện mức thu phóng, với các 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 Chế độ xem đường phố. Kiểu này thường (nhưng không phải lúc nào cũng) nằm ngang. Giá trị dương nghiêng máy ảnh lên trên (với90độ cho biết hướng thẳng lên trên); giá trị âm nghiêng máy ảnh xuống dưới (với-90cho biết hướng thẳng xuống dưới).radius(mặc định là50) đặt bán kính, được chỉ định bằng mét, trong đó để tìm kiếm ảnh toàn cảnh, tập trung vào vĩ độ và kinh độ đã cho. Các giá trị hợp lệ là số nguyên không âm.return_error_codecho biết API có nên trả về một mã lỗi khi không tìm thấy hình ảnh (404 NOT FOUND) hay phản hồi một yêu cầu không hợp lệ (400 BAD REQUEST). Các giá trị hợp lệ làtruevàfalse. Nếu được đặt thànhtrue, 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 phải thực hiện một lệnh gọi riêng để kiểm tra tình trạng có sẵn hình ảnh.source(mặc định làdefault) giới hạn nội dung tìm kiếm trên Chế độ xem đường phố ở các nguồn đã chọn. Có các giá trị hợp lệ như sau:defaultsử dụng các nguồn mặc định cho Chế độ xem đường phố; các nội dung tìm kiếm không bị giới hạn ở một số nguồn cụ thể.outdoorgiới hạn nội dung 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. Xin lưu ý rằng có thể không có ảnh toàn cảnh ngoài trời cho vị trí đã chỉ định. Ngoài ra, hãy lưu ý rằng tính năng tìm kiếm chỉ trả về ảnh toàn cảnh có thể xác định được là trong nhà hay ngoài trời. Ví dụ: ảnh toàn cảnh 360 độ sẽ không được trả về vì không xác định được ảnh đó được chụp 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 Chế độ xem đường phố sẽ trả về một hình ảnh chung 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 và đảm bảo rằng trang web của bạn chỉ hiển thị hình ảnh hợp lệ của API Chế độ xem đường phố tĩnh, hãy làm theo các đề xuất sau:
- Đặt tham số
return_error_codethànhtrue. Điều này khiến API tĩnh của Chế độ xem đường phố trả về lỗi 404 KHÔNG TÌM THẤY thay vì hình ảnh xám chung chung, nếu không có hình ảnh nào cho vị trí được chỉ định. - Yêu cầu siêu dữ liệu hình ảnh 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.