このページでは、スポット（POI）フィードの技術仕様について詳しく説明します。必須フィールドの概要、包括的なスキーマ定義、実装のガイドとなる JSON サンプルが含まれています。
フィードの詳細
このセクションでは、スポット フィードの要件と定義について説明します。
フィールドの要件
| フィールド名 | 要件 | 説明 |
|---|---|---|
| poi_id | 必須 | パートナーが生成した、スポット（宿泊施設）を識別する文字列。 |
| name | 必須 | スポットの名前。この名前は、アグリゲータ ユニットの宿泊施設の表示名として使用されます。 |
| 電話 | 推奨 | 国番号と市外局番を含む、スポットの連絡先電話番号（例: +14567891234）。 |
url |
推奨 | スポットの公開ウェブサイトの URL。注: これは表示ではなく、照合のみに使用されます。 |
| ロケーション | 必須（住所） 推奨（緯度/経度） |
スポットのロケーション。 必須: 宿泊施設を適切に照合するには、住所と付随するフィールドが必要です。 推奨: 緯度と経度。指定すると、Google はアグリゲータ ユニットの地図に表示される宿泊施設のピンに緯度と経度を使用します。 |
| 画像 | 強く推奨（1 枚） 推奨（複数） |
スポットの画像。画像は宿泊施設の表示に重要です。少なくとも 1 枚の画像を追加することを強くおすすめします。最大 5 枚の画像を指定できます。複数の画像が指定されている場合は、指定された順に使用されます（画像が使用できない場合）。 画像は、Google のセーフサーチ ポリシーに違反していないことを確認するために審査されます。 |
| 評価 | 推奨 | 宿泊施設の平均評価。 |
| num_ratings | 推奨 | rating フィールドの評価の件数。 |
| rating_scale | 推奨 | rating フィールドに使用される段階別評価。最大評価が 5 の場合、rating_scale は 5 になります。 |
| category | 推奨 | 宿泊施設のカテゴリを表します。 |
| hotel_data | 推奨 | ホテル固有のフィールド。詳しくは、HotelData の定義をご覧ください。 |
| hotel_star_class | 推奨 | ホテルの公式なホテル クラスの星の数。この値は 1 ～ 5 の整数にする必要があります。 |
| brand_ids | 推奨 | このホテルを表示できるブランド。このフィールドが空の場合、ホテルはフィードに関連付けられている任意のブランドで表示できます。 |
| 説明 | 推奨 | 宿泊施設の詳細な説明。 |
| display_address | 推奨 | UI に表示される住所。 |
画像に関するガイドライン
フィードに追加するすべての画像は、次のガイドラインに準拠している必要があります。
- 形式: JPEG、PNG、WebP である必要があります。
- 最大ファイルサイズ: 画像 1 枚あたり 30 MB 未満。
- 最大寸法: 合計 7,500 万メガピクセル未満（幅 x 高さ < 75,000,000）。
- URL の種類: 画像アセットへの直接パス（例: .jpg で終わる）。
- 権限: ホスティング サーバーで Googlebot またはクローラへのアクセスが許可されており、画像ディレクトリをブロックする robots.txt がないことを確認してください。
多言語対応
スポット フィードでは、特定のフィールドにローカライズされたコンテンツを提供できます。次のフィールドは Text 型で、ローカライズをサポートしています。
namedescriptiondisplay_address
複数の言語でコンテンツを提供するには、フィールドに default_locale を指定し、ローカライズされた文字列を localizations リストに指定する必要があります。
1 つのスポット エントリに、宿泊施設のすべてのローカライズを指定します。1 つの宿泊施設を複数の言語の JSON ファイルに分割しないでください。
例:
"name": {
"localizations": [
{
"locale": "en",
"text": "Banana Hotel"
},
{
"locale": "es",
"text": "Hotel Plátano"
}
],
"default_locale": "en"
}
ファイルのパッケージングに関するガイドライン
正常に取り込むには、次のパッケージング要件に準拠してください。
- 単一の集約された JSON アーカイブ（必須）: すべての宿泊施設のレコードを 1 つの JSON ファイルにまとめます。1 つの GZIP アーカイブに圧縮してアップロードすることをおすすめします。
- アンチパターンに関する警告: 1 つのアーカイブに、宿泊施設ごとに 1 つのファイルを使用したり、 国別に分割された複数のファイルを使用したりしないでください。この方法はサポートされておらず、抽出エラーが発生します。
定義
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; } }
Text の定義
// 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; }
Image の定義
// 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; }
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]; }
サンプル
スポット フィード
ファイル名: 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, "brand_ids": ["brand_a", "brand_b"] } }, { "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, "brand_ids": ["brand_c"] } }, { "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, "brand_ids": ["brand_a"] } } ] }
多言語対応スポット フィード
ファイル名: 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, "brand_ids": ["brand_mango", "brand_apricot"] } } ] }