Điều kiện tiên quyết

Trước khi bạn có thể bắt đầu lập trình ứng dụng đầu tiên của mình, có một số những việc cần làm nếu bạn chưa thực hiện.

Tạo tài khoản Google

Bạn cần có một Tài khoản Google để tạo dự án trong Bảng điều khiển API của Google. Nếu đã có tài khoản thì bạn đã hoàn tất.

Bạn cũng nên có một Tài khoản Google riêng để thử nghiệm.

Dùng thử Chế độ xem đường phố của Google

Tài liệu về API này giả định rằng bạn đã sử dụng Chế độ xem đường phố của Google và bạn làm quen với các khái niệm lập trình web cũng như định dạng dữ liệu web.

Nếu bạn chưa sử dụng Chế độ xem đường phố của Google, thì hãy thử giao diện người dùng trước khi bắt đầu viết mã.

Tạo một dự án cho ứng dụng của bạn

Trước khi có thể gửi yêu cầu đến Chế độ xem đường phố của Google, bạn cần cho Google biết về ứng dụng của mình và kích hoạt quyền truy cập vào API. Bạn có thể thực hiện việc này bằng cách sử dụng Bảng điều khiển API của Google để tạo dự án. Đây là tập hợp các chế độ cài đặt và thông tin về quyền truy cập vào API được đặt tên, đồng thời đăng ký ứng dụng của bạn.

Để bắt đầu sử dụng API xuất bản Chế độ xem phố của Google, trước tiên, bạn cần sử dụng công cụ thiết lập. Công cụ này sẽ hướng dẫn bạn tạo dự án trong Google API Console, bật API và tạo thông tin đăng nhập.

Nếu bạn chưa làm như vậy, hãy tạo khoá API cho ứng dụng của mình bằng cách nhấp vào Tạo thông tin xác thực > Khoá API. Tiếp theo, hãy tìm khoá API của bạn trong API khoá.

Tìm hiểu kiến thức cơ bản về REST

Có 2 cách để gọi API:

Nếu quyết định không sử dụng thư viện ứng dụng, bạn cần nắm được kiến thức cơ bản về REST.

REST là một kiểu kiến trúc phần mềm mang lại cách tiếp cận thuận tiện và nhất quán để yêu cầu và sửa đổi dữ liệu.

Thuật ngữ REST là viết tắt của "Đại diện chuyển trạng thái". Trong ngữ cảnh của API Google, nó đề cập đến việc sử dụng các động từ HTTP để truy xuất và sửa đổi bản trình bày dữ liệu do Google lưu trữ.

Trong hệ thống RESTful, các tài nguyên được lưu trữ trong một kho dữ liệu; ứng dụng gửi yêu cầu mà máy chủ thực hiện một hành động cụ thể (chẳng hạn như tạo, truy xuất, cập nhật hoặc xoá tài nguyên), sau đó máy chủ thực hiện hành động đó và gửi phản hồi, thường ở dạng biểu diễn tài nguyên được chỉ định.

Trong API RESTful của Google, ứng dụng chỉ định một hành động bằng cách sử dụng động từ HTTP như POST, GET, PUT hoặc DELETE. Phương thức này chỉ định tài nguyên bằng một URI duy nhất trên toàn hệ thống có dạng sau:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

Vì mọi tài nguyên API đều có URI riêng biệt có thể truy cập HTTP, nên REST cho phép lưu dữ liệu vào bộ nhớ đệm và được tối ưu hoá để hoạt động với cơ sở hạ tầng phân phối của web.

Bạn có thể thấy định nghĩa về phương thức trong tài liệu về các tiêu chuẩn HTTP 1.1 hữu ích; chúng bao gồm thông số kỹ thuật cho GET, POST, PUT và DELETE.

REST trong API xuất bản của Chế độ xem đường phố của Google

Các hoạt động của API Xuất bản của Chế độ xem đường phố của Google liên kết trực tiếp các động từ HTTP REST.

Các định dạng cụ thể cho URI API Xuất bản của Chế độ xem đường phố của Google là:

https://www.googleapis.com/streetviewpublish/v1/resourcePath?parameters

Bạn có thể thấy tóm tắt về toàn bộ URI dùng cho từng thao tác được hỗ trợ trong API trong tài liệu Tài liệu tham khảo về API xuất bản lên Chế độ xem đường phố của Google.

Tìm hiểu kiến thức cơ bản về JSON

API xuất bản Chế độ xem đường phố của Google trả về dữ liệu ở định dạng JSON.

JSON (Ký hiệu đối tượng JavaScript) là một định dạng dữ liệu phổ biến, không phụ thuộc vào ngôn ngữ, cung cấp bản trình bày văn bản đơn giản của các cấu trúc dữ liệu tùy ý. Để biết thêm thông tin, hãy xem json.org.