پیوند به نقشه های گوگل

API مکان‌ها (جدید) درخواست‌های مربوط به داده‌های مکان را از طریق روش‌های مختلفی می‌پذیرد. پاسخ API مکان‌ها (جدید) شامل داده‌هایی درباره یک مکان، از جمله داده‌های مکانی و تصاویر، موقعیت‌های جغرافیایی و نقاط برجسته مورد علاقه است.

پاسخ‌های «جستجوی متن» (جدید)، «جستجوی نزدیک» (جدید) و «جزئیات مکان» (جدید) می‌توانند حاوی لینک‌هایی به نقشه‌های گوگل نیز باشند. کاربران شما می‌توانند برای مشاهده اطلاعات بیشتر در مورد یک مکان در پاسخ، به این لینک‌های نقشه‌های گوگل مراجعه کنند.

برای مثال، شما فرودگاه‌های سانفرانسیسکو، کالیفرنیا را جستجو می‌کنید. سپس پاسخ، فرودگاه بین‌المللی سانفرانسیسکو (SFO) را در لیست مکان‌ها قرار می‌دهد. شیء Place برای SFO در پاسخ، فیلد googleMapsUri را اضافه می‌کند که حاوی لینک‌های Google Maps برای باز کردن Google Maps به آن مکان، مسیرهای منتهی به آن مکان، نظرات مربوط به آن مکان و عکس‌های آن مکان است.

همراه با لینک‌های اضافه شده به شیء Place ، فیلد googleMapsUri نیز به اشیاء Reviews و Photos در پاسخ اضافه می‌شود:

• Reviews.googleMapsUri : شامل یک لینک گوگل مپ به نقد و بررسی است تا بتوانید آن را در مرورگر مشاهده کنید.

• Photos.googleMapsUri : شامل یک لینک گوگل مپ به عکس است تا بتوانید آن را در مرورگر مشاهده کنید.

API Explorer به شما امکان می‌دهد درخواست‌های زنده ارسال کنید تا بتوانید با این گزینه‌های جدید آشنا شوید:

امتحانش کن!

پیوندهای پشتیبانی‌شده‌ی نقشه‌های گوگل برای یک مکان

جدول زیر لینک‌های نقشه گوگل را که می‌توانید در پاسخ بگنجانید نشان می‌دهد:

تمام لینک‌ها را در پاسخ Places قرار دهید

لینک‌های موجود در پاسخ places در فیلد googleMapsLinks قرار دارند. اگر می‌خواهید فیلد googleMapsLinks در پاسخ نمایش داده شود، حتماً آن را در فیلد mask درخواست قرار دهید.

برای مثال، جستجوی متن زیر (جدید) شامل تمام لینک‌های نقشه در پاسخ است:

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 از تولید لینک جهت‌ها در پاسخ پشتیبانی می‌کنند. مکان فعلی به عنوان مبدا، مکان place به عنوان مقصد و حالت سفر drive است.

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

در پاسخ، هر عنصر از آرایه reviews و photos شامل فیلد googleMapsUri برای باز کردن review یا عکس در مرورگر است.

امتحانش کن!

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

1. آیکون api در سمت راست صفحه را انتخاب کنید.

2. در صورت تمایل، Show standard parameters را گسترش داده و پارامتر fields را روی field mask تنظیم کنید.

3. به صورت اختیاری، متن درخواست (Request body) را ویرایش کنید.

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

5. در پنل API Explorer، fullscreen انتخاب کنید

   تمام صفحه برای گسترش پنجره API Explorer.