تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المطوّرون في المنطقة الاقتصادية الأوروبية
تعرض لك هذه الصفحة الطلبات والردود لاسترداد عنوان لرقم تعريف مكان.
المعلمات المطلوبة
استبدِل place_id برقم تعريف المكان الذي تريد الحصول على عنوانه المقروء. معرّف المكان هو معرّف فريد يمكن استخدامه مع واجهات برمجة تطبيقات أخرى من Google. على سبيل المثال، يمكنك استخدام placeID الذي تعرضه واجهة Roads API للحصول على عنوان نقطة تم التقاطها. لمزيد من المعلومات عن معرّفات الأماكن، راجِع نظرة عامة على معرّف المكان.
استبدِل key بمفتاح واجهة برمجة التطبيقات لتطبيقك. يحدّد هذا المفتاح تطبيقك لأغراض إدارة الحصة. تعرَّف على كيفية
الحصول على مفتاح.
تاريخ التعديل الأخير: 2025-09-04 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-09-04 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis page explains how to retrieve a human-readable address for a given place ID using the Google Maps Geocoding API.\u003c/p\u003e\n"],["\u003cp\u003eYou need to provide a \u003ccode\u003eplace_id\u003c/code\u003e and your API \u003ccode\u003ekey\u003c/code\u003e as required parameters in the request.\u003c/p\u003e\n"],["\u003cp\u003eOptional parameters for refining the request are available and shared with reverse geocoding.\u003c/p\u003e\n"],["\u003cp\u003eA successful response includes detailed address components, formatted address, location coordinates, and more.\u003c/p\u003e\n"],["\u003cp\u003eRefer to the provided links for details on place IDs, API keys, optional parameters, and response fields.\u003c/p\u003e\n"]]],["To retrieve a place's address, you need the `place_id` and your API `key`. These parameters are used in a query, which is sent as a request. The response returns the address components, including the street number, name, neighborhood, city, state, country, and postal code. It also provides a formatted address and the place's geographic coordinates. The `place_id` uniquely identifies the location and can be obtained from other Google APIs.\n"],null,["# Place geocoding request and response\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nThis page shows you requests and responses to retrieve an address for a place ID.\n\nRequired parameters\n-------------------\n\n- `place_id` --- The place ID of the place for which you wish to obtain the human-readable address. The place ID is a unique identifier that can be used with other Google APIs. For example, you can use the `placeID` returned by the [Roads API](/maps/documentation/roads/snap) to get the address for a snapped point. For more information about place IDs, see the [place ID overview](/maps/documentation/places/web-service/place-id)..\n- `key` --- Your application's API key. This key identifies your application for purposes of quota management. Learn how to [get a key](/maps/documentation/geocoding/get-api-key).\n\nThe optional parameters are the same as those for\n[reverse geocoding](/maps/documentation/geocoding/requests-reverse-geocoding).\n\nThe following query contains the place ID of a place in Brooklyn: \n\n https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJd8BlQ2BZwokRAFUEcm_qrcA\n &key=YOUR_API_KEY\n\nThe above query returns the following result: \n\n {\n \"results\" : [\n {\n \"address_components\" : [\n {\n \"long_name\" : \"277\",\n \"short_name\" : \"277\",\n \"types\" : [ \"street_number\" ]\n },\n {\n \"long_name\" : \"Bedford Avenue\",\n \"short_name\" : \"Bedford Ave\",\n \"types\" : [ \"route\" ]\n },\n {\n \"long_name\" : \"Williamsburg\",\n \"short_name\" : \"Williamsburg\",\n \"types\" : [ \"neighborhood\", \"political\" ]\n },\n {\n \"long_name\" : \"Brooklyn\",\n \"short_name\" : \"Brooklyn\",\n \"types\" : [ \"political\", \"sublocality\", \"sublocality_level_1\" ]\n },\n {\n \"long_name\" : \"Kings County\",\n \"short_name\" : \"Kings County\",\n \"types\" : [ \"administrative_area_level_2\", \"political\" ]\n },\n {\n \"long_name\" : \"New York\",\n \"short_name\" : \"NY\",\n \"types\" : [ \"administrative_area_level_1\", \"political\" ]\n },\n {\n \"long_name\" : \"United States\",\n \"short_name\" : \"US\",\n \"types\" : [ \"country\", \"political\" ]\n },\n {\n \"long_name\" : \"11211\",\n \"short_name\" : \"11211\",\n \"types\" : [ \"postal_code\" ]\n }\n ],\n \"formatted_address\" : \"277 Bedford Ave, Brooklyn, NY 11211, USA\",\n \"geometry\" : {\n \"location\" : {\n \"lat\" : 40.7142205,\n \"lng\" : -73.9612903\n },\n \"location_type\" : \"ROOFTOP\",\n \"viewport\" : {\n \"northeast\" : {\n \"lat\" : 40.71556948029149,\n \"lng\" : -73.95994131970849\n },\n \"southwest\" : {\n \"lat\" : 40.7128715197085,\n \"lng\" : -73.9626392802915\n }\n }\n },\n \"place_id\" : \"ChIJd8BlQ2BZwokRAFUEcm_qrcA\",\n \"types\" : [ \"street_address\" ]\n }\n ],\n \"status\" : \"OK\"\n }\n\nFor a description of the fields in the response, see\n[Geocoding responses](/maps/documentation/geocoding/requests-geocoding#responses)."]]