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

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 را نشان می دهد که می توانید در پاسخ قرار دهید:

همه پیوندها را در پاسخ 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 آشنا شوید.

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

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

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

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

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

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