Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Feed Lokasi Menarik (POI)

Halaman ini menjelaskan spesifikasi teknis untuk feed Lokasi Menarik (POI). Halaman ini mencakup ringkasan kolom wajib, definisi skema yang komprehensif, dan contoh JSON untuk memandu penerapan.

Spesifikasi Feed

Bagian ini menjelaskan persyaratan dan definisi untuk feed POI.

Persyaratan Kolom

Nama Kolom	Persyaratan	Deskripsi
poi_id	Wajib	String yang dibuat oleh partner yang mengidentifikasi lokasi menarik (properti).
nama	Wajib	Nama POI. Nama ini akan digunakan sebagai nama tampilan properti di Unit Agregator.
telepon	Opsional	Nomor telepon kontak POI termasuk kode negara dan area, misalnya +14567891234.
`url`	Opsional	URL situs publik POI. Catatan: URL ini hanya akan digunakan untuk tujuan pencocokan, bukan untuk ditampilkan.
lokasi	Wajib (Alamat) Opsional (Lintang/Bujur)	Lokasi POI. Wajib: Alamat dan kolom terkait akan diperlukan untuk mencocokkan properti dengan benar. Opsional: Lintang dan bujur. Jika disediakan, Google akan menggunakan lintang/bujur dalam tampilan pin properti di peta Unit Agregator Anda.
gambar	Sangat Direkomendasikan (Satu gambar) Opsional (Beberapa gambar)	Gambar POI. Gambar akan penting dalam tampilan properti. Sebaiknya tambahkan minimal 1 gambar. Anda dapat memberikan beberapa gambar hingga jumlah maksimum 5. Jika beberapa gambar diberikan, gambar tersebut akan digunakan sesuai urutan pemberiannya (jika gambar tidak dapat digunakan). Gambar akan ditinjau untuk memastikan gambar tersebut tidak melanggar kebijakan penelusuran aman Google.
rating	Opsional	Rating rata-rata untuk properti.
num_ratings	Opsional	Jumlah rating yang berkontribusi untuk kolom `rating`.
rating_scale	Opsional	Skala peringkat yang digunakan untuk kolom `rating`. Jika rating maksimum adalah 5, maka rating_scale adalah 5.
kategori	Opsional	Mewakili kategori properti.
hotel_data	Opsional	Kolom khusus hotel. Lihat Definisi HotelData untuk mengetahui detailnya.
hotel_star_class	Opsional	Nilai bintang kelas hotel resmi. Nilai ini diharapkan berupa bilangan bulat antara 1 dan 5.
brand_ids	Opsional	Merek yang dapat menampilkan hotel ini. Jika kolom ini kosong, hotel dapat ditampilkan di bawah merek mana pun yang terkait dengan feed.
deskripsi	Opsional	Deskripsi mendetail tentang properti.
display_address	Opsional	Alamat yang ditampilkan di UI.

Panduan Gambar

Semua gambar yang ditambahkan ke feed harus mengikuti panduan berikut:

Format: Harus JPEG, PNG, atau WebP.
Ukuran File Maksimum: Di bawah 30 MB per gambar.
Dimensi Maksimum: Kurang dari 75 Megapiksel total (lebar x tinggi < 75.000.000).
Jenis URL: Jalur langsung ke aset gambar (misalnya, diakhiri dengan .jpg).
Izin: Pastikan server hosting mengizinkan akses ke Googlebot atau Crawler dan tidak memiliki robots.txt yang memblokir direktori gambar.

Dukungan Multibahasa

Feed Lokasi Menarik mendukung penyediaan konten yang dilokalkan untuk kolom tertentu. Kolom berikut berjenis Text dan mendukung pelokalan:

name
description
display_address

Untuk menyediakan konten dalam beberapa bahasa, Anda harus menentukan default_locale di kolom dan memberikan string yang dilokalkan dalam daftar localizations. Berikan semua pelokalan untuk properti dalam satu entri POI. Jangan membagi satu properti di antara beberapa file JSON bahasa.

Contoh:

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

Panduan Pengemasan File

Untuk memastikan penyerapan berhasil, ikuti persyaratan pengemasan berikut:

Arsip JSON Gabungan Tunggal (Wajib): Gabungkan semua data properti ke dalam satu file JSON. Sebaiknya kompres file tersebut ke dalam satu arsip GZIP, lalu upload.
Peringatan Anti-Pola: Jangan gunakan satu file per properti atau beberapa file yang dipisahkan menurut negara dalam arsip yang sama. Pendekatan ini tidak didukung dan akan menyebabkan kegagalan ekstraksi.

Definisi

Definisi 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;
}

Definisi 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;
  }

}

Definisi Teks

// 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;
}

Definisi 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;

  }
}

Definisi 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;
}

Definisi Gambar

// 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;
}

Definisi 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 1 and 5.
  int32 hotel_star_class = 1;

  // 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];
}

Contoh