Tài liệu tham khảo nhanh về Places API (Cũ)

Kể từ tháng 10 năm 2026, bạn sẽ không thể bật Places API (Phiên bản cũ) cho các dự án trên đám mây mới trên Google Cloud nữa. Các dự án hiện tại vẫn được hỗ trợ đầy đủ. Để sử dụng các tính năng mới và cải thiện hiệu suất, hãy di chuyển sang Places API (Mới).

Places API (Cũ): thông tin chính

  • Sản phẩm: Places API (Phiên bản cũ)
  • Còn được gọi là: Places API (dịch vụ web cũ), dịch vụ web Places API (maps/api/place)
  • Danh mục: Địa điểm
  • Nền tảng: Dịch vụ web (REST)
  • Chạy trên: Máy chủ (mã phụ trợ)
  • Giai đoạn ra mắt: GA
  • Vòng đời: Cũ
  • Được thay thế bằng: Places API (Mới)
  • Tổng quan: Tổng quan về Places API (Phiên bản cũ)

Places API (Cũ): trường hợp sử dụng

Sử dụng Places API (Phiên bản cũ) khi:

  • Bạn duy trì một dự án hiện có đã bật Places API (Phiên bản cũ) và gọi các điểm cuối maps.googleapis.com/maps/api/place.
  • Bạn cần có các lệnh gọi hiện có cho tính năng Tìm địa điểm, Nearby Search, Tìm kiếm văn bản, Chi tiết, Ảnh hoặc Tự động hoàn thành (Phiên bản cũ) để tiếp tục hoạt động trong khi di chuyển.

Không sử dụng Places API (Cũ) khi:

  • Bạn đang bắt đầu một dự án trên đám mây mới trên Google Cloud. Kể từ tháng 10 năm 2026, bạn không thể bật Places API (Phiên bản cũ) cho các dự án mới. Hãy sử dụng Places API (Mới).
  • Bạn cần các tính năng mới, phương thức xác thực OAuth hoặc mặt nạ trường trên Nearby Search và Tìm kiếm văn bản để chỉ trả phí cho những trường mà bạn yêu cầu. Hãy sử dụng Places API (Mới).
  • Bạn cần có Find Place (Cũ) hoặc Query Autocomplete (Cũ) trong mã mới. Tính năng Tìm kiếm văn bản (Mới) và Tự động hoàn thành (Mới) sẽ thay thế các tính năng đó. Hãy sử dụng Places API (Mới).

Places API (Cũ): thiết lập

Places API (Cũ): các lỗi thường gặp

  • Vấn đề: Nếu yêu cầu Place Details (Cũ) bỏ qua tham số fields hoặc không chỉ định trường nào, thì API sẽ trả về tất cả các trường và tính phí cho tất cả các trường đó. Cách khắc phục: Luôn đặt tham số fields hoặc di chuyển sang Place Details (Mới) bằng mặt nạ trường. Xem /maps/documentation/places/web-service/legacy/details.
  • Vấn đề: Tính năng Nearby Search (Cũ) và Tìm kiếm văn bản (Cũ) không hỗ trợ việc chỉ định trường cần trả về. Các phương thức này luôn trả về một nhóm trường cố định (một nhóm nhỏ các trường Place Details) và kích hoạt các SKU Dữ liệu cơ bản, Dữ liệu liên hệ và Dữ liệu không khí. Cách khắc phục: Di chuyển sang Nearby Search (Mới) hoặc Tìm kiếm văn bản (Mới) bằng mặt nạ trường, hoặc sử dụng Tìm địa điểm (Cũ) với tham số fields để yêu cầu và chỉ thanh toán cho những trường bạn cần. Xem /maps/billing-and-pricing/sku-details/legacy#places_nearby-search-legacy-pro-sku.
  • Vấn đề: Không thể lưu photo_reference vào bộ nhớ đệm và có thể hết hạn, vì vậy, các tệp đối chiếu được lưu trữ sẽ ngừng hoạt động. Cách khắc phục: Lấy photo_reference mới từ phản hồi của Place Details, Tìm địa điểm, Nearby Search hoặc Tìm kiếm văn bản trước khi yêu cầu ảnh. Xem /maps/documentation/places/web-service/legacy/photos.
  • Vấn đề: Các lệnh gọi đến Places API (Phiên bản cũ) từ một dự án chưa bật API này sẽ trả về REQUEST_DENIED kèm theo thông báo lỗi "Bạn đang gọi một API cũ chưa được bật cho dự án của bạn..." (LegacyApiNotActivatedMapError). Kể từ tháng 10 năm 2026, bạn không thể bật Places API (Phiên bản cũ) cho các dự án mới. Cách khắc phục: Sử dụng Places API (Mới) cho các dự án mới và di chuyển các ứng dụng hiện có. Trong khi di chuyển, bạn có thể yêu cầu kích hoạt API cũ trong thời gian ngắn thông qua biểu mẫu phản hồi trên trang cũ. Hãy xem /maps/legacy#LegacyApiNotActivatedMapError.

Places API (Cũ): các tính năng cũ và không dùng nữa

  • Trường phản hồi permanently_closed: Không dùng nữa kể từ ngày 26 tháng 5 năm 2020. Thay thế: Trường business_status. Xem hướng dẫn di chuyển.
  • Trường phản hồi reference: Không dùng nữa kể từ ngày 3 tháng 9 năm 2019. Thay thế: Trường place_id. Xem hướng dẫn di chuyển.
  • Tham số yêu cầu của Nearby Search (Phiên bản cũ) name: Không dùng nữa. Thay thế: Tham số keyword. Xem hướng dẫn di chuyển.