Places API (جدید) درخواست‌های داده‌های مکان را ازطریق روش‌های مختلفی می‌پذیرد. پاسخ Places API (جدید) حاوی داده‌هایی درباره مکان است، ازجمله داده‌های مکان و تصاویر، مکان‌های جغرافیایی، و مکان‌های جالب برجسته.
پاسخ «جستجوی نوشتار (جدید)»، «جستجوی اطراف (جدید)»، و «جزئیات مکان (جدید)» می‌تواند حاوی پیوندهایی به Google Maps نیز باشد. کاربرانتان می‌توانند این پیوندهای Google Maps را مرور کنند تا اطلاعات بیشتری درباره مکان موجود در پاسخ ببینند.
برای مثال، فرودگاه‌های سان‌فرانسیسکو، کالیفرنیا را جستجو می‌کنید. سپس پاسخ
شامل فرودگاه بین‌المللی سان‌فرانسیسکو (SFO) در فهرست مکان‌ها می‌شود.
شیء Place
برای SFO در پاسخ، فیلد googleMapsUri را اضافه می‌کند که حاوی
پیوندهای Google Maps برای باز کردن Google Maps در آن مکان،
مسیرهای منتهی به آن مکان، مرورهای آن مکان، و عکس‌های آن مکان است.
همراه با پیوندهای اضافه‌شده به شیء Place، فیلد googleMapsUri نیز به اشیاء
Reviews
و
Photos
در پاسخ اضافه می‌شود:
Reviews.googleMapsUri: حاوی پیوند Google Maps به مرور است تا بتوانید آن را در مرورگر مشاهده کنید.Photos.googleMapsUri: حاوی پیوند Google Maps به عکس است تا بتوانید آن را در مرورگر مشاهده کنید.
API Explorer به شما امکان می‌دهد درخواست‌های مستقیم ارسال کنید تا بتوانید با این گزینه‌های جدید آشنا شوید:
پیوندهای Google Maps پشتیبانی‌شده برای مکان
جدول زیر پیوندهای Google Maps را که می‌توانید در پاسخ بگنجانید نشان می‌دهد:
| پیوند Google Maps | شرح | نام فیلد |
|---|---|---|
| جا | پیوند برای باز کردن Google Maps در آن مکان. | googleMapsLinks.placeUri |
| مسیرها | پیوند برای باز کردن مسیرهای رسیدن به مکان در Google Maps. | googleMapsLinks.directionsUri |
| نوشتن مرور | پیوند برای نوشتن مرور برای مکان در Google Maps. | googleMapsLinks.writeAReviewUri |
| خواندن مرورها | پیوند برای نمایش مرورهای Google Maps درباره مکان. | googleMapsLinks.reviewsUri |
| Photos | پیوند برای نمایش عکس‌های مکان در Google Maps. | googleMapsLinks.photosUri |
گنجاندن همه پیوندها در پاسخ Places
پیوندهای موجود در پاسخ مکان‌ها در فیلد
googleMapsLinks
قرار دارند. اگر می‌خواهید فیلد googleMapsLinks در پاسخ نشان داده شود، حتماً آن را در ماسک فیلد درخواست بگنجانید.
برای مثال، «جستجوی نوشتار» (جدید) زیر شامل همه پیوندهای Maps در پاسخ است:
curl -X POST -d '{
"textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks' \
'https://places.googleapis.com/v1/places:searchText'
پاسخ به‌صورت زیر است:
{
"places": [
{
"formattedAddress": "San Francisco, CA 94128, USA",
"displayName": {
"text": "San Francisco International Airport",
"languageCode": "en"
},
"googleMapsLinks": {
"placeUri": "https://maps.google.com/?cid=11885663895765773631",
"directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x808f778c55555555:0xa4f25c571acded3f!3e0",
"writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!12e1",
"reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x808f778c55555555:0xa4f25c571acded3f!9m1!1b1",
"photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!10e5"
}
}
]
}گنجاندن پیوندی خاص در پاسخ
لازم نیست همه پیوندها را در پاسخ برگردانید. برای مثال، اگر فقط
پیوند عکس‌ها را در پاسخ می‌خواهید، ماسک فیلد را همان‌طور که در زیر نشان داده شده است اصلاح کنید تا
فقط فیلد photosUri را دربرگیرد:
curl -X POST -d '{
"textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks.photosURI' \
'https://places.googleapis.com/v1/places:searchText'
گنجاندن مسیر در پاسخ
همه روش‌های Places از تولید پیوند مسیرها در پاسخ پشتیبانی می‌کنند. مکان فعلی به‌عنوان مبدأ، مکان جا به‌عنوان مقصد، و حالت سفر به‌عنوان رانندگی استفاده می‌شود.
مثال بعدی از «جستجوی اطراف» (جدید) برای گنجاندن پیوند مسیرهای نقشه در پاسخ در فیلد directionsUri استفاده می‌کند:
curl -X POST -d '{
"includedTypes": ["restaurant"],
"maxResultCount": 10,
"locationRestriction": {
"circle": {
"center": {
"latitude": -33.8688,
"longitude": 151.1957362},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key:API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.googleMapsLinks.directionsUri' \
https://places.googleapis.com/v1/places:searchNearby
پیوندهای مرورها و عکس‌ها را اضافه کنید
این نسخه فیلد googleMapsUri را به
Reviews
و
Photos
در پاسخ اضافه می‌کند. با مرور این پیوندها، مرور یا عکس در Google Maps باز می‌شود.
برای مثال، «جستجوی نوشتار» (جدید) زیر شامل مرورها و عکس‌ها برای هر مکان در پاسخ است:
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.reviews,places.photos' \
'https://places.googleapis.com/v1/places:searchText'
در پاسخ، هر عنصر از آرایه مرورها و عکس‌ها حاوی فیلد
googleMapsUri برای باز کردن مرور یا عکس در مرورگر است.
امتحان کنید!
API Explorer به شما امکان می‌دهد درخواست‌های نمونه ایجاد کنید تا بتوانید با API و گزینه‌های API آشنا شوید.
نماد API را در سمت راست صفحه انتخاب کنید.
درصورت تمایل، نمایش پارامترهای استاندارد را ازهم باز کنید و پارامتر
fieldsرا روی ماسک فیلد تنظیم کنید.درصورت تمایل، بدنه درخواست را ویرایش کنید.
دکمه اجرا را انتخاب کنید. در کادر گفتگو، حسابی را که می‌خواهید برای درخواست استفاده شود انتخاب کنید.
در پانل API Explorer، را انتخاب کنید
تمام‌صفحه برای ازهم باز کردن پنجره API Explorer.