از ویژگی های نسخه 3 به نقطه پایانی SearchDestinations مهاجرت کنید

توسعه دهندگان منطقه اقتصادی اروپا (EEA).

ویژگی‌های زیر در Geocoding API v3 با نقطه پایانی SearchDestinations در Geocoding API v4 جایگزین می‌شوند:

  • ورودی ها
  • نقاط ناوبری
  • خطوط کلی ساختمان
  • زمینه ها

اگر از Geocoding API v3 برای ویژگی‌های بالا استفاده می‌کردید، از این سند برای کمک به استفاده از نقطه پایانی SearchDestinations برای دریافت این ویژگی‌ها استفاده کنید. این سند توضیح می‌دهد که کجا در پاسخ SearchDestinations API برای یافتن این ویژگی‌ها، و تفاوت‌ها در نحوه نمایش این ویژگی‌ها در پاسخ‌های API بین Geocoding API v3 و نقطه پایان SearchDestinations از Geocoding API v4.

ورودی ها

برای دریافت ورودی های مرتبط با یک destination ، از فیلد destination.entrances استفاده کنید.

توجه داشته باشید که فرمت entrance کمی با فرمت ورودی در Geocoding API v3 متفاوت است. هر ورودی در destination.entrances دارای فیلدهای زیر است:

  • displayName - این یک فیلد اختیاری جدید است که یک نام قابل خواندن برای ورودی دارد، به عنوان مثال "Gate B".
  • location - این مکانی از نوع LatLng است که با فرمت مورد استفاده در Geocoding API v3 متفاوت است.
  • tags - این همان قسمت tags ورودی ها از Geocoding API v3 است.
  • place - مشابه فیلد buildingPlaceId ورودی ها از Geocoding API v3. با این حال، شناسه مکان در این قسمت می تواند برای یک مکان از هر نوع باشد، نه لزوماً فقط یک ساختمان.

برای دریافت نقاط پیمایش مرتبط با یک destination ، از فیلد destination.navigationPoints استفاده کنید.

توجه داشته باشید که فرمت یک navigationPoint کمی با فرمت نقطه ناوبری در Geocoding API v3 متفاوت است. هر نقطه ناوبری در destination.navigationPoints دارای فیلدهای زیر است:

  • displayName - این یک فیلد اختیاری جدید است که یک نام قابل خواندن توسط انسان برای نقطه ناوبری دارد، به عنوان مثال "خیابان پنجم".
  • location - این مکانی از نوع LatLng است که با فرمت مورد استفاده در Geocoding API v3 متفاوت است.
  • travelModes - این شبیه به قسمت restrictedTravelModes نقاط ناوبری از Geocoding API v3 است. مقادیر enum ممکن یکسان هستند، تنها تفاوت این است که این فیلد اکنون حالت های سفر قابل قبول برای نقطه ناوبری را نشان می دهد نه حالت های سفر محدود.
  • usage - این یک فیلد جدید است که شامل موارد استفاده پشتیبانی شده توسط نقطه ناوبری است. توجه داشته باشید که بیشتر نقاط ناوبری استفاده UNKNOWN دارند، اما این لزوماً به این معنی نیست که استفاده از نقطه ناوبری به هیچ وجه محدود شده است.

خطوط کلی ساختمان

برای دریافت خطوط کلی ساختمان مرتبط با یک destination ، باید از فیلد displayPolygon اشیاء placeView در destination که ساختمان‌ها را نشان می‌دهند استفاده کنید. برای هر placeView ، می‌توانید با قسمت placeView.structureType بررسی کنید که آیا ساختمانی است یا خیر. اگر نوع ساختار BUILDING است، می‌توانید طرح کلی را از قسمت placeView.displayPolygon دریافت کنید. placeView همچنین دارای فیلدهای اضافی برای ساختمان است که در Geocoding API v3 وجود ندارد.

یک destination می تواند یک شی placeView داشته باشد که یک ساختمان را در فیلدهای زیر نشان می دهد:

  • destination.primary - این مکان اصلی برای مقصد است.
  • destination.containingPlaces - این یک فیلد تکراری است که می تواند مکان های بزرگ تری را که "حاوی" مکان اصلی هستند را در خود جای دهد. به عنوان مثال، اگر مکان اصلی یک subpremise باشد، containingPlaces معمولاً placeView نگه می دارد که نمایانگر ساختمان است.
  • destination.subDestinations - این یک فیلد تکراری است که می تواند مقصدهای فرعی مکان اصلی را در خود جای دهد. به عنوان مثال، واحدهای آپارتمانی منفرد یک ساختمان. این فیلد معمولاً یک placeView نمای ساختمان ندارد.

توجه داشته باشید که قالب placeView.displayPolygon با فرمت طرح کلی ساختمان در Geocoding API v3 که قالب GeoJSON است، با فرمت RFC 7946 مطابقت دارد.

زمینه ها

مانند خطوط کلی ساختمان، برای بدست آوردن زمینه های مرتبط با یک destination ، باید از فیلد displayPolygon اشیاء placeView در destination استفاده کنید که نشان دهنده زمینه هستند. برای هر placeView ، می‌توانید با فیلد placeView.structureType بررسی کنید که آیا دلیل است یا خیر. اگر نوع ساختار GROUNDS است، می‌توانید طرح کلی را از قسمت placeView.displayPolygon دریافت کنید. placeView همچنین دارای فیلدهای اضافی برای زمینه‌هایی است که در Geocoding API v3 نبوده‌اند.

یک destination می‌تواند یک شی placeView داشته باشد که یک پایه را در فیلدهای زیر نشان می‌دهد:

  • destination.primary
  • destination.containingPlaces
  • destination.subDestinations

توجه داشته باشید که قالب placeView.displayPolygon با فرمت طرح کلی زمین در Geocoding API v3 ، که قالب GeoJSON است، با فرمت RFC 7946 مطابقت دارد.

از یک فیلد ماسک برای درخواست این ویژگی ها استفاده کنید

نقطه پایان SearchDestinations به یک ماسک فیلد نیاز دارد، همانطور که در Choose fields to return توضیح داده شده است. ماسک فیلد را می توان روی * تنظیم کرد تا همه فیلدها را برگرداند، یا می توانید آن را روی فیلدهای خاصی که می خواهید دریافت کنید تنظیم کنید. به عنوان مثال، درخواست API زیر، فیلد ماسک را برای دریافت تمام فیلدهای مورد نیاز برای دریافت ورودی‌ها، نقاط ناوبری، خطوط کلی ساختمان و محوطه مقصد تنظیم می‌کند:

curl -X POST -d '{"place": "places/ChIJG3kh4hq6j4AR_XuFQnV0_t8"}' \
  -H "X-Goog-Api-Key: API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Goog-FieldMask: destinations.entrances,destinations.navigationPoints,destinations.primary,destinations.containingPlaces,destinations.subDestinations" \
  https://geocode.googleapis.com/v4alpha/geocode/destinations