[Giới thiệu] Google Place API - Phần 2

Tình hình là ngâm bài này lâu quá rồi, sắp đến ngày bảo vệ khóa luận nên tiếp tục viết nốt cho xong :D

7. Place check-ins

Chức năng này giúp xác nhận người dùng đã đến địa điểm đó. Hoạt động check-ins có ảnh hưởng tới kết quả tìm kiếm của người dùng trong ứng dụng của bạn.

Chú ý: Chức năng Check-ins ở đây không giống với khái niệm check-ins trong bộ API của Google Maps/Lattitude.

Place Check-ins request: Là một HTTP POST request.

POST https://maps.googleapis.com/maps/api/place/check-in/json?sensor=true_or_false&key=AddYourOwnKeyHere HTTP/1.1
Host: maps.googleapis.com

{
  "reference": "place_reference"
}

Place Check-ins response:

{
  "status": "OK"
}

  • OK : Check-in thành công
  • UNKNOWN_ERROR: Lỗi trên server. Thử lại có thể thành công.
  • OVER_QUERY_LIMIT: Quá giới hạn được cấp.
  • REQUEST_DENIED: Request bị từ chối, thông thường có thể do bị thiếu sensor parameter.
  • INVALID_REQUEST: Request không đúng.

8. User place reports

Cho phép user có thể thêm mới hay xóa địa điểm đã tồn tại. Địa điểm mới thêm có thể tìm ngay được từ ứng dụng của bạn và sẽ được đưa vào danh sách chờ kiểm duyệt trên Google Maps trước khi các ứng dụng khác có thể truy cập.

Place report requests:

- Thêm địa điểm:

POST https://maps.googleapis.com/maps/api/place/add/json?sensor=true_or_false&key=AddYourOwnKeyHere HTTP/1.1
Host: maps.googleapis.com

{
  "location": {
    "lat": -33.8669710,
    "lng": 151.1958750
  },
  "accuracy": 50,
  "name": "Google Shoes!",
  "types": ["shoe_store"],
  "language": "en-AU"
}

Kết quả trả về khi thêm thành công là reference và id:

{
  "status": "OK",
  "reference": "CiQgAAAAeTQS1RtzAyVRVjHcRiIWmWeqcAl3k7bluW7GINLDULESEHozTQhy6OHJw03ziDvY1uEaFAP_vDRhK-UbWw3Gd7Ulqm3eRjIs",
  "id": "6947fc4007436a71dbda51ef9a58627c8e8858f9"
}

- Xóa địa điểm

Một địa điểm chỉ có thể được xóa khi:

  • Được xóa bởi chính ứng dụng đã thêm vào.
  • Chưa vượt qua phần kiểm duyệt trên Google Maps.

Nếu không đáp ứng 2 yêu cầu này kết quả trả về mã lỗi: REQUEST_DENIED

POST https://maps.googleapis.com/maps/api/place/delete/json?sensor=true_or_false&key=AddYourOwnKeyHere HTTP/1.1
Host: maps.googleapis.com

{
  "reference": "place_reference"
}