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 quan đến 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ọ tìm kiếm các địa điểm 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 các đố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à sản phẩm option.

Bạn chỉ nên đánh dấu một lựa chọn về 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 đối với các vị trí khác nhau, 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 một đị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 này là:

  • RELATED_NO_ADMISSION: Vị trí có liên quan nhưng lựa chọn về sản phẩm không có vé vào cổng hoặc vé vào cổng không liên quan. Ví dụ: nếu vị trí là một quảng trường được đánh dấu trong một chuyến tham quan thành phố.

  • ADMISSION_TICKET: Mối quan hệ cho phép vào địa điểm liên quan này.

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

Ví dụ

relation_type Ví dụ:
RELATED_NO_ADMISSION Chuyến tham quan đi bộ quanh Tháp Eiffel mà không cần vé vào cửa. Chuyến tham quan bằng trực thăng quanh Burj Khalifa.
ADMISSION_TICKET Vé vào cửa sở thú, có thể bao gồm các tiện ích bổ sung khác.
SUPPLEMENTARY_ADDON Vé không cần xếp hàng, vé không cần xếp hàng kèm máy thuyết minh.
Không liên quan Chuyến du ngoạn bằng thuyền để ngắm nhìn địa điểm yêu thích từ xa. Văn phòng du lịch nơi chuyến tham quan bắt đầu hoặc nơi bạn có thể mua vé.

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

Cách yêu cầu thêm Đ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 các điểm tham quan mà bạn đang hợp tác bị thiếu trong phần Điểm tham quan của Google, bạn có thể điền vào Biểu mẫu yêu cầu thêm địa điểm yêu thích mới trong phần Điểm tham quan để yêu cầu thêm địa điểm yêu thích đó vào phần Điểm tham quan.

Khi xử lý một nguồn cấp dữ liệu đến, Google sẽ cố gắng so khớp các gợi ý về 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òn được gọi là Điểm đến ưa thích (POI).

POI có thể được định nghĩa một cách chung chung là một ghim có tên trên một vị trí cụ thể (toạ độ). Trong bối cảnh Điểm tham quan, các ví dụ liên quan bao gồm nhà điều hành tour du lịch và điểm du lịch; tuy nhiên, nói chung, một POI có thể là bất kỳ cơ sở nào có tên và vị trí mà Google biết đến.

So khớp vị trí là quy 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 có trong cơ sở dữ liệu của Google.

Có nhiều cách để gửi 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ó đối với quy trình so khớp.

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

Loại gợi ý

Loại Mô tả Cách sử dụng được đề xuất
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 mã này trực tiếp từ chủ doanh nghiệp thông qua trang cài đặt nâng cao của Trang doanh nghiệp, như mô tả trong phần Chế độ cài đặt nâng cao cho trang doanh nghiệp.

Được liên kết với địa điểm yêu thích đại diện cho doanh nghiệp trên Google. Việc 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 các đị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 phục vụ tận nơi và doanh nghiệp kết hợp, được xác định trong 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 doanh nghiệp thuộc loại hình doanh nghiệp phục vụ tận nơi hoặc doanh nghiệp kết hợp, đây là cách thức ưu tiên để gửi những vị trí như vậy.
Thông tin về địa điểm Biểu thị có cấu trúc của một địa điểm yêu thích, 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 pháp ưu tiên khi không thể lấy mã Trang doanh nghiệp từ chủ sở hữu POI.
  • Vị trí được lấy từ nhà cung cấp hoặc chủ sở hữu dữ liệu ở định dạng địa chỉ, chẳng hạn như sử dụng một công cụ dành cho nhà cung cấp.
  • Vị trí này không có địa chỉ chính xác, nhưng có thể được xác định bằng 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 hẻo lánh như sa mạc hoặc đường không tên.
  • Nếu có thể, hãy ưu tiên định dạng này hơn là so khớp địa chỉ với một mã địa điểm bằng Places API để Google có thể sử dụng thêm thông tin như số điện thoại hoặc trang web để cải thiện độ chính xác của kết quả 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 mã này bằng cách sử dụng điểm cuối của Places API, chẳng hạn như Tìm kiếm địa điểm hoặc Place Autocomplete, hoặc lấy theo cách thủ công bằng công cụ Tìm vị trí trùng khớp trong Trung tâm Điểm tham quan.
  • Vị trí được lấy 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. Ví dụ: công cụ này có thể sử dụng tính năng Place Autocomplete để 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 kết quả có thể.
  • Bạn muốn có nhiều quyền kiểm soát hơn đối với quy trình so khớp hoặc không muốn chia sẻ thông tin địa chỉ thô.
  • Đâ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 thô về địa điểm cho Google.
Vĩ độ và kinh độ Xác định một cách chung chung 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 thông tin vị trí ước chừng mà không đại diện cho bất kỳ POI 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 để biểu thị một địa điểm yêu thích. Để gửi vị trí của địa điểm yêu thích bằng toạ độ, hãy sử dụng định dạng Thông tin về địa điểm.
Địa chỉ Biểu thị vị trí của một địa điểm yêu thích dưới dạng địa chỉ một dòng không có cấu trúc, bạn có thể thêm tên địa điểm (không bắt buộc).

Không dùng nữa.
Kể từ ngày 1 tháng 5 năm 2024, chúng tôi sẽ không còn hỗ trợ định dạng này nữa.
  • Tất cả các trường hợp sử dụng định dạng này đều cần di chuyển sang định dạng Thông tin về địa điểm mới, trong đó có 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ề địa điểm 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 không có cấu trúc hiện có sang trường place_info mới theo các bước sau:

  1. Nếu dữ liệu địa chỉ bạn có là dữ liệu 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ỉ không có tên doanh nghiệp trong place_info/unstructured_address
    3. Xoá trường address hiện có khỏi nguồn cấp dữ liệu
    4. Chuyển sang 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 vào place_info/structured_address.
    3. Xoá trường address hiện có khỏi nguồn cấp dữ liệu
    4. Chuyển sang bước 3
  3. Thêm dữ liệu bổ sung như website_urlphone_number để cải thiện độ chính xác của kết quả trùng khớp