راقب استخدام مفتاحك قبل أن تبلغ الحد
متابعة ترويسات الحصة أولًا بأول تخبرك متى يقترب الحد، قبل وقت طويل من رفض أي طلب فعليًا.
الترميز الجغرافي لعناوين تتضمن أرقام شقق أو وحدات
رقم الشقة المضاف إلى عنوان الشارع جزء عادي من كثير من العناوين الحقيقية، ومن المفيد فهم كيفية تعامل استعلام الترميز الجغرافي معه بدلًا من حذفه قبل إرسال الطلب، وهي عادة شائعة لكنها غير ضرورية.
إرسال العنوان الكامل
ضمّن رقم الشقة أو الوحدة كجزء من الاستعلام النصي الحر، مثل أي جزء آخر من العنوان.
GET /v1/forward?q=Apt 4B, 350 Fifth Avenue, New York&limit=1{
"status": "ok",
"query": "Apt 4B, 350 Fifth Avenue, New York",
"results": [
{
"formatted": "350 Fifth Avenue, New York, NY",
"lat": 40.7484,
"lon": -73.9857,
"type": "address",
"precision": "house",
"confidence": 0.95,
"place_id": "es234",
"components": {"house_number": "350", "street": "Fifth Avenue", "city": "New York", "region": "NY", "country": "US"}
}
]
}لماذا لا يظهر رقم الوحدة في الإحداثيات
الإحداثيات الناتجة عن استعلام الترميز الجغرافي تحدد مبنى، لا وحدة معينة داخله، لأن الشقق المنفردة ليس لها موقع مستقل على الخريطة كما هو الحال للمبنى. ولا يُتوقع أن يغيّر جزء الشقة أو الوحدة من العنوان قيمتي lat وlon، كما أن غيابه عن كائن components متوقع أيضًا، وليس علامة على أن المُدخل تم تجاهله أو أسيئت معالجته.
مثال ثانٍ: رقم مكتب في مبنى تجاري
ينطبق النمط نفسه على عنوان تجاري يتضمن رقم مكتب أو طابق.
GET /v1/forward?q=Suite 200, 1 Example Plaza, Chicago&limit=1مبنى مكاتب كبير يضم عشرات الشركات المنفصلة يظل يُرمَّز جغرافيًا إلى مجموعة واحدة من إحداثيات المبنى بغض النظر عن المكتب المذكور في الاستعلام، تمامًا كما هو الحال في مبنى سكني. وأي شيء يميّز مستأجرًا عن آخر داخل ذلك المبنى يجب أن يكون في سجلاتك الخاصة، لا في الإحداثيات.
خطأ شائع يجب تجنبه
لا تحاول الالتفاف على غياب مكوّن الوحدة بإلحاقه بنفسك بالرمز البريدي أو بحقل مكوّن آخر بعد ذلك، كأن تكتب الرمز البريدي بصيغة «20500 Apt 4B». فهذا يُفسد حقلًا تتوقع الأنظمة الأخرى، ومنها أنظمة التحقق لديك وأي استعلامات عن العناوين لاحقة، أن يحتوي على رمز بريدي حقيقي فقط. احتفظ برقم الوحدة في حقله الخاص منفصلًا تمامًا عن كل مكوّن مرمّز جغرافيًا.
تخزين رقم الوحدة بشكل منفصل
بدلًا من دمج رقم الوحدة في سلسلة العنوان التي ترمّزها جغرافيًا في كل مرة، خزّنه كحقل مستقل في نموذج بياناتك إلى جانب عنوان المبنى المرمّز جغرافيًا. فهذا يُبقي طلب الترميز الجغرافي مركّزًا على ما يؤثر فعلًا في النتيجة، أي موقع المبنى، مع الحفاظ على معلومات الوحدة لملصقات التوصيل أو السجلات الداخلية.
حين يكون ذلك مهمًا للتوصيل
تحتاج شركة الشحن أو خدمة البريد إلى رقم الوحدة للتوصيل الفعلي، رغم أنه لم يؤدِّ أي دور في الإحداثيات. احتفظ بالجزأين معًا، إحداثيات المبنى المرمّزة جغرافيًا ورقم الوحدة المخزّن بشكل منفصل، في سجل التوصيل النهائي حتى لا يضيع شيء في العملية.
حالة حدّية تستحق المعرفة
قد يضم عنوان مبنى واحد عددًا كبيرًا من السكان أو المستأجرين المنفصلين، يتشاركون كلهم الإحداثيات نفسها ونتيجة الاستعلام نفسها عن الرمز البريدي. وإذا كنت تطابق الرمز البريدي للعميل مع عنوان مرمّز جغرافيًا بالترميز الأمامي، كما يشرح دليل مطابقة الرمز البريدي، فتذكّر أن علاقة التعدد إلى واحد هذه بين الوحدات والمبنى متوقعة وليست في حد ذاتها علامة على مشكلة في البيانات.
التكلفة لا تتأثر
سواء تضمّن العنوان رقم شقة أو وحدة أم لا، يظل الاستعلام يكلّف طلبًا واحدًا، مثل أي طلب ترميز جغرافي أمامي آخر.
تضمين رقم الوحدة في الاستعلام لا يضر، وحذفه ليس ضروريًا للحصول على ترميز جغرافي دقيق، وإن كان فصله إلى حقل مخزّن مستقل بعد ذلك يُبقي بياناتك أنظف. راجع توثيق الترميز الجغرافي الأمامي للاطلاع على القائمة الكاملة للمكوّنات.