3D Maps

کلاس Map3DElement

‫google.maps.maps3d.Map3DElement کلاس

‫Map3DElement یک میانای HTML برای نمای «نقشه سه‌بعدی» است. توجه داشته باشید که mode باید تنظیم شود تا «نقشه سه‌بعدی» شروع به پرداز کردن کند.

عنصر سفارشی:
<gmp-map-3d center="lat,lng,altitude" default-ui-hidden description="string" gesture-handling="auto" heading="number" internal-usage-attribution-ids="id1 id2" map-id="string" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" mode="hybrid" range="number" roll="number" tilt="number" default-ui-disabled></gmp-map-3d>

این کلاس HTMLElement را گسترش می‌دهد.

این کلاس Map3DElementOptions را پیاده‌سازی می‌کند.

با تماس با const {Map3DElement} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

Map3DElement
Map3DElement([options])
پارامترها: 
bounds
وقتی تنظیم شود، موقعیت دوربین را در محدوده طول/عرض جغرافیایی مشخص‌شده محدود می‌کند. توجه داشته باشید که اشیای خارج از مرزها همچنان رندر می‌شوند. مرزها می‌توانند هم طول جغرافیایی و هم عرض جغرافیایی را محدود کنند، یا می‌توانند فقط عرض جغرافیایی یا فقط طول جغرافیایی را محدود کنند. برای مرزهای فقط عرض جغرافیایی، از طول جغرافیایی غربی و شرقی به‌ترتیب -180 و 180 استفاده کنید. برای مرزهای فقط طول جغرافیایی، به‌ترتیب از عرض‌های جغرافیایی شمالی و جنوبی 90 و -90 استفاده کنید.
center
مرکز نقشه به‌صورت LatLngAltitude ارائه می‌شود که در آن ارتفاع برحسب متر از سطح زمین است. توجه داشته باشید که این لزوماً جایی نیست که دوربین قرار دارد، زیرا فیلد range بر فاصله دوربین از مرکز نقشه تأثیر می‌گذارد. اگر تنظیم نشده باشد، به‌طور پیش‌فرض روی {lat: 0, lng: 0, altitude: 63170000} تنظیم می‌شود. ‫۶۳۱۷۰۰۰۰ متر حداکثر ارتفاع مجاز است (شعاع زمین ضرب در ۱۰).
مشخصه HTML:
  • <gmp-map-3d center="lat,lng,altitude"></gmp-map-3d>
defaultUIHidden
نوع:  boolean optional
پیش‌فرض: false
وقتی true، همه دکمه‌های پیش‌فرض واسط کاربر پنهان می‌شوند.
مشخصه HTML:
  • <gmp-map-3d default-ui-hidden></gmp-map-3d>
description
نوع:  string optional
اگر ارائه شده باشد، شرح دسترس‌پذیری (مثلاً برای استفاده با صفحه‌خوان‌ها) با مقدار ارائه‌شده به نقشه اضافه خواهد شد.
مشخصه HTML:
  • <gmp-map-3d description="string"></gmp-map-3d>
gestureHandling
نوع:  GestureHandling optional
پیش‌فرض: GestureHandling.GREEDY
مدیریت اشاره مشارکتی را کنترل می‌کند. وقتی روی COOPERATIVE تنظیم شده باشد، برای پیمایش نقشه به کلیدهای اصلاح‌گر یا اشاره‌های دو انگشتی نیاز است. وقتی روی GREEDY تنظیم شود، صفحه میزبان نمی‌تواند از رویدادهای کاربر در عنصر نقشه پیمایش شود. وقتی روی AUTO تنظیم شود، مدیریت اشاره براساس پیمایش‌پذیری صفحه میزبان تعیین می‌شود.
مشخصه HTML:
  • <gmp-map-3d gesture-handling="auto"></gmp-map-3d>
  • <gmp-map-3d gesture-handling="cooperative"></gmp-map-3d>
  • <gmp-map-3d gesture-handling="greedy"></gmp-map-3d>
heading
نوع:  number optional
جهت قطب‌نمای نقشه، برحسب درجه، که در آن شمال واقعی صفر است. وقتی شیبی وجود نداشته باشد، هرگونه چرخش به‌عنوان جهت حرکت تفسیر خواهد شد.
مشخصه HTML:
  • <gmp-map-3d heading="number"></gmp-map-3d>
internalUsageAttributionIds
نوع:  Iterable<string> optional
شناسه ارجاع استفاده را به مقداردهی اولیه اضافه می‌کند، که به Google کمک می‌کند بفهمد کدام کتابخانه‌ها و نمونه‌ها برای توسعه‌دهندگان مفید هستند، مانند استفاده از کتابخانه خوشه‌بندی نشانگر. برای انصراف از ارسال شناسه ارجاع استفاده، می‌توانید این ویژگی را حذف کنید. فقط مقادیر یکتا ارسال خواهد شد. تغییرات در این مقدار پس‌از نمونه‌سازی ممکن است نادیده گرفته شود.
مشخصه HTML:
  • <gmp-map-3d internal-usage-attribution-ids="id1 id2"></gmp-map-3d>
language
نوع:  string optional
زبان موردنظر برای ارائه زبان نقشه مبنا. به‌طور پیش‌فرض به زبانی که توسعه‌دهنده هنگام بار کردن Maps JS API درخواست کرده است تنظیم می‌شود.
mapId
نوع:  string optional
شناسه نقشه‌ای را مشخص می‌کند که برای واکشی سبک نقشه بااستفاده از فضای ابری برای نقشه استفاده خواهد شد. این نباید پس‌از مقداردهی اولیه نقشه تنظیم شود. بنابراین، مطمئن می‌شویم که mapId فقط درطول مقداردهی اولیه تنظیم شود و این مشخصه را در کانال‌های عمومی منتشر نمی‌کنیم.
مشخصه HTML:
  • <gmp-map-3d map-id="string"></gmp-map-3d>
maxAltitude
نوع:  number optional
حداکثر ارتفاع از سطح زمین که روی نقشه نمایش داده خواهد شد. مقدار معتبر بین 0 و 63170000 متر است (شعاع زمین ضرب در ۱۰).
مشخصه HTML:
  • <gmp-map-3d max-altitude="number"></gmp-map-3d>
maxHeading
نوع:  number optional
حداکثر زاویه جهت (چرخش) نقشه. مقدار معتبر بین 0 و 360 درجه است. ‫minHeading و maxHeading نشان‌دهنده بازه <= 360 درجه است که در آن اشاره‌های سرصفحه مجاز خواهد بود. ‫minHeading = 180 و maxHeading = 90 به heading in [0, 90] و heading in [180, 360] اجازه خواهند داد. ‫minHeading = 90 و maxHeading = 180 به [90, 180] اجازه می‌دهند.
مشخصه HTML:
  • <gmp-map-3d max-heading="number"></gmp-map-3d>
maxTilt
نوع:  number optional
حداکثر زاویه تابش نقشه. مقدار معتبر بین 0 و 90 درجه است.
مشخصه HTML:
  • <gmp-map-3d max-tilt="number"></gmp-map-3d>
minAltitude
نوع:  number optional
حداقل ارتفاع از سطح زمین که روی نقشه نمایش داده خواهد شد. مقدار معتبر بین 0 و 63170000 متر است (شعاع زمین ضرب در ۱۰).
مشخصه HTML:
  • <gmp-map-3d min-altitude="number"></gmp-map-3d>
minHeading
نوع:  number optional
حداقل زاویه جهت (چرخش) نقشه. مقدار معتبر بین 0 و 360 درجه است. ‫minHeading و maxHeading نشان‌دهنده بازه <= 360 درجه است که در آن اشاره‌های سرصفحه مجاز خواهد بود. ‫minHeading = 180 و maxHeading = 90 به heading in [0, 90] و heading in [180, 360] اجازه خواهند داد. ‫minHeading = 90 و maxHeading = 180 به [90, 180] اجازه می‌دهند.
مشخصه HTML:
  • <gmp-map-3d min-heading="number"></gmp-map-3d>
minTilt
نوع:  number optional
حداقل زاویه برخورد نقشه. مقدار معتبر بین 0 و 90 درجه است.
مشخصه HTML:
  • <gmp-map-3d min-tilt="number"></gmp-map-3d>
mode
نوع:  MapMode optional
حالتی را که نقشه باید در آن ارائه شود مشخص می‌کند. اگر تنظیم نشود، نقشه ارائه نخواهد شد.
مشخصه HTML:
  • <gmp-map-3d mode="hybrid"></gmp-map-3d>
  • <gmp-map-3d mode="satellite"></gmp-map-3d>
range
نوع:  number optional
فاصله دوربین تا مرکز نقشه، به متر.
مشخصه HTML:
  • <gmp-map-3d range="number"></gmp-map-3d>
region
نوع:  string optional
منطقه‌ای که برای تلاش برای ارائه نقاط موردعلاقه نقشه پایه استفاده می‌شود. به‌طور پیش‌فرض به منطقه‌ای که توسعه‌دهنده هنگام بار کردن Maps JS API درخواست کرده است تنظیم می‌شود.
roll
نوع:  number optional
چرخش دوربین حول بردار دید برحسب درجه. برای رفع ابهام، وقتی شیبی وجود نداشته باشد، هرگونه چرخش به‌عنوان جهت تفسیر می‌شود.
مشخصه HTML:
  • <gmp-map-3d roll="number"></gmp-map-3d>
tilt
نوع:  number optional
شیب بردار نمای دوربین برحسب درجه. بردار نمایشی که مستقیماً به زمین نگاه می‌کند، شیب صفر درجه دارد. بردار نمایشی که از زمین دور می‌شود، شیب 180 درجه دارد.
مشخصه HTML:
  • <gmp-map-3d tilt="number"></gmp-map-3d>
defaultUIDisabled
نوع:  boolean optional
پیش‌فرض: false
وقتی true، همه دکمه‌های واسط کاربر پیش‌فرض غیرفعال هستند. صفحه‌کلید و کنترل‌های اشاره‌ای را غیرفعال نمی‌کند.
مشخصه HTML:
  • <gmp-map-3d default-ui-disabled></gmp-map-3d>
addEventListener
addEventListener(type, listener[, options])
پارامترها: 
  • ‫type:  string رشته‌ای حساس به حروف بزرگ و کوچک که نوع رویداد را برای گوش دادن نشان می‌دهد.
  • listener:  EventListener|EventListenerObject شیئی که اعلان را دریافت می‌کند. این باید تابع یا شیئی با روش handleEvent باشد
  • options:  boolean|AddEventListenerOptions optional گزینه‌ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می‌کنند.
مقدار برگشتی:  void
تابعی را راه‌اندازی می‌کند که هرگاه رویداد مشخص‌شده به هدف ارسال شود، فراخوانی خواهد شد. addEventListener را ببینید.
flyCameraAround
flyCameraAround(options)
پارامترها: 
مقدار برگشتی:  هیچ
این روش دوربین را برای مدت‌زمان مشخصی در اطراف مکان مشخصی می‌چرخاند. پویانمایی می‌تواند به تعداد دفعات FlyAroundAnimationOptions.repeatCount تکرار شود.

دوربین در جهت ساعت‌گرد حرکت خواهد کرد.

این روش ناهمگام است زیرا پویانمایی‌ها فقط پس‌از اینکه نقشه حداقل مقدار را بار کرد می‌توانند شروع شوند. این روش پس‌از شروع پویانمایی برمی‌گردد.

اگر تعداد دفعات FlyAroundAnimationOptions.repeatCount صفر باشد، چرخشی رخ نخواهد داد و پویانمایی بلافاصله پس‌از شروع تکمیل خواهد شد.
flyCameraTo
flyCameraTo(options)
پارامترها: 
مقدار برگشتی:  هیچ
این روش دوربین را به‌صورت سهمی از مکان فعلی به مکان پایانی مشخص‌شده در مدت‌زمان مشخص‌شده حرکت می‌دهد.

این روش ناهمگام است زیرا پویانمایی‌ها فقط پس‌از اینکه نقشه حداقل مقدار را بار کرد می‌توانند شروع شوند. این روش پس‌از شروع پویانمایی برمی‌گردد.
removeEventListener
removeEventListener(type, listener[, options])
پارامترها: 
  • ‫type:  string رشته‌ای که نوع رویدادی را که باید شنونده رویداد برای آن برداشته شود مشخص می‌کند.
  • listener:  EventListener|EventListenerObject شنونده رویدادِ گرداننده رویداد برای برداشتن از هدف رویداد.
  • options:  boolean|EventListenerOptions optional گزینه‌ها را ببینید.
مقدار برگشتی:  void
شنونده رویدادی را که قبلاً با addEventListener ثبت شده است از هدف برمی‌دارد. removeEventListener را ببینید.
stopCameraAnimation
stopCameraAnimation()
پارامترها:  هیچ
مقدار برگشتی:  هیچ
این روش هرگونه پویانمایی پرواز را که ممکن است درحال اجرا باشد متوقف می‌کند. دوربین در هر جایی که در میان پویانمایی باشد می‌ماند؛ به نقطه پایانی تلپورت نمی‌شود.

این روش غیرهم‌زمان است زیرا پویانمایی‌ها فقط پس‌از اینکه نقشه حداقل مقدار را بارگیری کرد می‌توانند شروع یا متوقف شوند. این روش پس‌از توقف پویانمایی برمی‌گردد.
gmp-animationend
function(animationEndEvent)
متغیرهای مستقل: 
  • ‫animationEndEvent:  Event
این رویداد زمانی فعال می‌شود که پویانمایی پرواز پایان یابد. این رویداد در درخت مدل شیءگرای سند : درخت DOM حباب ایجاد می‌کند.
gmp-centerchange
function(centerChangeEvent)
متغیرهای مستقل: 
  • ‫centerChangeEvent:  Event
این رویداد زمانی فعال می‌شود که ویژگی مرکز Map3DElement تغییر کند.
gmp-click
function(clickEvent)
متغیرهای مستقل: 
این رویداد زمانی فعال می‌شود که روی عنصر Map3DElement کلیک شود.
gmp-error
function(mapInitializationErrorEvent)
متغیرهای مستقل: 
  • ‫mapInitializationErrorEvent:  Event
این رویداد زمانی فعال می‌شود که نقشه مقداردهی اولیه نشود.
gmp-headingchange
function(headingChangeEvent)
متغیرهای مستقل: 
  • ‫headingChangeEvent:  Event
این رویداد زمانی فعال می‌شود که ویژگی heading مربوط به Map3DElement تغییر کند.
gmp-map-id-error
function(mapIdErrorEvent)
متغیرهای مستقل: 
  • ‫mapIdErrorEvent:  Event
این رویداد زمانی فعال می‌شود که ویژگی mapId مربوط به Map3DElement نامعتبر باشد.
gmp-rangechange
function(rangeChangeEvent)
متغیرهای مستقل: 
  • ‫rangeChangeEvent:  Event
این رویداد زمانی فعال می‌شود که ویژگی محدوده Map3DElement تغییر کند.
gmp-rollchange
function(rollChangeEvent)
متغیرهای مستقل: 
  • ‫rollChangeEvent:  Event
این رویداد زمانی فعال می‌شود که ویژگی roll مربوط به Map3DElement تغییر کند.
gmp-steadychange
function(steadyChangeEvent)
متغیرهای مستقل: 
این رویداد زمانی فعال می‌شود که وضعیت ثابت Map3DElement تغییر کند.
gmp-tiltchange
function(tiltChangeEvent)
متغیرهای مستقل: 
  • ‫tiltChangeEvent:  Event
این رویداد زمانی فعال می‌شود که ویژگی tilt در Map3DElement تغییر کند.

میانای Map3DElementOptions

میانا google.maps.maps3d.Map3DElementOptions

شیء Map3DElementOptions برای تعریف ویژگی‌هایی که می‌توانند در Map3DElement تنظیم شوند استفاده می‌شود.

bounds optional
Map3DElement.bounds را ببینید.
center optional
Map3DElement.center را ببینید.
defaultUIDisabled optional
نوع:  boolean optional
defaultUIHidden optional
نوع:  boolean optional
Map3DElement.defaultUIHidden را ببینید.
description optional
نوع:  string optional
Map3DElement.description را ببینید.
gestureHandling optional
نوع:  GestureHandling optional
Map3DElement.gestureHandling را ببینید.
heading optional
نوع:  number optional
Map3DElement.heading را ببینید.
internalUsageAttributionIds optional
نوع:  Iterable<string> optional
language optional
نوع:  string optional
Map3DElement.language را ببینید.
mapId optional
نوع:  string optional
Map3DElement.mapId را ببینید.
maxAltitude optional
نوع:  number optional
Map3DElement.maxAltitude را ببینید.
maxHeading optional
نوع:  number optional
Map3DElement.maxHeading را ببینید.
maxTilt optional
نوع:  number optional
Map3DElement.maxTilt را ببینید.
minAltitude optional
نوع:  number optional
Map3DElement.minAltitude را ببینید.
minHeading optional
نوع:  number optional
Map3DElement.minHeading را ببینید.
minTilt optional
نوع:  number optional
Map3DElement.minTilt را ببینید.
mode optional
نوع:  MapMode optional
Map3DElement.mode را ببینید.
range optional
نوع:  number optional
Map3DElement.range را ببینید.
region optional
نوع:  string optional
Map3DElement.region را ببینید.
roll optional
نوع:  number optional
Map3DElement.roll را ببینید.
tilt optional
نوع:  number optional
Map3DElement.tilt را ببینید.

ثابت‌های MapMode

google.maps.maps3d.MapMode یادآور همیشگی

حالتی را که نقشه باید در آن ارائه شود مشخص می‌کند.

با تماس با const {MapMode} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

HYBRID این حالت نقشه لایه‌ای شفاف از خیابان‌های اصلی را روی تصاویر ماهواره‌ای یا واقع‌گرایانه نمایش می‌دهد.
SATELLITE این حالت نقشه تصاویر ماهواره‌ای یا واقع‌گرایانه را درصورت دردسترس بودن نمایش می‌دهد.

ثابت‌های GestureHandling

google.maps.maps3d.GestureHandling یادآور همیشگی

مشخص می‌کند که رویدادهای اشاره چگونه باید در عنصر نقشه مدیریت شوند.

با تماس با const {GestureHandling} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

AUTO این کار به نقشه اجازه می‌دهد انتخاب کند که از مدیریت اشاره مشارکتی یا حریصانه استفاده کند. اگر مشخص نشده باشد، این رفتار پیش‌فرض است.

اگر نقشه بر والد پیمایش خود (معمولاً صفحه میزبان) مسلط باشد، به‌طوری‌که کاربر نتواند از نقشه به محتوای دیگر پیمایش کند، این باعث می‌شود نقشه وارد حالت مشارکتی شود.
COOPERATIVE این کار حالت تعاملی را اجباری می‌کند که در آن برای پیمایش نقشه به کلیدهای اصلاح‌گر یا اشاره‌های دو انگشتی نیاز است.
GREEDY این کار حالت حریصانه را اجباری می‌کند که در آن صفحه میزبان نمی‌تواند از رویدادهای کاربر در عنصر نقشه پیمایش شود.

میانای FlyAroundAnimationOptions

میانا google.maps.maps3d.FlyAroundAnimationOptions

گزینه‌های سفارشی‌سازی برای پویانمایی FlyCameraAround.

camera
نوع:  CameraOptions
نقطه مرکزی که دوربین باید درطول پویانمایی مداری به آن نگاه کند. توجه داشته باشید که با چرخش دوربین در اطراف این نقطه مرکزی، عنوان نقشه تغییر خواهد کرد.
durationMillis optional
نوع:  number optional
مدت یک چرخه پویانمایی برحسب میلی‌ثانیه.
repeatCount optional
نوع:  number optional
تعداد دفعاتی را که پویانمایی باید تکرار شود مشخص می‌کند. اگر عدد صفر باشد، پویانمایی بلافاصله پس‌از شروع تکمیل می‌شود.
rounds optional
نوع:  number optional
تعداد دورهایی که باید در مدت‌زمان مشخص‌شده دور مرکز بچرخد. این گزینه سرعت کلی چرخش را کنترل می‌کند. ارسال عدد منفی به rounds باعث می‌شود دوربین به‌جای جهت ساعت‌گرد پیش‌فرض، در جهت پادساعت‌گرد بچرخد.

میانای FlyToAnimationOptions

میانا google.maps.maps3d.FlyToAnimationOptions

گزینه‌های سفارشی‌سازی برای FlyCameraTo Animation.

endCamera
نوع:  CameraOptions
مکانی که دوربین باید در پایان پویانمایی به آن اشاره کند.
durationMillis optional
نوع:  number optional
مدت پویانمایی برحسب میلی‌ثانیه. مدت‌زمان ۰ دوربین را مستقیماً به موقعیت پایانی تلپورت می‌کند.

میانای CameraOptions

میانا google.maps.maps3d.CameraOptions

شیء CameraOptions برای تعریف ویژگی‌هایی که می‌توانند روی شیء دوربین تنظیم شوند استفاده می‌شود. شیء دوربین می‌تواند هر چیزی باشد که موقعیت دوربین دارد، مثلاً وضعیت نقشه فعلی یا وضعیت پویانمایی درخواست‌شده در آینده.

center optional
Map3DElement.center را ببینید.
heading optional
نوع:  number optional
Map3DElement.heading را ببینید.
range optional
نوع:  number optional
Map3DElement.range را ببینید.
roll optional
نوع:  number optional
Map3DElement.roll را ببینید.
tilt optional
نوع:  number optional
Map3DElement.tilt را ببینید.

کلاس SteadyChangeEvent

‫google.maps.maps3d.SteadyChangeEvent کلاس

این رویداد از نظارت بر وضعیت ثابت Map3DElement ایجاد شده است. این رویداد در درخت مدل شیءگرای سند : درخت DOM حباب ایجاد می‌کند.

این کلاس Event را گسترش می‌دهد.

با تماس با const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

isSteady
نوع:  boolean
نشان می‌دهد که Map3DElement ثابت است (یعنی همه پردازش‌ها برای صحنه فعلی تکمیل شده است) یا نه.

کلاس LocationClickEvent

‫google.maps.maps3d.LocationClickEvent کلاس

این رویداد با کلیک کردن روی Map3DElement ایجاد شده است.

این کلاس Event را گسترش می‌دهد.

با تماس با const {LocationClickEvent} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

position
نوع:  LatLngAltitude optional
طول جغرافیایی/عرض جغرافیایی/ارتفاعی که هنگام وقوع رویداد زیر مکان‌نما بود. لطفاً توجه داشته باشید که در سطوح کلی‌تر، داده‌های با دقت کمتر برگردانده خواهد شد. همچنین، هنگام کلیک کردن روی سطح آب از موقعیت‌های بالاتر دوربین، ممکن است ارتفاع بستر دریا برای مقدار ارتفاع برگردانده شود. این رویداد در درخت مدل شیءگرای سند : درخت DOM حباب ایجاد می‌کند.

کلاس PlaceClickEvent

‫google.maps.maps3d.PlaceClickEvent کلاس

این رویداد با کلیک کردن روی نماد مکان در Map3DElement ایجاد شده است. برای جلوگیری از نمایش بالاپر پیش‌فرض، روش preventDefault() را در این رویداد فراخوانی کنید تا از مدیریت آن توسط Map3DElement جلوگیری شود.

این کلاس LocationClickEvent را گسترش می‌دهد.

با تماس با const {PlaceClickEvent} = await google.maps.importLibrary("maps3d") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.

placeId
نوع:  string
شناسه مکان ویژگی نقشه.
از سازمان بالاتر: position
fetchPlace
fetchPlace()
پارامترها:  هیچ
مقدار برگشتی:  Promise<Place>
Place را برای این شناسه مکان واکشی می‌کند. در شیء Place حاصل، ویژگی id پر خواهد شد. فیلدهای اضافی را می‌توان متعاقباً ازطریق Place.fetchFields() درخواست کرد، مشروط به فعال‌سازی و صورت‌حساب عادی Places API. اگر خطایی در واکشی Place وجود داشته باشد، وعده رد می‌شود.