หน้านี้จะแสดงรายละเอียดข้อกำหนดทางเทคนิคสำหรับฟีดจุดที่น่าสนใจ (POI) โดยจะมีข้อมูลสรุปของฟิลด์ที่ต้องกรอก คำจำกัดความของสคีมาที่ครอบคลุม และตัวอย่าง JSON เพื่อเป็นแนวทางในการติดตั้งใช้งาน
ข้อกำหนดฟีด
ข้อกำหนดของฟิลด์
| ชื่อช่อง | ข้อกำหนด | คำอธิบาย |
|---|---|---|
| poi_id | ต้องระบุ | สตริงที่พาร์ทเนอร์สร้างขึ้นซึ่งระบุจุดที่น่าสนใจ (ที่พัก) |
| ชื่อ | ต้องระบุ | ชื่อของจุดที่น่าสนใจ ระบบจะใช้ชื่อนี้เป็นชื่อที่แสดงของที่พักในหน่วยเครื่องมือรวบรวม |
| โทรศัพท์ | สิ่งที่แนะนำให้มี | หมายเลขโทรศัพท์ติดต่อของจุดที่น่าสนใจ รวมถึงรหัสประเทศและรหัสพื้นที่ เช่น +14567891234 |
| URL | สิ่งที่แนะนำให้มี | URL ของเว็บไซต์สาธารณะของจุดที่น่าสนใจ หมายเหตุ: ระบบจะใช้ข้อมูลนี้เพื่อวัตถุประสงค์ในการจับคู่เท่านั้น ไม่ใช่เพื่อการแสดงผล |
| สถานที่ | ต้องระบุ (ที่อยู่) มีไว้ก็ดี (ละติจูด/ลองจิจูด) |
สถานที่ตั้งของจุดที่น่าสนใจ ต้องระบุ: ต้องระบุที่อยู่และช่องที่เกี่ยวข้องเพื่อให้จับคู่ที่พักได้อย่างถูกต้อง มีไว้ก็ดี: ละติจูดและลองจิจูด หากระบุไว้ Google จะใช้ละติจูด/ลองจิจูดในการแสดงหมุดที่พักในแผนที่หน่วยรวบรวมข้อมูล |
| รูปภาพ | แนะนำอย่างยิ่ง (1 รูปภาพ) มีไว้ก็ดี (หลายรูปภาพ) |
รูปภาพของจุดที่น่าสนใจ รูปภาพจะเป็นสิ่งสำคัญในการแสดงที่พัก เราขอแนะนําให้เพิ่มรูปภาพอย่างน้อย 1 รูป คุณระบุรูปภาพได้หลายรูป โดยระบุได้สูงสุด 5 รูป เมื่อระบุหลายรายการ ระบบจะใช้ตามลำดับที่ระบุ (ในกรณีที่ใช้รูปภาพไม่ได้) รูปภาพจะได้รับการตรวจสอบเพื่อให้แน่ใจว่าไม่ละเมิดนโยบายการค้นหาอย่างปลอดภัยของ Google |
| คะแนน | สิ่งที่แนะนำให้มี | คะแนนเฉลี่ยของที่พัก |
| num_ratings | สิ่งที่แนะนำให้มี | จำนวนการให้คะแนนที่ส่งเข้ามาสำหรับฟิลด์ rating |
| rating_scale | สิ่งที่แนะนำให้มี | สเกลการให้คะแนนที่ใช้สำหรับฟิลด์ rating หากการให้คะแนนสูงสุดคือ 5 แสดงว่า rating_scale คือ 5 |
| category | สิ่งที่แนะนำให้มี | แสดงหมวดหมู่ของที่พัก |
| hotel_data | สิ่งที่แนะนำให้มี | ฟิลด์เฉพาะโรงแรม ตอนนี้ฟิลด์นี้ว่างเปล่า แต่จะพัฒนาไปพร้อมกับที่พักหาก/เมื่อมีข้อมูลเพิ่มเติมที่จำเป็น |
| คำอธิบาย | สิ่งที่แนะนำให้มี | คำอธิบายที่พักโดยละเอียด |
| display_address | สิ่งที่แนะนำให้มี | ที่อยู่ที่แสดงใน UI |
การสนับสนุนหลายภาษา
ฟีดจุดที่น่าสนใจรองรับการระบุเนื้อหาที่แปลแล้วสำหรับฟิลด์ที่เฉพาะเจาะจง
ฟิลด์ต่อไปนี้เป็นประเภท Text และรองรับการแปล
namedescriptiondisplay_address
หากต้องการระบุเนื้อหาในหลายภาษา คุณต้องระบุ default_locale
ในช่องและระบุสตริงที่แปลแล้วในรายการ localizations
ตัวอย่าง
json
"name": {
"localizations": [
{
"locale": "en",
"text": "Banana Hotel"
},
{
"locale": "es",
"text": "Hotel Plátano"
}
],
"default_locale": "en"
}
คำจำกัดความ
คำจำกัดความของ 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; }
คำจำกัดความ 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; } }
คำจำกัดความของข้อความ
// 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; }
คำจำกัดความของ 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; } }
คำจำกัดความของ 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; }
คำจำกัดความของรูปภาพ
// 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; }
ตัวอย่าง
ฟีดจุดที่น่าสนใจ
ชื่อไฟล์: poi_1707240000.json
{ "data": [ { "poi_id": "hotel_banana", "name": { "localizations": [ { "locale": "en", "text": "Banana Hotel" } ], "default_locale": "en" }, "telephone": "+16195550100", "url": "https://www.example-banana-hotel.com", "location": { "latitude": 32.7157, "longitude": -117.1611, "address": { "country": "US", "locality": "San Diego", "region": "CA", "postal_code": "92101", "street_address": "2845 W 7th St" } }, "images": [ { "url": "https://www.example.com/banana_hotel.jpg", "alt_text": { "localizations": [ { "locale": "en", "text": "Banana Hotel Exterior" } ] } } ], "rating": 4.5, "category": "HOTEL", "hotel_data": { "hotel_star_class": 4 } }, { "poi_id": "hotel_kiwi", "name": { "localizations": [ { "locale": "en", "text": "Kiwi Hotel" } ], "default_locale": "en" }, "telephone": "+41445550100", "url": "https://www.example-kiwi-hotel.com", "location": { "latitude": 47.3769, "longitude": 8.5417, "address": { "country": "CH", "locality": "Zurich", "postal_code": "8001", "street_address": "Bahnhofstrasse 10" } }, "images": [ { "url": "https://www.example.com/kiwi_hotel.jpg", "alt_text": { "localizations": [ { "locale": "en", "text": "Kiwi Hotel Lobby" } ] } } ], "rating": 4.0, "category": "HOTEL", "hotel_data": { "hotel_star_class": 3 } }, { "poi_id": "hotel_croissant", "name": { "localizations": [ { "locale": "en", "text": "Croissant Hotel" } ], "default_locale": "en" }, "telephone": "+41445550200", "url": "https://www.example-croissant-hotel.com", "location": { "latitude": 47.3686, "longitude": 8.5392, "address": { "country": "CH", "locality": "Zurich", "postal_code": "8002", "street_address": "Paradeplatz 1" } }, "images": [ { "url": "https://www.example.com/croissant_hotel.jpg", "alt_text": { "localizations": [ { "locale": "en", "text": "Croissant Hotel View" } ] } } ], "rating": 5.0, "category": "HOTEL", "hotel_data": { "hotel_star_class": 5 } }, { "poi_id": "hotel_tiburon", "name": { "localizations": [ { "locale": "en", "text": "Hotel Tiburon" } ], "default_locale": "en" }, "telephone": "+15105550100", "url": "https://www.example-tiburon-hotel.com", "location": { "latitude": 37.7652, "longitude": -122.2416, "address": { "country": "US", "locality": "Alameda", "region": "CA", "postal_code": "94501", "street_address": "1100 Atlantic Ave" } }, "images": [ { "url": "https://www.example.com/tiburon_hotel.jpg", "alt_text": { "localizations": [ { "locale": "en", "text": "Hotel Tiburon Pool" } ] } } ], "rating": 4.2, "category": "HOTEL", "hotel_data": { "hotel_star_class": 5 } } ] }
ฟีดจุดที่น่าสนใจหลายภาษา
ชื่อไฟล์: poi_multilingual.json
{ "data": [ { "poi_id": "hotel_banana_multilingual", "name": { "localizations": [ { "locale": "en", "text": "Banana Hotel" }, { "locale": "es", "text": "Hotel Plátano" }, { "locale": "fr", "text": "Hôtel Banane" } ], "default_locale": "en" }, "description": { "localizations": [ { "locale": "en", "text": "A beautiful hotel shaped like a banana." }, { "locale": "es", "text": "Un hermoso hotel con forma de plátano." }, { "locale": "fr", "text": "Un bel hôtel en forme de banane." } ], "default_locale": "en" }, "display_address": { "localizations": [ { "locale": "en", "text": "123 Banana Way, Fruit City, CA 90000" }, { "locale": "es", "text": "123 Vía Plátano, Ciudad Fruta, CA 90000" } ], "default_locale": "en" }, "telephone": "+16195550100", "url": "https://www.example-banana-hotel.com", "location": { "latitude": 32.7157, "longitude": -117.1611, "address": { "country": "US", "locality": "Fruit City", "region": "CA", "postal_code": "90000", "street_address": "123 Banana Way" } }, "images": [ { "url": "https://www.example.com/banana_hotel.jpg", "alt_text": { "localizations": [ { "locale": "en", "text": "Banana Hotel Exterior" }, { "locale": "es", "text": "Exterior del Hotel Plátano" } ] } } ], "rating": 4.5, "category": "HOTEL", "hotel_data": { "hotel_star_class": 4 } } ] }