Places API درخواست داده‌های مکان را از طریق روش‌های مختلف می‌پذیرد. پاسخ Places API حاوی داده‌هایی درباره یک مکان است، از جمله داده‌های مکان و تصاویر، مکان‌های جغرافیایی و نقاط دیدنی برجسته.
با این نسخه، پاسخ جستجوی متن، جستجوی نزدیک، و جزئیات مکان نیز می‌تواند حاوی پیوندهایی به Google Maps باشد. کاربران شما می توانند به این پیوندهای Google Maps مراجعه کنند تا اطلاعات بیشتری در مورد یک مکان در پاسخ مشاهده کنند.
به عنوان مثال، شما فرودگاه های سانفرانسیسکو، کالیفرنیا را جستجو می کنید. سپس پاسخ، فرودگاه بین‌المللی سانفرانسیسکو (SFO) را در فهرست مکان‌ها قرار می‌دهد. با این نسخه، شی Place برای SFO در پاسخ، فیلد googleMapsUri حاوی پیوندهای Google Maps را اضافه می کند تا نقشه های Google را به مکان، مسیرها به مکان، نظرات مکان، و عکس های مکان باز کند.
همراه با پیوندهای اضافه شده به شی Place ، این نسخه همچنین فیلد googleMapsUri را به اشیاء Reviews و Photos در پاسخ اضافه می کند:
Reviews.googleMapsUri: حاوی یک پیوند Google Maps به نظر است تا بتوانید آن را در مرورگر مشاهده کنید.Photos.googleMapsUri: حاوی یک پیوند Google Maps به عکس است تا بتوانید آن را در مرورگر مشاهده کنید.
API Explorer به شما امکان می دهد درخواست های زنده بنویسید تا بتوانید با این گزینه های جدید آشنا شوید:
پیوندهای Google Maps پشتیبانی شده برای یک مکان
جدول زیر پیوندهای Google Maps را نشان می دهد که می توانید در پاسخ قرار دهید:
| لینک گوگل مپ | توضیحات | نام فیلد |
|---|---|---|
| مکان | پیوند برای باز کردن Google Maps به مکان. | googleMapsLinks.placeUri |
| مسیرها | پیوند برای باز کردن مسیرهای مکان در Google Maps. | googleMapsLinks.directionsUri |
| نظر بنویسید | پیوند نوشتن نظر برای مکان در Google Maps. | googleMapsLinks.writeAReviewUri |
| بررسی ها را بخوانید | پیوندی برای نمایش نظرات Google Maps درباره مکان. | googleMapsLinks.reviewsUri |
| عکس ها | پیوندی برای نمایش عکس‌های مکان در Google Maps. | googleMapsLinks.photosUri |
قیمت گذاری
این ویژگی در مرحله پیش‌نمایش پیش‌نمایش GA است و هزینه‌ای دریافت نمی‌کند، به این معنی که صورتحساب 0 دلار برای استفاده در حین پیش‌نمایش است. برای جزئیات در مورد قیمت پیشنهادی، استفاده و صورتحساب Places API را ببینید.
همه پیوندها را در پاسخ 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 از تولید پیوند جهت ها در پاسخ پشتیبانی می کنند. مکان فعلی به عنوان مبدا، مکان مکان به عنوان مقصد و حالت سفر به عنوان رانندگی استفاده می شود.
مثال بعدی از Nearby Search استفاده می‌کند تا پیوند مسیرهای نقشه‌ها را در پاسخ در قسمت 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را روی فیلد ماسک تنظیم کنید.به صورت اختیاری بدنه درخواست را ویرایش کنید.
دکمه Execute را انتخاب کنید. در گفتگو، حسابی را که می‌خواهید برای ارسال درخواست استفاده کنید، انتخاب کنید.
در پانل API Explorer، نماد گسترش را انتخاب کنید،
، برای گسترش پنجره API Explorer.