Yêu cầu về hình ảnh trong Chế độ xem đường phố là một URL loại HTTP có định dạng như 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ả tham số đều được phân tách bằng ký tự dấu và (&). Các tham số được phép và giá trị có thể có của các tham số đó được liệt kê dưới đây.
Tham 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 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ể sử dụng một vị trí camera khác để hiển thị vị trí được chỉ định một cách 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 bứ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à ảnh có thể được chụp từ các vị trí hơi khác nhau mỗi lần, nênlocationcủa bạn có thể chuyển sang một ảnh toàn cảnh khác khi hình ảnh được cập nhật.
hoặc:
panolà 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 toạ độ vĩ độ và kinh độ để 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ư:
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 rộng 600 pixel và 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 phần 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ị, 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 đã sử dụng để lấy mã nhận dạng ảnh toàn cảnh để 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 toạ độ vĩ độ và kinh độ để tì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à chữ ký số dùng để xác minh rằng mọi trang web tạo yêu cầu tạo 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 có chữ ký số có thể không thành công. Để biết thêm thông tin, hãy xem phần Lấy khoá và chữ ký.Lưu ý: đối với khách hàng cũ của Gói cao cấp của Google Maps Platform, bạn bắt buộc phải có chữ ký số. Tìm hiểu thêm thông tin về tham số xác thực cho khách hàng sử dụng Gói cao cấp.
headingcho biết hướng la bàn của camera. Giá trị được chấp nhận là từ0đến360(cả hai giá trị đều cho biết hướng Bắc, trong đó90cho biết hướng Đông và180cho biết hướng Nam). Nếu bạn không chỉ định hướng, thì một giá trị sẽ được tính toán để 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 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 trong Chế độ xem đường phố có kích thước cố định, trường nhìn về cơ bản thể hiện mức thu phóng, trong đó 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 camera so với xe Chế độ xem đường phố. Đường này thường nằm ngang, nhưng không phải lúc nào cũng vậy. Giá trị dương hướng camera lên trên (với90độ cho biết hướng thẳng lên trên); giá trị âm hướng camera 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 (tính bằng mét) để tìm ảnh toàn cảnh, lấy vĩ độ và kinh độ đã cho làm tâm. Giá trị hợp lệ là số nguyên không âm.return_error_codecho biết liệu API có nên trả về mã lỗi khi không tìm thấy hình ảnh (404 Không tìm thấy) hay không, hoặc để 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 bạn đặt thànhtrue, thì thông báo lỗi sẽ được trả về thay cho hình ảnh màu xám chung. Điều này giúp bạn không cần phải thực hiện một lệnh gọi riêng để kiểm tra xem có hình ảnh hay không.source(mặc định làdefault) giới hạn nội dung tìm kiếm trong Chế độ xem đường phố ở các nguồn đã chọn. Các giá trị hợp lệ là:defaultsử dụng các nguồn mặc định cho Chế độ xem đường phố; các lượt tìm kiếm không bị giới hạn ở các nguồn cụ thể.outdoorgiới hạn phạm vi tìm kiếm trong các bộ sưu tập ngoài trời. Bộ sưu tập trong nhà không có trong kết quả tìm kiếm. Xin 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. Cũng xin lưu ý rằng kết quả tìm kiếm chỉ trả về ảnh toàn cảnh mà bạn có thể xác định xem ảnh đó là trong nhà hay ngoài trời. Ví dụ: PhotoSpheres không được trả về vì không xác định được chúng ở 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 trong Chế độ xem đường phố, API tĩnh của 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 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 hợp lệ của API tĩnh Chế độ xem đường phố, 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 màu xám 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 trong Chế độ xem đường phố để xác định xem có hình ảnh cho vị trí được chỉ định hay không trước khi gửi yêu cầu.