Package google.maps.isochrones.v1

الفهرس

IsochroneService

خدمة لاحتساب منحنيات تساوي الزمن. خط تساوي الزمن هو منطقة يمكن الوصول إليها من نقطة مصدر معيّنة خلال مدة سفر محدّدة.

GenerateIsochrone

rpc GenerateIsochrone(GenerateIsochroneRequest) returns (GenerateIsochroneResponse)

تحسب هذه الطريقة وتُرجع منحنى تساوي الوقت الواحد لمجموعة معيّنة من المَعلمات.

GenerateIsochroneRequest

طلب لإنشاء منحنى زمني متساوي واحد

الحقول
travel_duration

Duration

الحقل مطلوب. تمثّل هذه السمة مدة السفر المستخدَمة في حساب منحنى تساوي الوقت. يجب أن تكون القيمة موجبة وألا تتجاوز 7200 ثانية (120 دقيقة). في وضع DRIVE، تبلغ المدة القصوى المسموح بها 3600 ثانية (60 دقيقة).
travel_mode

TravelMode

الحقل مطلوب. تمثّل هذه السمة وسيلة النقل.
travel_direction

TravelDirection

الحقل مطلوب. تمثّل هذه السمة اتجاه التنقّل.
routing_preference

RoutingPreference

اختياريّ. تحدّد هذه السمة الإعدادات المفضّلة لطريقة التوجيه. القيمة التلقائية هي TRAFFIC_UNAWARE.
enable_smoothing

bool

اختياريّ. تحدِّد هذه السمة ما إذا كان سيتم تنعيم حواف مضلّعات منحنيات تساوي الزمن الناتجة.
polygon_fidelity

PolygonFidelity

اختياريّ. تتحكّم هذه السمة في دقة المضلّع الذي تم إنشاؤه. القيمة التلقائية هي POLYGON_FIDELITY_UNSPECIFIED.
حقل الربط origin الحقل مطلوب. نقطة البداية لاحتساب المنحنى المتساوي الزمن. يمكن أن يكون التعليق origin إحدى القيم التالية فقط:
location

LatLng

نقطة الانطلاق كإحداثيات خط العرض وخط الطول
place

string

اسم المرجع الخاص بمكان، بالتنسيق places/{place_id}

PolygonFidelity

تتحكّم هذه السمة في مستوى التفاصيل في مضلّع خطوط التساوي الزمني.

عمليات التعداد
POLYGON_FIDELITY_UNSPECIFIED لم يتم تحديد دقة المضلّع. سيستخدم الخادم القيمة التلقائية التي تستند إلى مدة الرحلة.
LOW دقة منخفضة، وهي مناسبة لتغطية مساحات كبيرة بعدد أقل من الرؤوس.
MEDIUM دقة متوسطة يجب تحقيق التوازن بين التفاصيل وحجم العناصر غير المرغوب فيها.
HIGH دقة عالية حواف عالية الدقة، ولكن قد ينتج عنها ثقوب في المضلّع حيث تكون كثافة شبكة الطرق منخفضة.

RoutingPreference

تحدّد هذه السمة كيفية دمج حالات حركة المرور في عملية الاحتساب.

عمليات التعداد
ROUTING_PREFERENCE_UNSPECIFIED لم يتم تحديد إعدادات توجيه مفضّلة، وسيستخدم الخادم الإعدادات التلقائية وهي TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE لن تأخذ عملية الحساب في الاعتبار أحوال حركة المرور. ستستند منطقة تساوي الوقت إلى شبكة الطرق وأوقات السفر الثابتة. هذا النوع مناسب لأغراض التخطيط حيث لا تشكّل حركة المرور عاملاً مهمًا.
TRAFFIC_AWARE سيأخذ الحساب في الاعتبار أحوال حركة المرور المباشرة.

TravelDirection

تحدّد هذه السمة اتجاه التنقّل لاحتساب منحنى تساوي الزمن.

عمليات التعداد
TRAVEL_DIRECTION_UNSPECIFIED لم يتم تحديد اتجاه التنقّل.
FROM تحسب هذه الطريقة المساحة التي يمكن الوصول إليها من نقطة البداية. مثال: "إلى أي مكان يمكنني التوصيل من مستودعي خلال 30 دقيقة؟"
TO تحسب هذه الطريقة المساحة التي يمكنك الانتقال منها إلى نقطة البداية. مثال: "ما هي المناطق التي يمكن أن ينتقل منها الموظفون للوصول إلى المكتب في غضون 30 دقيقة؟"

TravelMode

تحدّد هذه السمة وسيلة النقل المستخدَمة لاحتساب المنحنى المتساوي الزمن.

عمليات التعداد
TRAVEL_MODE_UNSPECIFIED لم يتم تحديد وضع السفر.
DRIVE السفر بسيارة ركاب
BICYCLE السفر بالدراجة
WALK التنقّل سيرًا على الأقدام

GenerateIsochroneResponse

استجابة تحتوي على بيانات منحنى التساوي الزمني الذي تم إنشاؤه

الحقول
isochrone

Isochrone

النتائج فقط. المنطقة المتساوية الزمن التي تم إنشاؤها

Isochrone

نتيجة احتساب خطوط تساوي الزمن، وتمثّل منطقة يمكن الوصول إليها من نقطة انطلاق خلال مدة تنقّل محدّدة

الحقول
حقل الربط geometry التمثيل الهندسي لمنطقة تساوي الوقت. يمكن أن يكون التعليق geometry إحدى القيم التالية فقط:
geo_json

Struct

تمثّل هذه السمة شكل خطوط تساوي الزمن بتنسيق GeoJSON، باستخدام تنسيق RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.