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 đối tác tìm kiếm những trang thông tin khớp với tên, địa chỉ và dữ liệu điện thoại của doanh nghiệp họ. Họ có thể xác lập quyền sở hữu một địa điểm, cũng như xác định 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 của mình 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 bộ 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 về Trang doanh nghiệp
GoogleLocations API cho phép người bán biết trước liệu 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, người bán có thể 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 rất hữu ích:
- Trả về cụm từ gợi ý về địa điểm bằng tính năng Tự động hoàn thành địa điểm và Chi tiết địa điểm. Để biết thông tin chi tiết về giá, hãy xem SKU: Tự động hoàn thành (đi kèm với Chi tiết địa điểm) – Mỗi 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 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 Mã hoá địa lý. Để biết thông tin chi tiết về giá, hãy xem SKU: Mã hoá địa lý.
Một hoặc không có kết quả trùng khớp
Khi tìm kiếm trang thông tin phù hợp cho một vị trí, đối tác muốn thu hẹp kết quả tìm kiếm xuống còn một hoặc không có kết quả phù hợp nào. Đ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 có 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 của API sẽ bao gồm 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 bài viết Điều chỉnh dữ liệu vị trí địa lý theo cách thủ công.
Sau khi xác định được toạ độ LatLng, trang thông tin mới sẽ được tạo.
Kết quả khớp một phần và nhiều kết quả khớp
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 phù hợp với một vị trí, thông tin 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 thủ công các kết quả trùng khớp một phần và nhiều kết quả trùng khớp.
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ỉ 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 các phần của địa chỉ để chính xác hơn và thu hẹp kết quả thành một hoặc không có kết quả trùng khớ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 địa điểm 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ử hệ thống trả về các phản hồi sau, tất cả đều khớp với địa chỉ đã cho:
- Kasperson Printer Center, một địa điểm chưa được xác minh.
- Bengo Seguro, một địa điểm đã 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 thông tin đường đi chính xác đến doanh nghiệp, bạn có thể cần phải điều chỉnh dữ liệu về vĩ độ và kinh độ (LatLng) của những 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 bài viết Đ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 cho trang thông tin của họ 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, nên 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
toạ độ của địa chỉ đó, 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 khác nhau rất nhiều tuỳ thuộc vào độ 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 có ít địa điểm trên Maps hơn và không tuân thủ nhất quán định dạng địa chỉ của Google. Điều này dẫn đến kết quả tìm kiếm có 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 tăng lên.