Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Nguồn cấp dữ liệu Địa điểm yêu thích (POI)

Trang này trình bày chi tiết các thông số kỹ thuật cho nguồn cấp dữ liệu Địa điểm yêu thích (POI). Tài liệu này bao gồm thông tin tóm tắt về các trường bắt buộc, định nghĩa giản đồ toàn diện và một mẫu JSON để hướng dẫn triển khai.

Quy cách nguồn cấp dữ liệu

Phần này mô tả các yêu cầu và định nghĩa cho nguồn cấp dữ liệu địa điểm yêu thích.

Yêu cầu về trường

Tên trường	Yêu cầu	Mô tả
poi_id	Bắt buộc	Một chuỗi do đối tác tạo ra để xác định một địa điểm yêu thích (cơ sở lưu trú).
tên	Bắt buộc	Tên của địa điểm yêu thích. Tên này sẽ được dùng làm tên hiển thị của cơ sở lưu trú trong Đơn vị tổng hợp.
điện thoại	Sẽ hữu ích hơn rất nhiều nếu bạn	Số điện thoại liên hệ của địa điểm yêu thích, bao gồm cả mã quốc gia và mã vùng, ví dụ: +14567891234.
url	Sẽ hữu ích hơn rất nhiều nếu bạn	URL của trang web công khai của địa điểm yêu thích. Lưu ý: Thông tin này chỉ được dùng cho mục đích so khớp, không dùng để hiển thị.
vị trí	Bắt buộc (Địa chỉ) Nên có (Vĩ độ/Kinh độ)	Vị trí của địa điểm yêu thích. Bắt buộc: Bạn phải cung cấp địa chỉ và các trường đi kèm để so khớp chính xác với cơ sở lưu trú. Không bắt buộc: Vĩ độ và kinh độ. Nếu bạn cung cấp, Google sẽ sử dụng vĩ độ/kinh độ để hiển thị ghim cơ sở lưu trú trong bản đồ Đơn vị tổng hợp.
hình ảnh	Bắt buộc (Một hình ảnh) Nên có (Nhiều hình ảnh)	Hình ảnh về địa điểm yêu thích. Hình ảnh sẽ đóng vai trò quan trọng trong việc hiển thị cơ sở lưu trú. Bạn nên thêm ít nhất 1 hình ảnh. Bạn có thể cung cấp nhiều hình ảnh, tối đa là 5 hình ảnh. Khi bạn cung cấp nhiều hình ảnh, các hình ảnh đó sẽ được sử dụng theo thứ tự mà bạn cung cấp (trong trường hợp hình ảnh không sử dụng được). Hình ảnh sẽ được xem xét để đảm bảo không vi phạm chính sách tìm kiếm an toàn của Google.
rating	Đề xuất	Điểm xếp hạng trung bình của cơ sở lưu trú.
num_ratings	Đề xuất	Số lượt xếp hạng đóng góp cho trường `rating`.
rating_scale	Sẽ hữu ích hơn rất nhiều nếu bạn	Thang điểm xếp hạng dùng cho trường `rating`. Nếu điểm xếp hạng tối đa là 5, thì rating_scale là 5.
category	Sẽ hữu ích hơn rất nhiều nếu bạn	Đại diện cho danh mục của cơ sở lưu trú.
hotel_data	Sẽ hữu ích hơn rất nhiều nếu bạn	Các trường dành riêng cho khách sạn. Hãy xem phần Định nghĩa HotelData để biết thông tin chi tiết.
hotel_star_class	Đề xuất	Giá trị sao chính thức của hạng khách sạn. Giá trị này phải là một số nguyên từ 0 đến 5. Nếu hệ thống của bạn sử dụng giá trị nửa sao hoặc giá trị thập phân (ví dụ: `3.5`), hãy làm tròn xuống thành số nguyên (`3`). Vui lòng cung cấp giá trị 0 nếu không có, không xác định hoặc không chỉ định hạng sao. Khi bạn đặt thành 0, người dùng sẽ không thấy hạng sao của khách sạn trên giao diện người dùng.
brand_ids	Sẽ hữu ích hơn rất nhiều nếu bạn	Những thương hiệu có thể đăng khách sạn này. Nếu trường này trống, khách sạn có thể xuất hiện dưới bất kỳ thương hiệu nào được liên kết với nguồn cấp dữ liệu.
mô tả	Sẽ hữu ích hơn rất nhiều nếu bạn	Nội dung mô tả chi tiết về cơ sở lưu trú.
display_address	Sẽ hữu ích hơn rất nhiều nếu bạn	Địa chỉ hiển thị trên giao diện người dùng.

Nguyên tắc về hình ảnh

Tất cả hình ảnh được thêm vào nguồn cấp dữ liệu phải tuân thủ các nguyên tắc sau:

Định dạng: Phải là JPEG, PNG hoặc WebP.
Kích thước tệp tối đa: Dưới 30 MB mỗi hình ảnh.
Kích thước tối đa: Tổng kích thước dưới 75 Megapixel (chiều rộng x chiều cao < 75.000.000).
Loại URL: Đường dẫn trực tiếp đến thành phần hình ảnh (ví dụ: có đuôi .jpg).
Quyền: Đảm bảo máy chủ lưu trữ và tệp robots.txt cho phép các tác nhân người dùng Googlebot và Googlebot-Image truy cập, đồng thời không chặn các thư mục hình ảnh.

Hỗ trợ đa ngôn ngữ

Nguồn cấp dữ liệu Điểm yêu thích hỗ trợ việc cung cấp nội dung được bản địa hoá cho một số trường cụ thể. Các trường sau đây thuộc loại Text và hỗ trợ bản địa hoá:

name
description
display_address

Để cung cấp nội dung bằng nhiều ngôn ngữ, bạn phải chỉ định một default_locale trong trường và cung cấp các chuỗi đã bản địa hoá trong danh sách localizations. Cung cấp tất cả bản dịch cho một cơ sở lưu trú trong một mục địa điểm yêu thích duy nhất. Đừng chia một thuộc tính thành nhiều tệp JSON ngôn ngữ.

Ví dụ:

"name": {
  "localizations": [
    {
      "locale": "en",
      "text": "Banana Hotel"
    },
    {
      "locale": "es",
      "text": "Hotel Plátano"
    }
  ],
  "default_locale": "en"
}

Nguyên tắc đóng gói tệp

Để đảm bảo quá trình nhập thành công, hãy tuân thủ các yêu cầu sau về việc đóng gói:

Một tệp lưu trữ JSON tổng hợp (Bắt buộc): Kết hợp tất cả bản ghi tài sản vào một tệp JSON duy nhất. Bạn nên nén tệp đó thành một tệp lưu trữ GZIP duy nhất rồi tải lên.
Cảnh báo về mẫu phản thiết kế: Đừng sử dụng một tệp cho mỗi cơ sở lưu trú hoặc nhiều tệp được phân tách theo quốc gia trong cùng một tệp lưu trữ. Cách này không được hỗ trợ và sẽ khiến quá trình trích xuất không thành công.

Định nghĩa

Định nghĩa VssPoiFeed

// Represents a Point of Interest (POI) data feed provided by a partner.
export message VssPoiFeed {
  // The POIs in the feed.
  repeated VssPoi data = 1;
}

Định nghĩa VssPoi

// Represents a single Point of Interest (POI) entity e.g. a hotel or
// restaurant.
export message VssPoi {
  // Required. A string generated by the partner that identifies a POI.
  string poi_id = 1;

  // The entity name, telephone, url and location are used to support
  // matching partner inventory with entities already present on Google.

  // Required. The name of the POI.
  Text name = 2;

  // The contact telephone number of the POI including its country and
  // area codes, e.g. +14567891234.
  string telephone = 3 [(datapol.semantic_type) = ST_PHONE_NUMBER];

  // The url of the POI's public website.
  // Note: This will be used just for matching purposes, not for display.
  string url = 4;

  // Required. The location of the POI.
  GeoCoordinates location = 5;

  // The address displayed on the UI.
  Text display_address = 17;

  // Images of the POI.
  // Max number of images: 5.
  repeated Image images = 6;

  // Average rating for the POI.
  float rating = 12;

  // The number of contributing ratings for the `rating` field.
  int64 num_ratings = 13;

  // The rating scale used for the `rating` field. If max rating is 5, then
  // rating_scale is 5.
  int32 rating_scale = 14;

  // Represents the category of the POI.
  // It should match the `additional_data` oneof field below.
  export enum Category {

    UNKNOWN_CATEGORY = 0;
    HOTEL = 1;

    LOCAL = 4;
  }

  // Required. Represents the category of the POI.
  Category category = 9;

  // A description of the POI.
  Text description = 16;

  // Required. Category specific fields.
  // It should match the `category` field above.
  oneof additional_data {
    // Hotel specific fields.
    HotelData hotel_data = 10;


    // Local specific fields.
    LocalData local_data = 15;
  }

}

Định nghĩa văn bản

// Represents a text with localizations.
message Text {
  // Represents a localized string.
  message LocalizedString {
    // The text's language tag, such as "en", "en-US" or "sr-Latn".
    string locale = 1;

    // The text in the specified locale.
    string text = 2;
  }

  // The localized strings.
  repeated LocalizedString localizations = 1;

  // The locale to use as the default language it must be present in the
  // localizations.
  string default_locale = 2;
}

Định nghĩa về GeoCoordinates

// The Geo data of a location, including latitude, longitude, and address.
message GeoCoordinates {
  option (datapol.msg_semantic_type) = ST_LOCATION;

  // [-90, +90] degrees (inclusive).
  // Required if longitude is set, otherwise nice to have.
  double latitude = 1;

  // [-180, +180] degrees (inclusive).
  // Required if latitude is set, otherwise nice to have.
  double longitude = 2;

  // Required. Address for a location.
  oneof addresses {
    // Postal address of the location.
    PostalAddress address = 3;

  }
}

Định nghĩa PostalAddress

// The postal address for the location.
message PostalAddress {
  option (datapol.msg_semantic_type) = ST_LOCATION;

  // Required. The country, using ISO 3166-1 alpha-2 country code, e.g. "US".
  string country = 1;

  // Required. The locality/city, e.g. "Mountain View".
  string locality = 2;

  // The region/state/province, e.g. "CA". This field is only required in
  // countries where region is commonly a part of the address. (optional)
  string region = 3;

  // Required. The postal code, e.g. "94043".
  string postal_code = 4;

  // Required. The street address, e.g. "1600 Amphitheatre Pkwy".
  string street_address = 5;
}

Độ nét hình ảnh

// Represents an image of the Point of Interest (POI).
export message Image {
  // The url of the image. Google will crawl the media hosted at this URL.
  // Max length: 2000.
  string url = 1;

  // The alternative text to be used for accessibility.
  Text alt_text = 2;
}

Định nghĩa HotelData

// Hotel specific feed data.
message HotelData {
  // The official hotel class star value.
  // Can be used in a label like "5-star hotel."
  // This value is expected to be an integer between 0 and 5. A rating of 0
  // should be used if a rating is unavailable or not specified. When
  // set to 0, no star class will be displayed on the UI for users.
  int32 hotel_star_class = 1;

  // Deprecated. Use `brand_landing_pages` instead.
  //
  // The brands that can display this hotel.
  // If this field is empty, the hotel can be displayed under any of the
  // brands associated with the feed.
  repeated string brand_ids = 2
      [(datapol.semantic_type) = ST_PARTNER_ID, deprecated = true];

  // The brand landing pages.
  repeated BrandLandingPages brand_landing_pages = 3;
}

Mẫu