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à dữ liệu điện thoại của doanh nghiệp họ. Chúng có thể thiết lập quyền sở hữu một vị trí, cũng như xác định chính xác địa điểm 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 bài viết Thiết lập cơ bản.
Cách làm việc với dữ liệu địa chỉ
Để làm việc với 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 2 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
API GoogleLocations
cho phép người bán xem 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, việc này cho phép người bán yêu cầu quyền truy cập ngay lập tức vào dữ liệu đó.
Đối tượng PostalAddress
đại diện cho địa chỉ thực tế của một doanh nghiệp.
Tài nguyên thường dùng trên Google Maps
Tiện ích JavaScript địa điểm của Maps thường được sử 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ề các 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 phần SKU: Tự động hoàn thành (kèm theo thông tin chi tiết về địa điểm) – Theo từng phiên hoạt động.
- Truy vấn thông tin về địa điểm bằng Tìm kiếm địa điểm. Để biết chi tiết về giá, hãy xem bài viết SKU: Tìm địa điểm.
- Cung cấp mã hoá địa lý và mã hoá địa lý ngược của địa chỉ bằ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ả phù hợp
Khi một đối tác tìm kiếm 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 còn một hoặc không kết quả phù hợp. Tức là vị trí tương ứng phù hợp với tiêu chí tìm kiếm hoặc chưa tồn tại trong Trang doanh nghiệp.
Khi có một hoặc không có kết quả phù hợ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ì quá trình 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ả trùng khớp một phần và nhiều kết quả
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ỉ cho kết quả 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 0 kết quả, kết quả khớp một phần và nhiều kết quả sẽ được giải quyết theo cách thủ công qua 2 trường hợp sử dụng API Maps.
Người dùng tinh chỉnh nội dung tìm kiếm
Khi người dùng trên nền tảng đối tác tìm kiếm một vị trí và gặp nhiều kết quả trùng khớp một phần, họ có thể giải quyết vấn đề này theo một trong các cách sau:
- Phân tích địa chỉ khớp một phần và chọn địa chỉ đúng.
- Chỉnh sửa hoặc nhập lại các phần của địa chỉ cho chính xác hơn và thu hẹp kết quả xuống còn một hoặc không khớp.
Người dùng chọn trong số một hoặc nhiều kết quả trùng khớp toàn bộ
Trong một số trường hợp, nhiều vị trí có thể hoàn toàn khớp 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 đố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ỉ đã cho:
- Trung tâm máy in Kasperson, vị trí chưa được xác minh.
- Bengo Seguro, một địa điểm đã được xác minh.
- Garush Productions, một địa điểm chưa được xác minh.
Người dùng cần tự chọn doanh nghiệp phù hợp. Để đảm bảo người tiêu dùng được cung cấp thông tin chỉ đường chính xác đến doanh nghiệp, chúng tôi có thể cần điều chỉnh dữ liệu vĩ độ và kinh độ (LatLng
) của những vị trí này để cung cấp độ chính xác cao hơn. Để 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 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, vì vậy, họ có thể thả ghim theo cách thủ công bằng Tiện ích Maps JavaScript Places để thiết lập toạ độ LatLng
chính xác.
Chất lượng của kết quả tìm kiếm
Kết quả tìm kiếm rất khác nhau dựa trên độ 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 cho thấy ít địa điểm trên Maps hơn và không tuân thủ các đị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ỉ thủ công và sử dụng API Maps tăng lên.