Vị trí và địa điểm yêu thích

Nguồn cấp dữ liệu sản phẩm cung cấp một số cách để bạn chỉ định các địa điểm yêu thích liên kết với sản phẩm. Google sử dụng thông tin này để giúp hiển thị sản phẩm cho người dùng khi họ đang tìm kiếm các địa điểm yêu thích hoặc điểm đến có liên quan.

Mỗi sản phẩm option có thể chỉ định một hoặc nhiều địa điểm yêu thích (POI) liên quan đến lựa chọn đó bằng cách sử dụng trường related_location (chứa danh sách đối tượng RelatedLocation). Mỗi đối tượng RelatedLocation chứa một location mô tả POI được đề cập và một relation_type mô tả mối quan hệ giữa POI và option của sản phẩm.

Bạn chỉ nên đánh dấu một lựa chọn sản phẩm là có liên quan nếu lựa chọn đó mang lại trải nghiệm có ý nghĩa về vị trí ngoài việc đi đến vị trí đó. Định nghĩa về "có ý nghĩa" có thể khác nhau tuỳ theo vị trí, nhưng những địa điểm thường không nên được đánh dấu là có liên quan bao gồm cảnh quan của địa điểm yêu thích trong chuyến đi thuyền hoặc chuyến tham quan bằng xe buýt hoặc điểm gặp gỡ cho chuyến tham quan (thay vào đó, hãy sử dụng trường meeting_point). Ba relation_types bao gồm:

  • MANAGE_NO_ADMISSION: Vị trí có liên quan nhưng lựa chọn về sản phẩm không bao gồm vé vào cửa hay vé vào cửa là không liên quan. Ví dụ: nếu vị trí là hình vuông được làm nổi bật trong chuyến tham quan thành phố.

  • ADMISSION_ Ticket: Relation cấp vé vào địa điểm liên quan này.

  • supPLEMENTARY_ADDON: Mối quan hệ khai báo một dịch vụ bổ sung không đưa người dùng vào vị trí liên quan. Ví dụ: vé đỗ xe, một buổi triển lãm tạm thời.

Ví dụ

relation_type Ví dụ:
RELATED_NO_ADMISSION Đi bộ tham quan quanh Tháp Eiffel mà không cần vào cửa. Chuyến tham quan bằng trực thăng quanh toà nhà Burj Khalifa.
ADMISSION_TICKET Vé vào Sở thú, có thể bao gồm các tiện ích bổ sung khác.
SUPPLEMENTARY_ADDON Không cần phân tuyến, không nhập hướng dẫn bằng âm thanh.
Không liên quan Chuyến đi thuyền nhìn thấy địa điểm yêu thích từ xa. Văn phòng tham quan nơi bắt đầu chuyến tham quan hoặc có thể mua vé.

Mỗi sản phẩm option cũng có thể có meeting_point cho các loại chuyến tham quan cụ thể, trong đó địa điểm xuất phát không rõ ràng và phải được xác định (ví dụ: chuyến tham quan có hướng dẫn viên).

Cách yêu cầu thêm một Điểm tham quan mới

Nếu bạn đang cung cấp vé chính thức cho các điểm tham quan và nhận thấy một trong những điểm tham quan bạn đang hợp tác bị thiếu trong Google Điểm tham quan, bạn có thể điền vào Biểu mẫu yêu cầu địa điểm yêu thích mới của TTD để yêu cầu thêm địa điểm đó vào chương trình Điểm tham quan.

Khi xử lý nguồn cấp dữ liệu đến, Google cố gắng so khớp gợi ý vị trí được cung cấp dưới dạng chuỗi văn bản với các thực thể nội bộ của Google đại diện cho những vị trí đó, được gọi là Địa điểm yêu thích (POI).

POI có thể được định nghĩa lỏng lẻo là một ghim được đặt tên trên một vị trí cụ thể (tọa độ). Trong bối cảnh của chương trình Điểm tham quan, các ví dụ liên quan bao gồm các công ty du lịch và điểm tham quan du lịch. Tuy nhiên, nhìn chung, POI có thể là bất kỳ cơ sở nào có tên và vị trí mà Google đã biết.

So khớp vị trí là quá trình so khớp một vị trí có liên quan, dưới dạng gợi ý bằng văn bản, với một địa điểm yêu thích mà Google đã biết, nếu vị trí đó có trong cơ sở dữ liệu của Google.

Có nhiều cách để gửi thông tin vị trí liên quan đến Google, tuỳ thuộc vào nguồn dữ liệu vị trí, các yêu cầu theo hợp đồng với nhà cung cấp và mức độ kiểm soát mà người dùng muốn có trong quá trình so khớp.

Các loại gợi ý sau được hỗ trợ (theo thứ tự ưu tiên):

Loại gợi ý

Loại Nội dung mô tả Đề xuất sử dụng
Mã trang doanh nghiệp Xác định duy nhất một doanh nghiệp trên Google.

Bạn chỉ có thể lấy thông tin này trực tiếp từ chủ doanh nghiệp bằng cách sử dụng trang cài đặt nâng cao của Trang doanh nghiệp, theo mô tả trong phần Cài đặt nâng cao của Trang doanh nghiệp.

Địa điểm yêu thích được liên kết với địa điểm yêu thích đại diện cho doanh nghiệp trên Google. Quá trình liên kết sẽ chỉ thành công nếu vị trí của doanh nghiệp đã được Google xác minh.

Ngoài địa điểm yêu thích, định dạng này cũng hỗ trợ các loại hình doanh nghiệp kết hợp và khu vực kinh doanh, như được xác định trong bài viết Cách sử dụng khu vực kinh doanh trên Google.
  • Đối tác có mối quan hệ kinh doanh trực tiếp với chủ doanh nghiệp.
  • Đối với các doanh nghiệp thuộc loại khu vực kinh doanh hoặc kết hợp, đây là cách ưu tiên để gửi các địa điểm như vậy.
Thông tin về địa điểm Nội dung biểu diễn có cấu trúc về một POI, cung cấp các trường riêng biệt cho tên địa điểm, thành phần địa chỉ và các gợi ý bổ sung như số điện thoại, trang web và toạ độ.

Đây là phương thức ưu tiên khi không thể lấy mã Trang doanh nghiệp từ chủ sở hữu POI.
  • Vị trí có nguồn từ nhà cung cấp hoặc chủ sở hữu dữ liệu ở một định dạng địa chỉ, ví dụ: thông qua một công cụ dành cho nhà cung cấp.
  • Địa điểm này không có địa chỉ chính xác, nhưng có thể được xác định theo tên và toạ độ, chẳng hạn như một điểm tham quan hoặc công ty du lịch nằm ở một khu vực xa xôi như sa mạc hoặc một con đường chưa đặt tên.
  • Khi có thể, hãy ưu tiên định dạng này thay vì so khớp địa chỉ với một mã địa điểm bằng Places API. Nhờ vậy, Google có thể dùng thông tin bổ sung như số điện thoại hoặc trang web nhằm cải thiện độ chính xác khi so khớp.
Mã địa điểm Xác định duy nhất một địa điểm yêu thích trên Google.

Bạn có thể lấy nguồn bằng các điểm cuối của API Địa điểm, ví dụ: Tìm kiếm địa điểm hoặc Tự động hoàn thành địa điểm, hoặc bằng công cụ Tìm vị trí trùng khớp trong Things to Do Center theo cách thủ công.
  • Thông tin vị trí có được từ nhà cung cấp hoặc chủ sở hữu dữ liệu thông qua một công cụ giao diện người dùng dành cho nhà cung cấp. Công cụ này có thể sử dụng tính năng Tự động hoàn thành theo địa điểm, chẳng hạn như để cho phép chủ sở hữu dữ liệu chọn kết quả trùng khớp chính xác trong danh sách các đề xuất có thể có.
  • Bạn muốn có nhiều quyền kiểm soát hơn đối với quá trình so khớp, hoặc không muốn chia sẻ thông tin địa chỉ chưa qua xử lý.
  • Đây là phương thức ưu tiên khi không thể lấy Mã Trang doanh nghiệp từ chủ sở hữu POI và bạn muốn so khớp địa chỉ với một POI ở phía bạn bằng Places API, thay vì gửi thông tin chưa qua xử lý về địa điểm cho Google.
Vĩ độ và kinh độ Xác định rộng rãi một khu vực địa lý hoặc địa chính trị, chẳng hạn như thành phố, địa phương hoặc điểm đến du lịch.
  • Hãy sử dụng định dạng này khi bạn muốn gửi một vị trí gần đúng không đại diện cho bất kỳ địa điểm yêu thích cụ thể nào. Ví dụ: khi bạn muốn liên kết một sản phẩm với một thành phố hoặc địa phương để sản phẩm có thể kích hoạt trong quảng cáo Điểm tham quan.
  • Định dạng này không phù hợp để trình bày địa điểm yêu thích. Để gửi các vị trí POI bằng toạ độ, hãy sử dụng định dạng Thông tin địa điểm.
Address (Địa chỉ) Đại diện cho vị trí POI dưới dạng địa chỉ một dòng không có cấu trúc, có thể bao gồm tên địa điểm nếu muốn.

Không dùng nữa.
Kể từ ngày 1 tháng 5 năm 2024, định dạng này sẽ không được hỗ trợ nữa.
  • Mọi hoạt động sử dụng định dạng này đều cần phải chuyển sang định dạng Thông tin về địa điểm mới. Định dạng này bao gồm một trường bắt buộc cho tên địa điểm và hỗ trợ cả định dạng địa chỉ có cấu trúc và không có cấu trúc.
  • Ngoài ra, bạn có thể di chuyển các gợi ý vị trí bị ảnh hưởng sang Mã Trang doanh nghiệp hoặc Mã địa điểm.

Ví dụ

// Example 1: Business Profile ID, copied from the Advanced settings page
// of the Google Business Profile that manages the POI.
"location": {
  "business_profile_id": 11458995034835395294
}

// Example 2: Place Info with structured address, coordinates, website URL,
// and phone number.
"location": {
  "place_info": {
    "name": "Colosseum",
    "phone_number": "+39 063 99 67 700",
    "website_url": "https://colosseo.it/",
    "coordinates": {
      "latitude": 41.8902102,
      "longitude": 12.4922309
    },
    "structured_address" {
      "street_address": "Piazza del Colosseo, 1",
      "locality": "Roma",
      "administrative_area": "RM",
      "postal_code": "00184",
      "country_code": "IT"
    }
  }
}

// Example 3: Place Info with unstructured address.
"location": {
  "place_info": {
    "name": "Eiffel Tower",
    "unstructured_address": "5 Av. Anatole France, 75007 Paris, France"
  }
}

// Example 4: Place Info using place name and coordinates only. This
// configuration is useful for matching POIs located in remote areas without
// an exact street address, such as POIs located in deserts or on unnamed
// roads.
"location": {
  "place_info": {
   "name": "Mutitjulu Waterhole",
   "coordinates": {
     "latitude": -25.3511774,
     "longitude": 131.0326859
    }
  }
}

// Example 5: Latitude and longitude.
// This format maintains the old behavior and will only match to the city or
// region.
// For more accurate matching using coordinates, use PlaceInfo instead,
// which includes a mandatory field for the place name.
"location": {
  "lat_lng": {
    "latitude": 51.5072178,
    "longitude": -0.1275862
  }
}

Cách di chuyển trường address sang trường place_info mới

Bạn có thể di chuyển trường address chưa có cấu trúc hiện có sang trường place_info mới bằng các bước sau:

  1. Nếu dữ liệu địa chỉ của bạn không có cấu trúc, thì:
    1. Thêm tên doanh nghiệp vào trường place_info/name
    2. Đặt địa chỉ mà không có tên doanh nghiệp trong place_info/unstructured_address
    3. Thả trường address hiện có khỏi nguồn cấp dữ liệu
    4. Chuyển tới bước 3
  2. Nếu dữ liệu địa chỉ bạn có có cấu trúc, thì:
    1. Thêm tên doanh nghiệp vào trường place_info/name
    2. Thêm thông tin địa chỉ như street_address, postal_address trong place_info/structured_address.
    3. Thả trường address hiện có khỏi nguồn cấp dữ liệu
    4. Chuyển tới bước 3
  3. Thêm dữ liệu bổ sung như website_urlphone_number để cải thiện độ chính xác khi so khớp