Với API Trang doanh nghiệp, bạn có thể tạo một nền tảng để người bán quản lý doanh nghiệp của họ trên Google. Trên nền tảng của mình, bạn có thể cho phép các đối tác tìm kiếm trang thông tin khớp với tên, địa chỉ và số điện thoại của doanh nghiệp. Họ có thể xác lập quyền sở hữu một địa điểm, cũng như đặt chính xác vị trí thực tế của doanh nghiệp theo vĩ độ và kinh độ.
Trước khi bắt đầu
Trước khi sử dụng API Trang doanh nghiệp, bạn cần đăng ký ứng dụng và lấy thông tin xác thực OAuth 2.0. Để biết thông tin chi tiết về cách bắt đầu sử dụng API Trang doanh nghiệp, hãy xem phần Thiết lập cơ bản.
Cách xử lý dữ liệu địa chỉ
Để xử lý dữ liệu địa chỉ và vị trí địa lý trên nền tảng của mình, bạn có thể sử dụng hai nhóm API và tài nguyên khác nhau: API Trang doanh nghiệp và API Maps.
Tài nguyên thường dùng trên Trang doanh nghiệp
API GoogleLocations
cho phép người bán xem trước xem một vị trí đã được xác nhận quyền sở hữu trong Trang doanh nghiệp hay chưa. Nếu không, hệ thống sẽ cho phép người bán yêu cầu quyền truy cập ngay lập tức.
Đối tượng PostalAddress
đại diện cho địa chỉ thực tế của một doanh nghiệp.
Các tài nguyên thường dùng trên Google Maps
Tiện ích địa điểm JavaScript của Maps thường được dùng trong quy trình làm việc của đối tác để tạo bản đồ tương tác. Ngoài ra, các API Maps sau đây cũng hữu ích:
- Trả về thông tin dự đoán về địa điểm bằng tính năng Tự động hoàn thành địa điểm và Thông tin chi tiết về địa điểm. Để biết thông tin chi tiết về giá, hãy xem SKU: Tự động hoàn thành (bao gồm Thông tin chi tiết về địa điểm) – Theo phiên.
- Truy vấn thông tin về địa điểm bằng tính năng Tìm kiếm địa điểm. Để biết thông tin chi tiết về giá, hãy xem phần SKU: Tìm địa điểm.
- Cung cấp tính năng mã hoá địa lý và mã hoá địa lý ngược cho địa chỉ bằng tính năng Mã hoá địa lý. Để biết thông tin chi tiết về giá, hãy xem bài viết SKU: Mã hoá địa lý.
Một hoặc không có kết quả trùng khớp
Khi một đối tác tìm kiếm các trang thông tin phù hợp cho một vị trí, mục tiêu của họ là thu hẹp kết quả tìm kiếm xuống một hoặc không có kết quả phù hợp. Điều này có nghĩa là vị trí đó phù hợp với tiêu chí tìm kiếm của họ hoặc chưa tồn tại trong Trang doanh nghiệp.
Nếu có một hoặc không có kết quả trùng khớp, hãy sử dụng phương thức accounts.locations.create
để tạo trang thông tin mới hoặc làm theo hướng dẫn GoogleLocations
để xác nhận quyền sở hữu trang thông tin hiện có. Nếu Google không thể mã hoá địa lý địa chỉ, thì việc tạo vị trí sẽ không thành công và phản hồi API sẽ bao gồm một yêu cầu về dữ liệu LatLng
. Để biết thông tin về cách người bán có thể cung cấp dữ liệu LatLng
, hãy xem phần Điều chỉnh thủ công dữ liệu vị trí địa lý.
Sau khi xác định toạ độ LatLng
, trang thông tin mới sẽ được tạo.
Trùng khớp một phần và nhiều lần
Khi chủ doanh nghiệp hoặc nhóm vận hành của đối tác tìm kiếm trang thông tin khớp với một vị trí, thông tin mà họ nhập có thể chỉ khớp một phần hoặc họ có thể nhận được nhiều kết quả khớp với cụm từ tìm kiếm của mình. Để thu hẹp kết quả tìm kiếm xuống còn một hoặc không có kết quả trùng khớp, hai trường hợp sử dụng API Maps sẽ giải quyết kết quả trùng khớp một phần và nhiều kết quả trùng khớp theo cách thủ công.
Người dùng tinh chỉnh nội dung tìm kiếm
Khi người dùng của nền tảng đối tác tìm kiếm một vị trí và gặp phải nhiều kết quả trùng khớp một phần, họ có thể giải quyết vấn đề theo một trong những cách sau:
- Phân tích các địa chỉ trùng khớp một phần và chọn địa chỉ chính xác.
- Chỉnh sửa hoặc nhập lại một số phần của địa chỉ để chính xác hơn và thu hẹp kết quả xuống một hoặc không có kết quả phù hợp.

Người dùng chọn trong số một hoặc nhiều kết quả trùng khớp hoàn toàn
Trong một số trường hợp, nhiều vị trí có thể khớp hoàn toàn với địa chỉ tìm kiếm của người dùng. Ví dụ: người dùng có thể nhập địa chỉ sau vào nền tảng của đối tác:
Burung kolibri, Collmin Sq., GRN No. 1, Wonokromo, Jawa Timur 60983, Indonesia
Giả sử các phản hồi sau đây được trả về, tất cả đều khớp với địa chỉ được cung cấp:
- Kasperson Printer Center, một vị trí chưa được xác minh.
- Bengo Seguro, một vị trí đã xác minh.
- Garush Productions, một địa điểm chưa được xác minh.
Người dùng cần chọn doanh nghiệp phù hợp theo cách thủ công. Để đảm bảo người tiêu dùng được cung cấp đường đi chính xác đến doanh nghiệp, bạn có thể cần điều chỉnh dữ liệu vĩ độ và kinh độ (LatLng
) cho các vị trí này để tăng độ chính xác. Để biết thông tin về cách người dùng có thể nhập LatLng
theo cách thủ công, hãy xem phần Điều chỉnh dữ liệu vị trí địa lý theo cách thủ công.
Điều chỉnh dữ liệu vị trí địa lý theo cách thủ công
Doanh nghiệp có thể thêm toạ độ vĩ độ và kinh độ (LatLng
) của
doanh nghiệp để tăng độ chính xác của trang thông tin trên Trang doanh nghiệp. Các doanh nghiệp mới có thể không biết toạ độ LatLng
của mình. Do đó, họ có thể thả ghim theo cách thủ công bằng Tiện ích địa điểm JavaScript của Maps để thiết lập toạ độ LatLng
chính xác.

LatLng
, bạn cần điều chỉnh toạ độ của từng vị trí theo cách thủ công.Chất lượng của kết quả tìm kiếm
Kết quả tìm kiếm sẽ khác nhau tuỳ theo độ chính xác của địa chỉ được tìm kiếm và theo khu vực địa lý. Các khu vực đang phát triển thường hiển thị ít địa điểm trên Maps hơn và tuân thủ không nhất quán với định dạng địa chỉ của Google. Điều này dẫn đến kết quả tìm kiếm chất lượng thấp hơn và nhu cầu định dạng địa chỉ theo cách thủ công cũng như sử dụng API Maps ngày càng tăng.