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 để hiển thị sản phẩm cho người dùng khi họ tìm kiếm các địa điểm yêu thích (POI) 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 tuỳ 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ả địa điểm yêu thích (POI) có liên quan 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 lựa chọn về sản phẩm là có liên quan nếu lựa chọn này 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 địa điểm yêu thích thông qua 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 là:

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

  • ADMISSION_TICKET: Mối quan hệ cho phép truy cập vào vị trí liên quan này.

  • supPLEMENTARY_ADDON: Relation khai báo một dịch vụ bổ sung không đưa người dùng vào 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 Tham quan Tháp Eiffel bằng cách đi bộ mà không cần vào bên trong. Chuyến tham quan bằng trực thăng quanh Burj Khalifa.
ADMISSION_TICKET Vé vào cổng sở thú, có thể bao gồm các tiện ích bổ sung.
SUPPLEMENTARY_ADDON Không cần nhập thông tin, không cần nhập thông tin hướng dẫn.
Không liên quan Chuyến du ngoạn bằng thuyền để nhìn thấy địa điểm yêu thích từ xa. Văn phòng du lịch nơi bắt đầu chuyến tham quan 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 tour cụ thể mà vị trí bắt đầu không rõ ràng và phải được xác định (ví dụ: các chuyến tham quan có hướng dẫn viên).

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

Nếu đ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 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 yêu thích đó vào Điểm tham quan.

Khi xử lý nguồn cấp dữ liệu đến, Google sẽ 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 các vị trí đó, còn gọi là Điểm yêu thích (POI).

Có thể xác định một địa điểm yêu thích (POI) một cách khái quát là một ghim có tên tại một vị trí cụ thể (tọa độ). 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 và điểm tham quan 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.

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

Có nhiều cách để gửi một vị trí liên quan đến Google, tuỳ thuộc vào nguồn dữ liệu vị trí, 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 đề 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 Cài đặt nâng cao của 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 địa điểm yêu thích, định dạng này cũng hỗ trợ các loại hình kinh doanh tại khu vực kinh doanh 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 các doanh nghiệp loại hình cơ sở dịch vụ hoặc doanh nghiệp kết hợp, đây là cách đượ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 địa điểm yêu thích.
  • 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 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ể 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 hơn so với việc so khớp địa chỉ với Mã địa điểm bằng API Địa điểm để Google có thể sử dụng thêm thông tin 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 thông tin này bằng các điểm cuối 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 sử dụng công cụ Tìm vị trí trùng khớp theo cách thủ công 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 Tự động hoàn thành địa điểm để cho phép chủ sở hữu dữ liệu chọn kết quả phù hợ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ỉ thô.
  • Đâ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 địa điểm yêu thích và bạn muốn so khớp địa chỉ với một địa điểm yêu thích ở phía bạn bằng cách sử dụng API Địa điểm, thay vì gửi thông tin địa điểm thô đến Google.
Vĩ độ và kinh độ Xác định một khu vực địa lý hoặc địa chính trị một cách khái quát, chẳng hạn như một 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 vị trí ước chừ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 để biểu thị một địa điểm yêu thích. Để gửi vị trí điểm yêu thích bằng toạ độ, hãy sử dụng định dạng Thông tin địa điểm.
Địa chỉ Biểu thị vị trí của một điểm yêu thích 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.

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òn được hỗ trợ nữa.
  • Tất cả các trường hợp sử dụng định dạng này sẽ cần di 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 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, hãy làm như sau:
    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 vào place_info/unstructured_address
    3. Xoá trường address hiện có khỏi nguồn cấp dữ liệu
    4. Chuyển đến bước 3
  2. Nếu dữ liệu địa chỉ của bạn 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 đến 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