پیوند به Google Maps

‫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 را که می‌توانید در پاسخ بگنجانید نشان می‌دهد:

گنجاندن همه پیوندها در پاسخ «مکان‌ها»

پیوندهای موجود در پاسخ مکان‌ها در فیلد 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'

افزودن مسیرها در پاسخ

همه روش‌های «مکان‌ها» از تولید پیوند مسیرها در پاسخ پشتیبانی می‌کنند. مکان فعلی به‌عنوان مبدأ، مکان جا به‌عنوان مقصد، و حالت سفر به‌عنوان رانندگی استفاده می‌شود.

مثال بعدی از «جستجوی اطراف» (جدید) برای افزودن پیوند مسیرهای نقشه در پاسخ در فیلد 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 برای باز کردن مرور یا عکس در مرورگر است.

امتحان کنید!

«کاوشگر میانای برنامه‌سازی کاربردی» به شما امکان می‌دهد درخواست‌های نمونه‌ای ایجاد کنید تا بتوانید با میانای برنامه‌سازی کاربردی و گزینه‌های میانای برنامه‌سازی کاربردی آشنا شوید.

1. نماد api API را در سمت چپ صفحه انتخاب کنید.

2. درصورت تمایل، نمایش پارامترهای استاندارد را ازهم باز کنید و پارامتر fields را روی پوشش فیلد تنظیم کنید.

3. درصورت تمایل، بدنه درخواست را ویرایش کنید.

4. دکمه اجرا را انتخاب کنید. در کادر گفتگو، حسابی را که می‌خواهید برای درخواست استفاده شود انتخاب کنید.

5. در پانل «کاوشگر API»، fullscreen را انتخاب کنید

   تمام‌صفحه برای ازهم بازکردن پنجره «کاوشگر میانای برنامه‌سازی کاربردی».