Trang này được dịch bởi Cloud Translation API.

Siêu dữ liệu hình ảnh trong Chế độ xem đường phố

Giới thiệu

Các yêu cầu siêu dữ liệu của API Street View Static cung cấp dữ liệu về ảnh toàn cảnh Chế độ xem đường phố. Khi sử dụng siêu dữ liệu, bạn có thể tìm hiểu xem có hình ảnh Chế độ xem đường phố tại một vị trí nhất định hay không, cũng như có quyền truy cập theo phương thức lập trình vào toạ độ vĩ độ và kinh độ, mã nhận dạng ảnh toàn cảnh, ngày chụp ảnh và thông tin bản quyền của hình ảnh đó hay không. Việc truy cập vào siêu dữ liệu này cho phép bạn tuỳ chỉnh hành vi lỗi trong ứng dụng.

Bạn có thể sử dụng các yêu cầu siêu dữ liệu của API Street View Static mà không mất phí. Không có hạn mức nào được sử dụng khi bạn yêu cầu siêu dữ liệu. Hạn mức chỉ được sử dụng khi bạn tải hình ảnh bằng Street View Static API.

Khi bạn tạo yêu cầu siêu dữ liệu hình ảnh Chế độ xem đường phố, hình ảnh toàn cảnh sẽ có độ chính xác đến 50 mét.

Truy cập vào siêu dữ liệu hình ảnh

Yêu cầu siêu dữ liệu hình ảnh trong Chế độ xem đường phố là một URL HTTP có dạng như sau:

https://maps.googleapis.com/maps/api/streetview/metadata?parameters

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 tham số bắt buộc cho yêu cầu siêu dữ liệu

Các yêu cầu siêu dữ liệu chấp nhận các tham số URL giống nhau như các yêu cầu hình ảnh của API Chế độ xem đường phố tĩnh, mặc dù chỉ yêu cầu các tham số sau:

Hãy thực hiện một trong hai 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 độ được phân tách bằng dấu phẩy (40.457375,-80.009353).

hoặc:

pano – 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, bạn không nên 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:

key và signature – khoá API là bắt buộc để xác thực yêu cầu. Chữ ký số cũng là yêu cầu bắt buộc trong một số trường hợp và luôn được đề xuất. Để biết thêm thông tin, hãy xem bài viết Nhận khoá và chữ ký.

Yêu cầu siêu dữ liệu của bạn, chỉ có các tham số bắt buộc, sẽ có dạng như sau:

https://maps.googleapis.com/maps/api/streetview/metadata?location=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

hoặc như sau:

https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

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.

Tham số không bắt buộc cho các yêu cầu siêu dữ liệu

Bạn có thể đưa các thông số sau vào yêu cầu siêu dữ liệu: size, heading, fov và pitch. Xin lưu ý rằng các thông số này không ảnh hưởng đến dữ liệu về ảnh toàn cảnh hoặc ảnh toàn cảnh nào được tìm thấy. API cho phép đưa vào các tham số giống như yêu cầu hình ảnh để dễ dàng tạo yêu cầu siêu dữ liệu liên quan đến một yêu cầu hình ảnh cụ thể, nhưng đối với yêu cầu siêu dữ liệu, API sẽ bỏ qua các tham số không bắt buộc và giá trị của các tham số đó. Để biết thông tin về cách sử dụng các tham số này, hãy xem Hướng dẫn dành cho nhà phát triển về API Đường phố nhìn toàn cảnh tĩnh.

Định dạng phản hồi

Phản hồi siêu dữ liệu chỉ được trả về ở định dạng JSON.

Ví dụ

Ví dụ 1: Tìm thấy ảnh toàn cảnh

Các URL sau đây yêu cầu thành công siêu dữ liệu và hình ảnh của cùng một ảnh toàn cảnh.

Yêu cầu và phản hồi siêu dữ liệu

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

{
   "copyright" : "© 2017 Google",
   "date" : "2016-05",
   "location" : {
      "lat" : 48.85783227207914,
      "lng" : 2.295226175151347
   },
   "pano_id" : "tu510ie_z4ptBZYo2BGEJg",
   "status" : "OK"
}

Yêu cầu và phản hồi hình ảnh, trong đó hình ảnh bị thiếu.

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Ví dụ 2: Không tìm thấy ảnh toàn cảnh

Các URL sau đây yêu cầu siêu dữ liệu và hình ảnh của một ảnh toàn cảnh không tìm thấy tại hoặc gần vị trí đã chỉ định.

Yêu cầu và phản hồi siêu dữ liệu

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

{
   "status" : "ZERO_RESULTS"
}

Yêu cầu và phản hồi về hình ảnh

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Phần giữ chỗ cho thông báo "Không có hình ảnh nào ở đây"

Mã trạng thái

Trường status trong đối tượng phản hồi siêu dữ liệu chứa trạng thái của yêu cầu và có thể chứa thông tin gỡ lỗi để giúp bạn khắc phục sự cố khiến yêu cầu Chế độ xem đường phố không hoạt động. Trường status có thể chứa các giá trị sau:

Trạng thái	Mô tả
`"OK"`	Cho biết không có lỗi nào xảy ra; đã tìm thấy ảnh toàn cảnh và siêu dữ liệu được trả về.
`"ZERO_RESULTS"`	Cho biết không tìm thấy ảnh toàn cảnh nào ở gần vị trí được cung cấp. Phản hồi này có thể xảy ra nếu bạn cung cấp mã nhận dạng toàn cảnh không tồn tại hoặc không hợp lệ. Xem bài viết [Làm mới mã nhận dạng ảnh toàn cảnh đã xoá](#refresh-pano).
`"NOT_FOUND"`	Cho biết không tìm thấy chuỗi địa chỉ được cung cấp trong tham số `location`. Thông báo này có thể xuất hiện nếu bạn cung cấp một địa chỉ không tồn tại.
`"OVER_QUERY_LIMIT"`	Cho biết bạn đã vượt quá hạn mức hằng ngày hoặc hạn mức mỗi giây cho API này.
`"REQUEST_DENIED"`	Cho biết yêu cầu của bạn đã bị từ chối. Thông báo này có thể xuất hiện nếu bạn không uỷ quyền cho yêu cầu của mình hoặc nếu API Đường phố nhìn toàn cảnh tĩnh không được kích hoạt trong dự án Google Cloud Console chứa khoá API của bạn.
`"INVALID_REQUEST"`	Thông thường, lỗi này cho biết rằng bạn thiếu các tham số truy vấn (địa chỉ, toạ độ vĩ độ và kinh độ hoặc thành phần).
`"UNKNOWN_ERROR"`	Cho biết không thể xử lý yêu cầu do lỗi máy chủ. Vấn đề này thường là tạm thời. Yêu cầu có thể thành công nếu bạn thử lại.

Thông tin khác

Để biết thêm thông tin về cách sử dụng API Chế độ xem đường phố tĩnh hoặc các sản phẩm API Google Maps khác, hãy nhớ xem Trang hỗ trợ của API Maps.