POI ফিড তৈরি ও আপলোড করা
POI ফিড তৈরি ও আপলোড করার সময়, এইসব নির্দেশাবলী অনুসরণ করুন:
- POI ডেটা ফাইলের জন্য POI ফিড-এ
বর্ণনা করা স্পেসিফিকেশন অনুসরণ করুন। প্রতিটি আপলোডের জন্য অনন্য POI ডেটা
ফাইলের নাম ব্যবহার করার জন্য আমরা সাজেস্ট করি। ফাইলের নামে টাইমস্ট্যাম্প যোগ করুন, যেমন,
POI_1633621547.json। - স্থানীয় POI SFTP সার্ভারে ফিড আপলোড করুন প্রতিদিন সম্পূর্ণ রিফ্রেশ হিসেবে।
- আপনি পার্টনার পোর্টালের কনফিগারেশন > ফিড বিভাগে SFTP সার্ভারের বিবরণ দেখতে পাবেন।
- POI ফিড ভ্যালিডেটর ব্যবহার করে আপলোড করার আগে আপনার POI ফিড যাচাই করুন।
- পার্টনার পোর্টালের ইনজেশন > ইতিহাস বিভাগে ফিড ইনজেশন স্ট্যাটাস দেখুন।
ফাইল প্যাকেজিং সংক্রান্ত নির্দেশিকা
সফলভাবে ইনজেশন নিশ্চিত করতে, নিম্নলিখিত প্যাকেজিং প্রয়োজনীয়তা মেনে চলুন:
- সিঙ্গেল অ্যাগ্রিগেটেড JSON আর্কাইভ (প্রয়োজনীয়): সব এন্টিটি রেকর্ড একটি সিঙ্গেল JSON ফাইলে একত্রিত করুন। আমরা সাজেস্ট করি যে আপনি এটি একটি GZIP আর্কাইভে কম্প্রেস করে আপলোড করুন।
- অ্যান্টি-প্যাটার্ন সংক্রান্ত সতর্কতা: প্রতিটি এন্টিটির জন্য একটি ফাইল বা একই আর্কাইভে দেশ অনুযায়ী আলাদা করা একাধিক ফাইল ব্যবহার করবেন না। এই পদ্ধতি কাজ করে না এবং এর ফলে এক্সট্র্যাক্ট করা যাবে না।
একাধিক ভাষার জন্য সহায়তা
আকর্ষণীয় স্থানের ফিড নির্দিষ্ট ফিল্ডের জন্য স্থানীয় কন্টেন্ট প্রদান করতে
সাহায্য করে। নিম্নলিখিত ফিল্ডগুলি Text ধরনের এবং লোকালাইজেশন সমর্থন করে:
namedescriptiondisplay_address
একাধিক ভাষায় কন্টেন্ট প্রদান করতে, আপনাকে অবশ্যই ফিল্ডে default_locale উল্লেখ করতে হবে এবং localizations তালিকায় লোকালাইজ করা স্ট্রিং প্রদান করতে হবে।
একটি POI এন্ট্রিতে কোনও এন্টিটির জন্য সব লোকালাইজেশন প্রদান করুন। একাধিক ভাষার JSON ফাইলের মধ্যে
একটি এন্টিটি ভাগ করবেন না।
উদাহরণ:
"name": {
"localizations": [
{
"locale": "en",
"text": "Tasty Bites Test Restaurant"
},
{
"locale": "es",
"text": "Restaurante de prueba Tasty Bites"
}
],
"default_locale": "en"
}
ছবি সংক্রান্ত নির্দেশিকা
- ফর্ম্যাট: JPEG, PNG বা WebP হতে হবে।
- ফাইলের সর্বাধিক সাইজ: প্রতিটি ছবির সাইজ ৩০ এমবির কম হতে হবে।
- সর্বাধিক ডাইমেনশন: মোট ৭৫ মেগাপিক্সেলের কম (প্রস্থ x উচ্চতা < ৭৫,০০০,০০০)।
- URL-এর ধরন: ইমেজ অ্যাসেটের ডাইরেক্ট পাথ (যেমন, .jpg দিয়ে শেষ হয়)।
- অনুমতি: হোস্টিং সার্ভার Googlebot বা ক্রলারকে অ্যাক্সেস করার অনুমতি দিচ্ছে কিনা এবং কোনও robots.txt ফাইল ছবির ডিরেক্টরি ব্লক করছে কিনা তা নিশ্চিত করুন।
- নিরাপদ সার্চ: ছবি অবশ্যই Google-এর নিরাপদ সার্চ নীতি মেনে চলতে হবে।
ফিডের স্পেসিফিকেশন
ফিল্ড সংক্রান্ত প্রয়োজনীয়তা
VssPoi
একটি উল্লেখযোগ্য স্থান (POI) এন্টিটি দেখায়, যেমন হোটেল বা রেস্তোরাঁ।
| ফিল্ডের নাম | ধরন | এই ব্যাজ অর্জন করার জন্য প্রয়োজনীয় যোগ্যতা | বিবরণ |
|---|---|---|---|
poi_id | স্ট্রিং | প্রয়োজনীয় | প্রয়োজনীয়। পার্টনারের জেনারেট করা স্ট্রিং যা POI শনাক্ত করে। |
name | অবজেক্ট(Text) | প্রয়োজনীয় | প্রয়োজনীয়। POI-এর নাম। |
telephone | স্ট্রিং | POI-এর সাথে যোগাযোগ করার টেলিফোন নম্বর, যার মধ্যে দেশ ও এলাকার কোড অন্তর্ভুক্ত, যেমন, +১৪৫৬৭৮৯১২৩৪। | |
url | স্ট্রিং | POI-এর সর্বজনীন ওয়েবসাইটের URL। মনে রাখবেন: এটি শুধু মেলানোর জন্য ব্যবহার করা হবে, দেখানোর জন্য নয়। | |
location | অবজেক্ট(GeoCoordinates) | প্রয়োজনীয় | প্রয়োজনীয়। POI-এর লোকেশন। |
display_address | অবজেক্ট(Text) | UI-তে দেখানো ঠিকানা। | |
images | অবজেক্টের অ্যারে(Image) | POI-এর ছবি। সর্বাধিক ছবির সংখ্যা: ৫। | |
rating | নম্বর | POI-এর জন্য গড় রেটিং। | |
num_ratings | নম্বর | rating ফিল্ডের জন্য কন্ট্রিবিউট করা রেটিংয়ের সংখ্যা। | |
rating_scale | নম্বর | rating ফিল্ডের জন্য ব্যবহৃত রেটিং স্কেল। সর্বাধিক রেটিং ৫ হলে, rating_scale ৫ হবে। | |
category | enum(Category) | প্রয়োজনীয় | প্রয়োজনীয়। POI-এর বিভাগ দেখায়। |
description | অবজেক্ট(Text) | POI-এর বিবরণ। | |
| oneOf(additional_data) | প্রয়োজনীয় | এই oneOf-এর ফিল্ডগুলির মধ্যে শুধুমাত্র একটি সেট করা যাবে। |
টেক্সট
স্থানীয়করণ সহ টেক্সট দেখায়।
| ফিল্ডের নাম | ধরন | এই ব্যাজ অর্জন করার জন্য প্রয়োজনীয় যোগ্যতা | বিবরণ |
|---|---|---|---|
localizations | অবজেক্টের অ্যারে(LocalizedString) | লোকালাইজ করা স্ট্রিং। | |
default_locale | স্ট্রিং | ডিফল্ট ভাষা হিসেবে ব্যবহার করার জন্য লোকেলটি অবশ্যই লোকালাইজেশনে থাকতে হবে। |
LocalizedString
লোকালাইজ করা স্ট্রিং দেখায়।
| ফিল্ডের নাম | ধরন | এই ব্যাজ অর্জন করার জন্য প্রয়োজনীয় যোগ্যতা | বিবরণ |
|---|---|---|---|
locale | স্ট্রিং | টেক্সটের ভাষা ট্যাগ, যেমন "en", "en-US" বা "sr-Latn"। | |
text | স্ট্রিং | নির্দিষ্ট লোকেলে টেক্সট। |
GeoCoordinates
অক্ষাংশ, দ্রাঘিমাংশ এবং ঠিকানা সহ কোনও লোকেশনের জিও ডেটা।
| ফিল্ডের নাম | ধরন | এই ব্যাজ অর্জন করার জন্য প্রয়োজনীয় যোগ্যতা | বিবরণ |
|---|---|---|---|
latitude | নম্বর | [-৯০, +৯০] ডিগ্রি (অন্তর্ভুক্ত)। দ্রাঘিমাংশ সেট করা থাকলে এটি প্রয়োজন, অন্যথায় এটি থাকলে ভালো হয়। | |
longitude | নম্বর | [-১৮০, +১৮০] ডিগ্রি (অন্তর্ভুক্ত)। অক্ষাংশ সেট করা থাকলে এটি প্রয়োজন, অন্যথায় এটি থাকলে ভালো হয়। | |
| oneOf(addresses) | প্রয়োজনীয় | এই oneOf-এর ফিল্ডগুলির মধ্যে শুধুমাত্র একটি সেট করা যাবে। |
PostalAddress
লোকেশনটির ডাক ঠিকানা।
| ফিল্ডের নাম | ধরন | এই ব্যাজ অর্জন করার জন্য প্রয়োজনীয় যোগ্যতা | বিবরণ |
|---|---|---|---|
country | স্ট্রিং | প্রয়োজনীয় | প্রয়োজনীয়। ISO 3166-1 alpha-2 দেশের কোড ব্যবহার করে দেশের নাম, যেমন "US"। |
locality | স্ট্রিং | প্রয়োজনীয় | প্রয়োজনীয়। এলাকা/শহর, যেমন "মাউন্টেন ভিউ"। |
region | স্ট্রিং | অঞ্চল/রাজ্য/প্রদেশ, যেমন "CA"। এই ফিল্ডটি শুধুমাত্র সেইসব দেশের জন্য প্রয়োজন যেখানে অঞ্চল সাধারণত ঠিকানার একটি অংশ। (ঐচ্ছিক) | |
postal_code | স্ট্রিং | প্রয়োজনীয় | প্রয়োজনীয়। পোস্টাল কোড, যেমন "94043"। |
street_address | স্ট্রিং | প্রয়োজনীয় | প্রয়োজনীয়। রাস্তার ঠিকানা, যেমন "১৬০০ অ্যাম্ফিথিয়েটার পার্কওয়ে"। |
ছবি
উল্লেখযোগ্য স্থানের (POI) ছবি দেখায়।
| ফিল্ডের নাম | ধরন | এই ব্যাজ অর্জন করার জন্য প্রয়োজনীয় যোগ্যতা | বিবরণ |
|---|---|---|---|
url | স্ট্রিং | ছবির URL। Google এই URL-এ হোস্ট করা মিডিয়া ক্রল করবে। সর্বাধিক দৈর্ঘ্য: ২০০০। | |
alt_text | অবজেক্ট(Text) | অ্যাক্সেসিবিলিটির জন্য ব্যবহার করার বিকল্প টেক্সট। |
HotelData
হোটেল সংক্রান্ত ফিড ডেটা।
| ফিল্ডের নাম | ধরন | এই ব্যাজ অর্জন করার জন্য প্রয়োজনীয় যোগ্যতা | বিবরণ |
|---|---|---|---|
hotel_star_class | নম্বর | হোটেল ক্লাসের অফিসিয়াল স্টার ভ্যালু। "৫-স্টার হোটেল"-এর মতো লেবেলে ব্যবহার করা যেতে পারে। এই ভ্যালু ০ থেকে ৫-এর মধ্যে পূর্ণসংখ্যা হতে হবে। রেটিং উপলভ্য না থাকলে বা উল্লেখ করা না থাকলে, ০ রেটিং ব্যবহার করা উচিত। 0 সেট করা হলে, ব্যবহারকারীদের জন্য UI-তে কোনও স্টার ক্লাস দেখানো হবে না। | |
brand_ids | স্ট্রিংয়ের অ্যারে | যেসব ব্র্যান্ড এই হোটেল দেখাতে পারে। এই ফিল্ড খালি থাকলে, ফিডের সাথে যুক্ত যেকোনও ব্র্যান্ডের অধীনে হোটেলটি দেখানো যেতে পারে। |
LocalData
প্রতিষ্ঠান নির্দিষ্ট ফিড ডেটা।
| ফিল্ডের নাম | ধরন | এই ব্যাজ অর্জন করার জন্য প্রয়োজনীয় যোগ্যতা | বিবরণ |
|---|---|---|---|
business_hours | অবজেক্ট(BusinessHours) | প্রতিষ্ঠানের নিয়মিত কর্মসময়। | |
price_range | অবজেক্ট(PriceRange) | প্রতিষ্ঠানের অফার করা পরিষেবার দামের রেঞ্জ। | |
establishment_category | অবজেক্ট(Text) | প্রতিষ্ঠানের ধরন। | |
brand_landing_pages | অবজেক্টের অ্যারে(BrandLandingPages) | প্রয়োজনীয় | প্রয়োজনীয়। ব্র্যান্ডের ল্যান্ডিং পৃষ্ঠা। অন্তত একটি দিতে হবে। |
BusinessHours
এই লোকেশন ব্যবসার জন্য যে সময়সীমা পর্যন্ত খোলা থাকে তা দেখায়। [TimeRange][madden.vss_poi_feed.TimeRange] ইনস্ট্যান্সের একটি সংগ্রহ ধারণ করে। উদাহরণ: শনিবার সকাল ০৯:০০-১২:০০ এবং দুপুর ১৩:০০-১৭:০০ পর্যন্ত খোলা থাকে: time_ranges { open_day: SATURDAY open_time: { hours: 9, minutes: 0 } close_day: SATURDAY close_time: { hours: 12, minutes: 0 } } time_rages { open_day: SATURDAY open_time: { hours: 13, minutes: 0 } close_day: SATURDAY close_time: { hours: 17, minutes: 0 } } উদাহরণ: শনিবার রাত ২১:০০ থেকে রবিবার রাত ০২:০০ পর্যন্ত খোলা থাকে: time_ranges { open_day: SATURDAY open_time: { hours: 21, minutes: 0 } close_day: SUNDAY close_time: { hours: 2, minutes: 0 } }
| ফিল্ডের নাম | ধরন | এই ব্যাজ অর্জন করার জন্য প্রয়োজনীয় যোগ্যতা | বিবরণ |
|---|---|---|---|
time_ranges | অবজেক্টের অ্যারে(TimeRange) | এই POI ব্যবসার জন্য খোলা থাকার সময়ের একটি সংগ্রহ। প্রতিটি সময়সীমা সপ্তাহের মধ্যে POI খোলা থাকার সময়সীমা দেখায়। |
TimeRange
POI খোলা থাকার সময়সীমা দেখায়, যা নির্দিষ্ট দিন/সময়ে শুরু হয় এবং নির্দিষ্ট দিন/সময়ে শেষ হয়। বন্ধ হওয়ার সময় অবশ্যই খোলার সময়ের পরে হতে হবে, যেমন একই দিনে পরে, অথবা পরের কোনও দিনে।
| ফিল্ডের নাম | ধরন | এই ব্যাজ অর্জন করার জন্য প্রয়োজনীয় যোগ্যতা | বিবরণ |
|---|---|---|---|
open_day | enum(DayOfWeek) | সময়সীমার শুরুর দিন। | |
open_time | অবজেক্ট(TimeOfDay) | সময়সীমার শুরুর সময়। | |
close_day | enum(DayOfWeek) | সময়সীমার শেষ দিন। | |
close_time | অবজেক্ট(TimeOfDay) | সময়সীমা শেষ হওয়ার সময়। |
TimeOfDay
| ফিল্ডের নাম | ধরন | এই ব্যাজ অর্জন করার জন্য প্রয়োজনীয় যোগ্যতা | বিবরণ |
|---|---|---|---|
hours | নম্বর | ২৪ ঘণ্টার ফর্ম্যাটে দিনের ঘণ্টা। ০-এর থেকে বেশি বা সমান হতে হবে এবং সাধারণত ২৩-এর থেকে কম বা সমান হতে হবে। ব্যবসা বন্ধ হওয়ার সময়ের মতো পরিস্থিতিতে API, "২৪:০০:০০" ভ্যালু দেখানোর অনুমতি দিতে পারে। | |
minutes | নম্বর | এক ঘণ্টার মিনিট। অবশ্যই ০-এর চেয়ে বেশি বা তার সমান এবং ৫৯-এর চেয়ে কম বা তার সমান হতে হবে। | |
seconds | নম্বর | এক মিনিটের সেকেন্ড। অবশ্যই ০-এর চেয়ে বেশি বা তার সমান হতে হবে এবং সাধারণত ৫৯-এর চেয়ে কম বা তার সমান হতে হবে। কোনও API-তে লিপ-সেকেন্ডের অনুমতি থাকলে, এটি ৬০ ভ্যালুর অনুমতি দিতে পারে। | |
nanos | নম্বর | ন্যানোসেকেন্ডে, সেকেন্ডের ভগ্নাংশ। ০-এর থেকে বেশি বা সমান এবং ৯৯৯,৯৯৯,৯৯৯-এর থেকে কম বা সমান হতে হবে। |
PriceRange
POI-এর অফার করা পরিষেবার দামের রেঞ্জ।
| ফিল্ডের নাম | ধরন | এই ব্যাজ অর্জন করার জন্য প্রয়োজনীয় যোগ্যতা | বিবরণ |
|---|---|---|---|
min_price | অবজেক্ট(Money) | POI-এর অফার করা পরিষেবার ন্যূনতম দাম। | |
max_price | অবজেক্ট(Money) | POI-এর অফার করা পরিষেবার সর্বোচ্চ দাম। |
অর্থ
মুদ্রার ধরন সহ টাকার পরিমাণ দেখায়।
| ফিল্ডের নাম | ধরন | এই ব্যাজ অর্জন করার জন্য প্রয়োজনীয় যোগ্যতা | বিবরণ |
|---|---|---|---|
currency_code | স্ট্রিং | ISO 4217-এ উল্লেখ করা তিন অক্ষরের মুদ্রার কোড। | |
units | নম্বর | টাকার পরিমাণের সম্পূর্ণ ইউনিট।
যেমন, currencyCode যদি "USD" হয়, তাহলে ১ ইউনিট হল এক মার্কিন ডলার। | |
nanos | নম্বর | পরিমাণের ন্যানো (১০^-৯) ইউনিটের সংখ্যা।
মান অবশ্যই -৯৯৯,৯৯৯,৯৯৯ এবং +৯৯৯,৯৯৯,৯৯৯-এর মধ্যে হতে হবে।
units পজিটিভ হলে, nanos অবশ্যই পজিটিভ বা শূন্য হতে হবে।
units শূন্য হলে, nanos ধনাত্মক, শূন্য বা ঋণাত্মক হতে পারে।
units ঋণাত্মক হলে, nanos অবশ্যই ঋণাত্মক বা শূন্য হতে হবে।
যেমন, $-১.৭৫-কে units=-১ এবং nanos=-৭৫০,০০০,০০০ হিসেবে দেখানো হয়। |
BrandLandingPages
একটি উল্লেখযোগ্য স্থানের (POI) জন্য স্থানীয় ব্র্যান্ড ল্যান্ডিং পৃষ্ঠা।
| ফিল্ডের নাম | ধরন | এই ব্যাজ অর্জন করার জন্য প্রয়োজনীয় যোগ্যতা | বিবরণ |
|---|---|---|---|
brand_id | স্ট্রিং | প্রয়োজনীয় | প্রয়োজনীয়। এই কনফিগারেশন যে ব্র্যান্ডের ক্ষেত্রে প্রযোজ্য। |
localized_landing_pages | অবজেক্টের অ্যারে(LocalizedLandingPage) | লোকালাইজ করা ল্যান্ডিং পৃষ্ঠা। সব লোকালাইজ করা ল্যান্ডিং পৃষ্ঠার ক্ষেত্রে URL এবং লোকেল ফিল্ডের মান অনন্য হতে হবে। | |
default_url | স্ট্রিং | প্রয়োজনীয় | প্রয়োজনীয়। ব্যবহারকারীর ভাষার সাথে কোনও লোকালাইজ করা ল্যান্ডিং পৃষ্ঠা ম্যাচ না করলে, ডিফল্ট ল্যান্ডিং পৃষ্ঠা URL ব্যবহার করা হবে। |
LocalizedLandingPage
উল্লেখযোগ্য স্থানের (POI) জন্য লোকালাইজ করা ল্যান্ডিং পৃষ্ঠা।
| ফিল্ডের নাম | ধরন | এই ব্যাজ অর্জন করার জন্য প্রয়োজনীয় যোগ্যতা | বিবরণ |
|---|---|---|---|
url | স্ট্রিং | ল্যান্ডিং পৃষ্ঠার URL। সর্বাধিক দৈর্ঘ্য: ২০০০। | |
locales | স্ট্রিংয়ের অ্যারে | নির্দিষ্ট ভাষা পছন্দ করেন এমন ব্যবহারকারীদের জন্য এই পৃষ্ঠা সীমাবদ্ধ করে। এতে অবশ্যই ভাষার ট্যাগ থাকতে হবে, যেমন "en", "en-US" বা "sr-Latn"। |
বিভাগ
POI-এর বিভাগ দেখায়।
এটি নিচের additional_data oneof ফিল্ডের সাথে ম্যাচ করতে হবে।
| নাম | বিবরণ |
|---|---|
UNKNOWN_CATEGORY | |
HOTEL | |
LOCAL |
DayOfWeek
সপ্তাহের একটি দিনকে দেখায়।
| নাম | বিবরণ |
|---|---|
DAY_OF_WEEK_UNSPECIFIED | সপ্তাহের দিন উল্লেখ করা নেই। |
MONDAY | সোমবার |
TUESDAY | মঙ্গলবার |
WEDNESDAY | বুধবার |
THURSDAY | বৃহস্পতিবার |
FRIDAY | শুক্রবার |
SATURDAY | শনিবার |
SUNDAY | রবিবার |
additional_data
প্রয়োজনীয়। বিভাগ নির্দিষ্ট ফিল্ড।
এটি উপরের category ফিল্ডের সাথে ম্যাচ করতে হবে।
| ফিল্ডের নাম | ধরন | এই ব্যাজ অর্জন করার জন্য প্রয়োজনীয় যোগ্যতা | বিবরণ |
|---|---|---|---|
hotel_data | অবজেক্ট(HotelData) |
| হোটেল সংক্রান্ত ফিল্ড। |
local_data | অবজেক্ট(LocalData) |
| স্থানীয় নির্দিষ্ট ফিল্ড। |
ঠিকানা
প্রয়োজনীয়। কোনও লোকেশনের ঠিকানা।
| ফিল্ডের নাম | ধরন | এই ব্যাজ অর্জন করার জন্য প্রয়োজনীয় যোগ্যতা | বিবরণ |
|---|---|---|---|
address | অবজেক্ট(PostalAddress) | লোকেশনটির ডাক ঠিকানা। |
সংজ্ঞা
VssPoiFeed Definition
// 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 Definition
// 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 { 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 { // 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; }
জিও-কোঅর্ডিনেটের সংজ্ঞা
// 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 Definition
// 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; }
LocalData সংজ্ঞা
// Establishment specific feed data. message LocalData { // The regular business hours of the establishment. BusinessHours business_hours = 1; // Price range of the services offered by the establishment. PriceRange price_range = 2; // The type of establishment. Text establishment_category = 3; // Required. The brand landing pages. At least one must be provided. repeated BrandLandingPages brand_landing_pages = 4; }
BrandLandingPages Definition
// The Localized brand landing pages for a single Point of Interest (POI). message BrandLandingPages { // Required. The brand this configuration applies to. string brand_id = 1 [(datapol.semantic_type) = ST_PARTNER_ID]; // Localized landing page for the Point of Interest (POI). message LocalizedLandingPage { // The url of the landing page. // Max length: 2000. string url = 1; // Restricts this page to users with the specified language preference. // Must contain language tags, such as "en", "en-US" or "sr-Latn". // Empty list means this page is not restricted by language. repeated string locales = 3; // Restricts this page to users from the specified countries. // Must contain ISO 3166-1 alpha-2 country codes, e.g. "US". // Empty list means this page is not restricted by country. // If `is_default_for_country` is true, this field must not be empty. repeated string countries = 4; // Whether this page should be used as the default fallback for users in // `countries` when no entry for that country matches the user's // language preference. bool is_default_for_country = 5; } // The localized landing pages. // The url and locales fields values must be unique across all the localized // landing pages. repeated LocalizedLandingPage localized_landing_pages = 2; // Required. The default landing page url to be used when none of the // localized landing pages matches the user's language. string default_url = 3; }
নমুনা
উল্লেখযোগ্য স্থানের ফিড
ফাইলের নাম: poi_1707240000.json
{ "data": [ { "poi_id": "test_restaurant_1", "name": { "localizations": [ { "locale": "en", "text": "Tasty Bites Test Restaurant" } ], "default_locale": "en" }, "telephone": "+1234567890", "url": "https://www.tastybitestest.com", "location": { "latitude": 37.422, "longitude": -122.084, "address": { "country": "US", "locality": "Mountain View", "postal_code": "94043", "street_address": "1600 Amphitheatre Pkwy" } }, "display_address": { "localizations": [ { "locale": "en", "text": "1600 Amphitheatre Pkwy, Mountain View, CA 94043" } ], "default_locale": "en" }, "images": [ { "url": "https://www.tastybitestest.com/images/interior.jpg", "alt_text": { "localizations": [ { "locale": "en", "text": "Cozy dining area of Tasty Bites" } ], "default_locale": "en" } } ], "rating": 4.7, "num_ratings": 150, "rating_scale": 5, "category": "LOCAL", "description": { "localizations": [ { "locale": "en", "text": "A mock restaurant for testing the POI feed ingestion." } ], "default_locale": "en" }, "local_data": { "establishment_category": { "localizations": [ { "locale": "en", "text": "Restaurant" } ], "default_locale": "en" }, "price_range": { "min_price": { "currency_code": "USD", "units": 15, "nanos": 0 }, "max_price": { "currency_code": "USD", "units": 45, "nanos": 0 } }, "business_hours": { "time_ranges": [ { "open_day": "MONDAY", "open_time": { "hours": 11, "minutes": 0 }, "close_day": "MONDAY", "close_time": { "hours": 21, "minutes": 0 } }, { "open_day": "TUESDAY", "open_time": { "hours": 11, "minutes": 0 }, "close_day": "TUESDAY", "close_time": { "hours": 21, "minutes": 0 } }, { "open_day": "WEDNESDAY", "open_time": { "hours": 11, "minutes": 0 }, "close_day": "WEDNESDAY", "close_time": { "hours": 21, "minutes": 0 } }, { "open_day": "THURSDAY", "open_time": { "hours": 11, "minutes": 0 }, "close_day": "THURSDAY", "close_time": { "hours": 22, "minutes": 0 } }, { "open_day": "FRIDAY", "open_time": { "hours": 11, "minutes": 0 }, "close_day": "FRIDAY", "close_time": { "hours": 23, "minutes": 0 } }, { "open_day": "SATURDAY", "open_time": { "hours": 10, "minutes": 0 }, "close_day": "SATURDAY", "close_time": { "hours": 23, "minutes": 0 } }, { "open_day": "SUNDAY", "open_time": { "hours": 10, "minutes": 0 }, "close_day": "SUNDAY", "close_time": { "hours": 20, "minutes": 0 } } ] }, "brand_landing_pages": [ { "brand_id": "tasty_bites_brand", "localized_landing_pages": [ { "url": "https://www.tastybitestest.com/en", "locales": ["en-US", "en-GB"] } ], "default_url": "https://www.tastybitestest.com" } ] } } ] }
একাধিক ভাষায় POI ফিড
ফাইলের নাম: poi_multilingual.json
{ "data": [ { "poi_id": "test_restaurant_1", "name": { "localizations": [ { "locale": "en", "text": "Tasty Bites Test Restaurant" }, { "locale": "fr", "text": "Restaurant de test Tasty Bites" } ], "default_locale": "en" }, "telephone": "+1234567890", "url": "https://www.tastybitestest.com", "location": { "latitude": 37.422, "longitude": -122.084, "address": { "country": "US", "locality": "Mountain View", "postal_code": "94043", "street_address": "1600 Amphitheatre Pkwy" } }, "display_address": { "localizations": [ { "locale": "en", "text": "1600 Amphitheatre Pkwy, Mountain View, CA 94043" }, { "locale": "fr", "text": "1600 Amphitheatre Pkwy, Mountain View, CA 94043" } ], "default_locale": "en" }, "images": [ { "url": "https://www.tastybitestest.com/images/interior.jpg", "alt_text": { "localizations": [ { "locale": "en", "text": "Cozy dining area of Tasty Bites" }, { "locale": "fr", "text": "Espace salle à manger accueillant de Tasty Bites" } ], "default_locale": "en" } } ], "rating": 4.7, "num_ratings": 150, "rating_scale": 5, "category": "LOCAL", "description": { "localizations": [ { "locale": "en", "text": "A mock restaurant for testing the POI feed ingestion." }, { "locale": "fr", "text": "Un faux restaurant pour tester l'ingestion de flux de points d'intérêt." } ], "default_locale": "en" }, "local_data": { "establishment_category": { "localizations": [ { "locale": "en", "text": "Restaurant" }, { "locale": "fr", "text": "Restaurant" } ], "default_locale": "en" }, "price_range": { "min_price": { "currency_code": "USD", "units": 15, "nanos": 0 }, "max_price": { "currency_code": "USD", "units": 45, "nanos": 0 } }, "business_hours": { "time_ranges": [ { "open_day": "MONDAY", "open_time": { "hours": 11, "minutes": 0 }, "close_day": "MONDAY", "close_time": { "hours": 21, "minutes": 0 } }, { "open_day": "TUESDAY", "open_time": { "hours": 11, "minutes": 0 }, "close_day": "TUESDAY", "close_time": { "hours": 21, "minutes": 0 } }, { "open_day": "WEDNESDAY", "open_time": { "hours": 11, "minutes": 0 }, "close_day": "WEDNESDAY", "close_time": { "hours": 21, "minutes": 0 } }, { "open_day": "THURSDAY", "open_time": { "hours": 11, "minutes": 0 }, "close_day": "THURSDAY", "close_time": { "hours": 22, "minutes": 0 } }, { "open_day": "FRIDAY", "open_time": { "hours": 11, "minutes": 0 }, "close_day": "FRIDAY", "close_time": { "hours": 23, "minutes": 0 } }, { "open_day": "SATURDAY", "open_time": { "hours": 10, "minutes": 0 }, "close_day": "SATURDAY", "close_time": { "hours": 23, "minutes": 0 } }, { "open_day": "SUNDAY", "open_time": { "hours": 10, "minutes": 0 }, "close_day": "SUNDAY", "close_time": { "hours": 20, "minutes": 0 } } ] }, "brand_landing_pages": [ { "brand_id": "tasty_bites_brand", "localized_landing_pages": [ { "url": "https://www.tastybitestest.com/fr", "locales": ["fr-FR", "fr-CA"] }, { "url": "https://www.tastybitestest.com/en", "locales": ["en-US", "en-GB"] } ], "default_url": "https://www.tastybitestest.com" } ] } } ] }