# تبدیل نقطه به آدرس
با این سرویس، مختصات یک نقطه را می‌فرستید و آدرس خوانای آن را دریافت می‌کنید؛ مثلاً پس از انتخاب محل تحویل روی نقشه، آدرس را برای تأیید به کاربر نشان می‌دهید.
برای ارسال درخواست از سرور، یک [کلید خصوصی](/dashboard/docs/authentication) با دسترسی این سرویس بسازید.
## موارد استفاده
- نمایش آدرس فارسی کاربر بعد از انتخاب نقطه روی نقشه.
- استخراج شهر، محله، خیابان یا تقاطع نزدیک به یک مختصات.
- کمک به تکمیل فرم آدرس با نقطه‌ای که کاربر انتخاب کرده است.
برای نمایش یک نشانی، [دریافت آدرس کامل](#point-to-address) را ببینید. برای یافتن مکان از یک نوع مشخص، مانند محله، از [یافتن نزدیک‌ترین مکان](#nearby-feature) استفاده کنید.
## دریافت آدرس کامل
`GET https://reverse-geocoding.services.balad.ir/v1/`
با دریافت مختصات در قالب `longitude,latitude`، آدرس قالب‌بندی‌شده و اجزای ساخت‌یافته آدرس را برمی‌گرداند.
### نمونه درخواست
#### cURL
```bash
curl --get "https://reverse-geocoding.services.balad.ir/v1/" \
--data-urlencode "location=51.3890,35.6892" \
-H "Authorization: Bearer "
```
#### Python
```python
# Install: pip install httpx
import httpx
url = "https://reverse-geocoding.services.balad.ir/v1/"
params = {
"location": "51.3890,35.6892",
}
response = httpx.get(
url,
params=params,
headers={"Authorization": "Bearer "},
timeout=10.0,
)
response.raise_for_status()
print(response.text)
```
#### Go
```go
package main
import (
"fmt"
"io"
"net/http"
"net/url"
"os"
)
func main() {
endpoint, err := url.Parse("https://reverse-geocoding.services.balad.ir/v1/")
if err != nil {
panic(err)
}
query := endpoint.Query()
query.Set("location", "51.3890,35.6892")
endpoint.RawQuery = query.Encode()
request, err := http.NewRequest("GET", endpoint.String(), nil)
if err != nil {
panic(err)
}
request.Header.Set("Authorization", "Bearer ")
response, err := http.DefaultClient.Do(request)
if err != nil {
panic(err)
}
defer response.Body.Close()
if response.StatusCode < 200 || response.StatusCode >= 300 {
panic(fmt.Sprintf("HTTP %d", response.StatusCode))
}
if _, err := io.Copy(os.Stdout, response.Body); err != nil {
panic(err)
}
}
```
#### PowerShell
```powershell
$url = "https://reverse-geocoding.services.balad.ir/v1/"
$params = @{
location = "51.3890,35.6892"
}
$query = ($params.GetEnumerator() | ForEach-Object {
[uri]::EscapeDataString([string]$_.Key) + "=" + [uri]::EscapeDataString([string]$_.Value)
}) -join "&"
$url += "?" + $query
$headers = @{ Authorization = "Bearer " }
Invoke-RestMethod -Uri $url -Headers $headers
```
#### PHP
```php
get("https://reverse-geocoding.services.balad.ir/v1/", [
"headers" => ["Authorization" => "Bearer "],
"query" => [
"location" => "51.3890,35.6892",
],
"timeout" => 10,
]);
echo $response->getBody();
```
#### Node.js
```javascript
// Node.js 18+
async function main() {
const url = new URL("https://reverse-geocoding.services.balad.ir/v1/");
const params = {
location: "51.3890,35.6892",
};
url.search = new URLSearchParams(params).toString();
const response = await fetch(url, {
headers: { Authorization: "Bearer " },
});
if (!response.ok) throw new Error("HTTP " + response.status);
console.log(await response.text());
}
main().catch((error) => {
console.error(error);
process.exitCode = 1;
});
```
### نمونه پاسخ
```json
{
"formatted_address": "تهران، خیابان انقلاب اسلامی، حوالی میدان فردوسی",
"components": [
{ "name": "تهران", "type": "city" },
{ "name": "انقلاب اسلامی", "type": "road" }
]
}
```
### پارامترها
| نام | نوع | اجباری | پیش‌فرض | توضیح |
| --- | --- | --- | --- | --- |
| `location` | `string` | بله | ندارد | مختصات نقطه در قالب `longitude,latitude`؛ مانند `51.3890,35.6892`. |
### فیلدهای پاسخ
| نام | نوع | توضیح |
| --- | --- | --- |
| `formatted_address` | `string` | آدرس خوانا و قالب‌بندی‌شده برای نمایش به کاربر. |
| `components` | `array