📖 Usage Guide

🚀 Quick Start

How to Use: Just two steps to use our proxy service

Step 1: Replace domain maps.googleapis.com with gmapapi.jsonutil.online
Step 2: Use our assigned API Key (or use debug Key: DEBUG_KEY_FOR_TESTING)
💡 Email contact@aeio.dev to apply for an official API Key

# Example from Google official documentation

https://maps.googleapis.com/maps/api/geocode/json?address=Beijing&key=YOUR_API_KEY

# Access through our proxy

https://gmapapi.jsonutil.online/maps/api/geocode/json?address=Beijing&key=YOUR_ASSIGNED_KEY

# Or use debug Key for testing

https://gmapapi.jsonutil.online/maps/api/geocode/json?address=Beijing&key=DEBUG_KEY_FOR_TESTING

💡 Note: Simply use the domain you are currently visiting, no need to change the port

🔑 API Key Usage

🔧 Apply for Official Key
Send email to contact@aeio.dev to apply for an official API Key

🧪 Use Debug Key
Use DEBUG_KEY_FOR_TESTING for feature verification and testing. Debug key is only for development and testing with rate limits. Please apply for an official key for production use

💡 Recommended: For stable service experience and higher request limits, we recommend applying for an official API Key.

📚 API Documentation

View Google official documentation, fully compatible

📍 Geocoding 🧭 Directions 🏢 Places 📏 Distance

💡 All parameters and usage methods are fully compatible with Google official API

🔧 API Debug Tool

Select an API type, then enter parameters to test:

🚀 Quick Examples

Click the buttons below to quickly test common APIs:

📝 Code Examples

Python Example

import requests

# Address to coordinates
response = requests.get(
    "https://YOUR_DOMAIN/maps/api/geocode/json",
    params={"address": "Tiananmen Square, Beijing", "key": "DEBUG_KEY_FOR_TESTING"}
)
print(response.json())

# Route planning
response = requests.get(
    "https://YOUR_DOMAIN/maps/api/directions/json",
    params={"origin": "Beijing", "destination": "Shanghai", "key": "DEBUG_KEY_FOR_TESTING"}
)
print(response.json())

JavaScript (Node.js) Example

// Address to coordinates
const response = await fetch(
    'https://YOUR_DOMAIN/maps/api/geocode/json?address=Tiananmen Square, Beijing&key=DEBUG_KEY_FOR_TESTING'
);
const data = await response.json();
console.log(data);

// Place search
const placesResponse = await fetch(
    'https://YOUR_DOMAIN/maps/api/place/nearbysearch/json?location=39.908722,116.397498&radius=1000&type=restaurant&key=DEBUG_KEY_FOR_TESTING'
);
const placesData = await placesResponse.json();
console.log(placesData);

Java Example

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

// Address to coordinates
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://YOUR_DOMAIN/maps/api/geocode/json?address=Tiananmen Square, Beijing&key=DEBUG_KEY_FOR_TESTING"))
    .build();

HttpResponse response = client.send(request,
    HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Go Example

package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    // Address to coordinates
    resp, err := http.Get("https://YOUR_DOMAIN/maps/api/geocode/json?address=Tiananmen Square, Beijing&key=DEBUG_KEY_FOR_TESTING")
    if err != nil {
        fmt.Println(err)
        return
    }
    defer resp.Body.Close()

    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        fmt.Println(err)
        return
    }

    fmt.Println(string(body))
}

curl Example

# Address to coordinates
curl "https://YOUR_DOMAIN/maps/api/geocode/json?address=Tiananmen Square, Beijing&key=DEBUG_KEY_FOR_TESTING"

# Route planning
curl "https://YOUR_DOMAIN/maps/api/directions/json?origin=Beijing&destination=Shanghai&key=DEBUG_KEY_FOR_TESTING"

# Place search
curl "https://YOUR_DOMAIN/maps/api/place/nearbysearch/json?location=39.908722,116.397498&radius=1000&type=restaurant&key=DEBUG_KEY_FOR_TESTING"

# Static map
curl "https://YOUR_DOMAIN/maps/api/staticmap?center=Beijing&zoom=12&size=600x400&key=DEBUG_KEY_FOR_TESTING"

PHP Example

<?php
// Address to coordinates
$url = "https://YOUR_DOMAIN/maps/api/geocode/json";
$params = [
    'address' => 'Tiananmen Square, Beijing',
    'key' => 'DEBUG_KEY_FOR_TESTING'
];

$response = file_get_contents($url . '?' . http_build_query($params));
$data = json_decode($response, true);

print_r($data);
?>

💡 Tip: Please replace YOUR_DOMAIN with the actual access domain

Google Maps API Proxy